Minute Call para desarrolladores y agentes de IA

Minute Call API y documentación

Minute Call publica una API REST pública para consultar la cobertura por sector y ciudad, estimar el coste de las llamadas perdidas y registrar solicitudes de llamada. Todas las respuestas son JSON y la superficie completa está descrita en OpenAPI 3.1.

Especificación OpenAPI (JSON)OpenAPI (YAML)

Autenticación

Los endpoints de lectura (/service, /sectors, /cities, /articles, /roi, /health) son públicos y no requieren clave de API ni cabecera Authorization.

POST /api/v1/leads también es público, pero está limitado a 5 solicitudes por hora y por cliente y valida todos los campos. Envía datos personales únicamente con el consentimiento explícito de la persona a la que vamos a llamar.

Endpoints

Base URL: https://www.minute-call.com/api/v1 · Versión de la especificación: 1.0.0

MétodoRutaoperationIdQué hace
GET/api/v1listApiIndexList available operations
GET/api/v1/servicegetServiceGet the service description and when-to-use guidance
GET/api/v1/sectorslistSectorsList the industries covered
GET/api/v1/sectors/{slug}getSectorGet one industry
GET/api/v1/citieslistCitiesList the cities covered
GET/api/v1/cities/{slug}getCityGet one city
GET/api/v1/articleslistArticlesList published articles
POST/api/v1/roicalculateMissedCallCostEstimate the revenue lost to missed calls
POST/api/v1/leadscreateLeadRequest a callback
GET/api/v1/healthgetHealthCheck API availability

Ejemplos

Descubrir la API

curl -s https://www.minute-call.com/api/v1

Comprobar si cubrimos un sector

curl -s "https://www.minute-call.com/api/v1/sectors?q=clinicas&limit=5"

Calcular el coste de las llamadas perdidas

curl -s -X POST https://www.minute-call.com/api/v1/roi \
  -H 'Content-Type: application/json' \
  -d '{
    "callsPerMonth": 200,
    "missedPct": 35,
    "leadPct": 30,
    "averageTicket": 500,
    "conversionPct": 20
  }'

Solicitar una llamada

curl -s -X POST https://www.minute-call.com/api/v1/leads \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "Ana Ruiz",
    "email": "ana@clinicaruiz.es",
    "phone": "+34600111222",
    "context": "Clinica dental en Valencia, 300 llamadas/mes, cobertura 9-21h",
    "source": "mi-agente"
  }'

Leer cualquier página en Markdown

curl -s -H 'Accept: text/markdown' https://www.minute-call.com/lp/recepcionista-ia-clinicas
curl -s https://www.minute-call.com/lp/recepcionista-ia-clinicas.md

Errores

Todos los errores devuelven JSON con el mismo envoltorio: code legible por máquina, message, hint con la acción recomendada, status y documentation_url. Los errores de validación añaden details con el campo concreto.

{
  "error": "One or more fields are missing or out of range.",
  "code": "validation_error",
  "message": "One or more fields are missing or out of range.",
  "hint": "Fix the fields listed in `details` and retry.",
  "details": [
    { "field": "callsPerMonth", "reason": "required" }
  ],
  "status": 422,
  "documentation_url": "https://www.minute-call.com/docs"
}

Recursos para agentes