Volver al inicio

API para Empresas

Integra tus reseñas
donde quieras

Conecta VerificaScore con tu sitio web, tienda online o aplicación. Muestra tus reseñas, automatiza invitaciones y accede a analíticas en tiempo real.

REST APIJSONHTTPSPlanes Premium

¿Qué puedes hacer con la API?

En términos simples: la API te permite conectar tu negocio con VerificaScore de forma automática, sin necesidad de entrar al panel cada vez.

Mostrar reseñas en tu sitio

Muestra tus reseñas de VerificaScore directamente en tu página web o tienda online. Tus clientes verán las opiniones reales sin salir de tu sitio.

TrustScore en tiempo real

Tu puntuación de confianza se actualiza automáticamente en tu sitio web cada vez que recibes una nueva reseña. Sin intervención manual.

Automatizar invitaciones

Envía invitaciones a dejar reseñas automáticamente después de cada venta o servicio. Conecta tu sistema de ventas con VerificaScore.

Analíticas y reportes

Obtén datos de tus reseñas para tus propios dashboards o reportes internos. Análisis de sentimiento, tendencias y métricas clave.

¿Cómo funciona?

No necesitas ser experto en tecnología. Si tienes un desarrollador web o agencia, ellos pueden integrarlo en minutos.

1

Obtén tu clave API

Desde tu panel de VerificaScore, genera una clave API. Es como una contraseña que identifica tu empresa.

2

Conecta tu sitio

Tu desarrollador usa la clave para conectar tu sitio web con VerificaScore. Es una conexión segura y encriptada.

3

Todo automático

Las reseñas se muestran y actualizan automáticamente. Las invitaciones se envían solas después de cada venta.

Documentación Técnica

Referencia de la API

Información técnica para desarrolladores. Base URL: https://verificascore.com/api/v1

Autenticación

Todas las peticiones deben incluir tu clave API en el header Authorization.

// Header de autenticación
Authorization: Bearer tu_clave_api_aqui

// Ejemplo con fetch (JavaScript)
fetch('https://verificascore.com/api/v1/business/me', {
  headers: {
    'Authorization': 'Bearer vs_live_abc123xyz789',
    'Content-Type': 'application/json'
  }
})
GET/business/meObtener información de tu empresa

Devuelve la información de tu empresa incluyendo el TrustScore actual, total de reseñas y datos del perfil.

Respuesta de ejemplo

{
  "id": "biz_abc123",
  "name": "Mi Restaurante",
  "trustScore": 4.6,
  "totalReviews": 342,
  "category": "Restaurantes",
  "country": "México",
  "verified": true,
  "plan": "PLUS",
  "profileUrl": "https://verificascore.com/empresa/mi-restaurante"
}
GET/business/me/reviewsObtener reseñas

Devuelve las reseñas de tu empresa con paginación. Ideal para mostrarlas en tu sitio web.

Parámetros

pageNúmero de página (default: 1)
limitResultados por página, máx. 100 (default: 20)
starsFiltrar por estrellas: 1, 2, 3, 4 o 5
sortOrdenar: "recent", "highest", "lowest"

Respuesta de ejemplo

{
  "reviews": [
    {
      "id": "rev_xyz789",
      "author": "María G.",
      "rating": 5,
      "title": "Excelente servicio",
      "body": "La atención fue increíble y la comida deliciosa.",
      "date": "2026-03-15T10:30:00Z",
      "verified": true,
      "reply": null
    }
  ],
  "total": 342,
  "page": 1,
  "pages": 18
}
POST/invitationsEnviar invitación a reseña

Envía un correo electrónico a tu cliente invitándolo a dejar una reseña. Perfecto para automatizar después de cada venta.

Ejemplo de petición

// Enviar invitación a un cliente
fetch('https://verificascore.com/api/v1/invitations', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer vs_live_abc123xyz789',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    email: 'cliente@ejemplo.com',
    name: 'Juan Pérez',           // opcional
    reference: 'ORDER-12345',     // opcional, tu referencia interna
    template: 'default'           // opcional, plantilla de email
  })
})

Respuesta

{
  "id": "inv_abc456",
  "status": "sent",
  "email": "cliente@ejemplo.com",
  "sentAt": "2026-03-21T14:00:00Z"
}
GET/business/me/analyticsObtener analíticas

Obtén métricas y estadísticas de tus reseñas para un período específico.

Parámetros

fromFecha inicio (ISO 8601): 2026-01-01
toFecha fin (ISO 8601): 2026-03-21

Respuesta de ejemplo

{
  "period": { "from": "2026-01-01", "to": "2026-03-21" },
  "trustScore": 4.6,
  "totalReviews": 87,
  "averageRating": 4.4,
  "ratingDistribution": {
    "5": 45, "4": 22, "3": 12, "2": 5, "1": 3
  },
  "sentiment": {
    "positive": 72,
    "neutral": 10,
    "negative": 5
  },
  "responseRate": 0.85,
  "averageResponseTime": "4h 23m"
}
PUT/reviews/:id/replyResponder a una reseña

Responde a una reseña directamente desde tu sistema, sin entrar al panel de VerificaScore.

fetch('https://verificascore.com/api/v1/reviews/rev_xyz789/reply', {
  method: 'PUT',
  headers: {
    'Authorization': 'Bearer vs_live_abc123xyz789',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    message: '¡Gracias por tu reseña, María! Nos alegra que hayas disfrutado.'
  })
})

Límites y disponibilidad por plan

CaracterísticaGratisPlusPremium
Acceso a la API----Completo
Peticiones por hora----1,000
Invitaciones automáticas----Ilimitadas
Analíticas por API----Completas
Webhooks----5 endpoints

La API está disponible exclusivamente en el plan Premium ($149/mes). Ver todos los planes

Webhooks

Recibe notificaciones en tiempo real

Los webhooks envían información a tu servidor automáticamente cuando ocurre algo importante. Es como recibir un aviso instantáneo cada vez que un cliente deja una reseña.

Eventos disponibles:

review.created-- Nueva reseña recibida
review.updated-- Reseña modificada
invitation.completed-- Invitación completada
trustscore.changed-- TrustScore actualizado

Ejemplo de payload (webhook)

// Tu servidor recibe esto automáticamente:
{
  "event": "review.created",
  "timestamp": "2026-03-21T14:30:00Z",
  "data": {
    "reviewId": "rev_new123",
    "rating": 5,
    "author": "Carlos M.",
    "title": "Muy recomendado",
    "trustScore": 4.7   // TrustScore actualizado
  }
}

¿Listo para integrar VerificaScore?

Activa el plan Premium y obtén acceso completo a la API. Si necesitas ayuda con la integración, nuestro equipo de soporte está disponible para guiarte.