API de reseñas de Google para desarrolladores

Autenticación

Genera una clave de API desde Ajustes → API en tu panel. Cada clave se muestra una única vez al crearla — guárdala en un lugar seguro. Envíala en la cabecera Authorization de cada petición:

curl -H "Authorization: Bearer rvd_live_..." \
  "https://reviews-api.rovidev.com/api/v1/locations"

GET /api/v1/locations

Devuelve las ubicaciones activas de tu organización.

{
  "id": "b3f1...",
  "name": "Cafetería El Sol - Centro"
}

GET /api/v1/reviews

Devuelve las reseñas de tu organización, paginadas. Admite los filtros status (pending, negative, published), location_id, platform (google, facebook, tripadvisor), page y page_size.

curl -H "Authorization: Bearer rvd_live_..." \
  "https://reviews-api.rovidev.com/api/v1/reviews?status=negative&page=1&page_size=50"

{
  "items": [
    {
      "id": "9c2a...",
      "location_id": "b3f1...",
      "location_name": "Cafetería El Sol - Centro",
      "platform": "google",
      "star_rating": 5,
      "comment": "Trato excelente",
      "reviewer_name": "Ana",
      "sentiment": "positive",
      "review_created_at": "2026-08-20T10:15:00",
      "reply_status": "published",
      "reply_content": "¡Muchas gracias, Ana!"
    }
  ],
  "total": 1,
  "page": 1,
  "page_size": 50
}

También en JavaScript / Node

const res = await fetch(
  "https://reviews-api.rovidev.com/api/v1/reviews?status=negative&page=1&page_size=50",
  { headers: { Authorization: "Bearer rvd_live_..." } }
)
const { items, total } = await res.json()

POST /api/v1/review-requests

Dispara una solicitud de reseña en el momento exacto de un pedido, reserva o cita completada, en vez de depender de subir un listado de contactos a mano. Admite los canales email, sms y whatsapp.

curl -X POST -H "Authorization: Bearer rvd_live_..." \
  -H "Content-Type: application/json" \
  -d '{"channel":"email","name":"Ana","email":"ana@example.com"}' \
  "https://reviews-api.rovidev.com/api/v1/review-requests"

{
  "id": "7e4b...",
  "status": "sent",
  "channel": "email",
  "recipient": "ana@example.com"
}

También en JavaScript / Node

await fetch("https://reviews-api.rovidev.com/api/v1/review-requests", {
  method: "POST",
  headers: {
    Authorization: "Bearer rvd_live_...",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({ channel: "email", name: "Ana", email: "ana@example.com" })
})

Webhooks

Configura una URL desde Ajustes → API para recibir un POST cada vez que ocurra un evento, en vez de tener que consultar la API periódicamente. Máximo 5 webhooks activos por organización.

Eventos disponibles

• review.created
• review.replied
• daily.summary

Verificar la firma

Cada envío incluye la cabecera X-RoviDev-Signature: un HMAC-SHA256 del cuerpo de la petición, calculado con el secreto que se te muestra al crear el webhook. Verifícalo en tu servidor antes de procesar el evento:

import hashlib
import hmac

expected = hmac.new(secret.encode(), request.body, hashlib.sha256).hexdigest()
hmac.compare_digest(expected, request.headers["X-RoviDev-Signature"])

También en JavaScript / Node

const crypto = require("crypto")

const expected = crypto
  .createHmac("sha256", secret)
  .update(rawBody)
  .digest("hex")
crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(req.headers["x-rovidev-signature"]))