Referencia de API
Ejecuta escaneos GEO de forma programática en cualquier URL e integra los resultados en tus propias herramientas, paneles o flujos de trabajo. Disponible en los planes Growth y Agency.
Autenticación
Todas las solicitudes a la API deben incluir tu clave API en el encabezado Authorization usando autenticación Bearer token. Tu clave es única para tu cuenta y debe mantenerse secreta.
Encabezado de autorización
Authorization: Bearer YOUR_API_KEY
Para generar o rotar tu clave API, ve a Panel > Configuración > Acceso API. Los usuarios del plan Agency pueden crear múltiples claves.
Endpoints
Ejecuta un análisis GEO completo en una URL públicamente accesible. Devuelve la puntuación general, puntuaciones por categoría y datos brutos del escaneo.
Cuerpo de la solicitud
| Parámetro | Tipo | Descripción |
|---|---|---|
| urlrequerido | string | La URL completa a escanear, incluyendo el protocolo (https://). Debe ser públicamente accesible. No se permiten IPs privadas ni localhost. |
Ejemplo de solicitud
curl -X POST https://geoautopilot.com/api/v1/scan \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url": "https://example.com"}'Ejemplo de respuesta (200)
{
"url": "https://example.com",
"score": 72,
"scores": {
"robotsTxt": 15,
"schemaOrg": 22,
"content": 25,
"overall": 72
},
"data": {
"robotsTxt": {
"exists": true,
"allowsGptBot": true,
"allowsClaudeBot": false,
"allowsPerplexityBot": true
},
"schemaOrg": {
"exists": true,
"types": ["Organization", "WebSite"],
"quality": 0.7
},
"llmsTxt": { "exists": false, "valid": false },
"agentsMd": { "exists": false, "valid": false },
"content": {
"title": "Example Domain",
"wordCount": 312,
"factualDensity": 0.4
}
},
"scannedAt": "2026-04-01T12:00:00.000Z"
}Límites de Uso
Las solicitudes a la API tienen límites por clave API. Superar el límite devuelve una respuesta 429 con un encabezado Retry-After que indica cuándo reintentar.
| Plan | Solicitudes | Ventana |
|---|---|---|
| Growth | 100 | por hora |
| Agency | Ilimitadas | por hora |
El estado del límite de uso se devuelve en cada respuesta mediante los encabezados X-RateLimit-Remaining y Retry-After.
Respuestas de Error
La API usa códigos de estado HTTP estándar. Todas las respuestas de error incluyen un campo error con un mensaje legible.
| Estado | Significado |
|---|---|
| 400 | Solicitud incorrecta. La URL falta, está malformada o apunta a una IP privada. |
| 401 | No autorizado. La clave API falta o es inválida. |
| 403 | Prohibido. Tu plan no incluye acceso a la API. |
| 429 | Límite de solicitudes superado. Revisa el encabezado Retry-After. |
| 500 | Error interno del servidor. Reintenta después de un breve tiempo. |
Formato de respuesta de error
{
"error": "Invalid URL. Must be a publicly accessible HTTPS URL."
}¿Necesitas acceso a la API?
Actualiza a Growth ($79/mes) para 100 solicitudes/hora, o Agency ($199/mes) para acceso ilimitado.