API for Businesses
Integrate your reviews
anywhere
Connect VerificaScore with your website, online store, or app. Display your reviews, automate invitations, and access real-time analytics.
What can you do with the API?
In simple terms: the API lets you connect your business with VerificaScore automatically, without needing to log into the dashboard every time.
Display reviews on your site
Show your VerificaScore reviews directly on your website or online store. Your customers will see real reviews without leaving your site.
Real-time TrustScore
Your trust score updates automatically on your website every time you receive a new review. No manual intervention needed.
Automate invitations
Automatically send review invitations after every sale or service. Connect your sales system with VerificaScore.
Analytics and reports
Get review data for your own dashboards or internal reports. Sentiment analysis, trends, and key metrics.
How does it work?
You don't need to be a tech expert. If you have a web developer or agency, they can integrate it in minutes.
Get your API key
From your VerificaScore dashboard, generate an API key. It's like a password that identifies your business.
Connect your site
Your developer uses the key to connect your website with VerificaScore. It's a secure, encrypted connection.
Everything is automatic
Reviews are displayed and updated automatically. Invitations are sent automatically after every sale.
Technical Documentation
API Reference
Información técnica para desarrolladores. Base URL: https://verificascore.com/api/v1
Authentication
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'
}
})/business/meObtener información de tu empresaDevuelve 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"
}/business/me/reviewsObtener reseñasDevuelve las reseñas de tu empresa con paginación. Ideal para mostrarlas en tu sitio web.
Parámetros
| page | Número de página (default: 1) |
| limit | Resultados por página, máx. 100 (default: 20) |
| stars | Filtrar por estrellas: 1, 2, 3, 4 o 5 |
| sort | Ordenar: "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
}/invitationsEnviar invitación a reseñaEnví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"
}/business/me/analyticsObtener analíticasObtén métricas y estadísticas de tus reseñas para un período específico.
Parámetros
| from | Fecha inicio (ISO 8601): 2026-01-01 |
| to | Fecha 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"
}/reviews/:id/replyResponder a una reseñaResponde 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.'
})
})Limits and availability by plan
| Feature | Gratis | Plus | Premium |
|---|---|---|---|
| API access | -- | -- | Completo |
| Requests per hour | -- | -- | 1,000 |
| Automated invitations | -- | -- | Ilimitadas |
| Analytics via API | -- | -- | Completas |
| Webhooks | -- | -- | 5 endpoints |
La API está disponible exclusivamente en el plan Premium ($69.99/mes). Ver todos los planes
Webhooks
Receive real-time notifications
Webhooks automatically send information to your server when something important happens. It's like getting an instant alert every time a customer leaves a review.
Eventos disponibles:
review.created-- Nueva reseña recibidareview.updated-- Reseña modificadainvitation.completed-- Invitación completadatrustscore.changed-- TrustScore actualizadoEjemplo 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
}
}Ready to integrate VerificaScore?
Activate the Premium plan and get full API access. If you need help with integration, our support team is here to guide you.