API REST
La API de visibilidad y rankings en IA para tu sistema de informes
Lleva los datos de visibilidad, prompts, respuestas, citaciones y competidores de Geoptie a BigQuery, Looker Studio, paneles de clientes o tu propio producto. Una clave bearer, JSON sobre HTTPS y sin cuota mensual de solicitudes.
ChatGPT
Claude
Perplexity
Gemini
AI Overviews- AI Mode
Copilot
curl -sS "https://api.geoptie.com/v1/brands" \
-H "Authorization: Bearer $GEOPTIE_API_KEY"{
"data": [
{
"id": "3f2a6c1e-0b7d-4e59-9a41-2c8d5e7f9b10",
"name": "Example Brand",
"domain": "example.com",
"engines": ["chatgpt", "claude", "perplexity", "gemini"],
"country": "US"
}
],
"has_more": false,
"next_cursor": null
}v1
API REST estable
7
motores de IA cubiertos
120/min
solicitudes, sin límite mensual
$99
al mes, plan Profesional
La confianza de equipos de marketing y agencias
¿Qué es una API de visibilidad en IA?
Una API de visibilidad en IA devuelve cómo motores de IA como ChatGPT, Claude, Perplexity, Gemini y las respuestas con IA de Google mencionan y citan una marca, como datos que tus propios sistemas pueden usar. También funciona como API de rank tracker en IA: visibilidad y posición de cada prompt seguido, en cada motor, cada día.
La API REST de Geoptie ofrece las mismas métricas que el panel, así que los números de un data warehouse, un panel de BI, un informe para clientes o una alerta de Slack coinciden con lo que ve tu equipo.
Tu primera solicitud en menos de un minuto
Crea una clave en el panel y envíala como bearer token. GET /v1/brands comprueba que la clave funciona y devuelve los ids de marca que usan todos los demás endpoints.
Listo en tres pasos
- 1
Crea una clave
En el panel, en Claves de API, para todo el espacio de trabajo o para las marcas que elijas.
- 2
Llama a GET /v1/brands
Comprueba que la clave funciona y devuelve los ids de marca que usan todos los demás endpoints.
- 3
Obtén los datos que necesitas
Visibilidad, prompts, respuestas, citaciones y competidores, por marca y por motor.
curl -sS "https://api.geoptie.com/v1/brands" \
-H "Authorization: Bearer $GEOPTIE_API_KEY"import os, requests
r = requests.get(
"https://api.geoptie.com/v1/brands",
headers={"Authorization": f"Bearer {os.environ['GEOPTIE_API_KEY']}"},
timeout=30,
)
r.raise_for_status()
print(r.json())const r = await fetch("https://api.geoptie.com/v1/brands", {
headers: { Authorization: `Bearer ${process.env.GEOPTIE_API_KEY}` },
});
if (!r.ok) throw new Error(`${r.status} ${await r.text()}`);
console.log(await r.json());Catálogo de endpoints
Marcas
- GET
/v1/ brands - POST
/v1/ brands - GET
/v1/ brands/ {id} - GET
/v1/ brands/ {id}/ visibility
Prompts y respuestas
- GET
/v1/ brands/ {id}/ prompts - POST
/v1/ brands/ {id}/ prompts - GET
/v1/ prompts/ {id}/ responses - GET
/v1/ prompts/ {id}/ mentions
Citaciones
- GET
/v1/ brands/ {id}/ citations - GET
/v1/ brands/ {id}/ citations/ urls - GET
/v1/ brands/ {id}/ citations/ domains - GET
/v1/ brands/ {id}/ citations/ trends
Competidores
- GET
/v1/ brands/ {id}/ competitors - GET
/v1/ brands/ {id}/ competitors/ trends - POST
/v1/ brands/ {id}/ tracked-competitors - POST
/v1/ brands/ {id}/ ignored-competitors
Recomendaciones y auditorías
- GET
/v1/ brands/ {id}/ recommendations - POST
/v1/ brands/ {id}/ recommendations/ generate - POST
/v1/ audit-reports - GET
/v1/ audit-reports/ {id}
Contenido
- POST
/v1/ brands/ {id}/ generations - POST
/v1/ brands/ {id}/ generations/ {generationId}/ draft - POST
/v1/ brands/ {id}/ optimizations - GET
/v1/ brands/ {id}/ topics
48 operaciones en total, incluidas actualizaciones y eliminaciones. La referencia completa está en la documentación de la API.
Hecha para informes en producción
La API devuelve los números que muestra tu panel, en un formato que encaja directamente en un data warehouse o en un informe para clientes.
Los mismos números que el panel
Visibilidad, posición y cuota de voz precalculadas, no filas en bruto que haya que recomponer, así que un informe para clientes coincide con lo que ve tu equipo.
Lectura y escritura
Sigue prompts, gestiona temas y competidores, trabaja la cola de recomendaciones, ejecuta auditorías y genera contenido con la misma API.
Claves de espacio de trabajo y por marca
Da a un cliente, a un panel o a un equipo interno una clave que solo llega a su propia marca. La revocación surte efecto en menos de un minuto.
Tareas con ritmo previsible
Paginación por cursor, fechas ISO 8601 y cabeceras de límite de uso en cada respuesta, para que una tarea programada regule su ritmo sin toparse con un 429.
Errores con los que puedes actuar
Códigos de estado HTTP estándar con un código de error estable, y un X-Request-Id en cada respuesta para que soporte pueda rastrearla.
Versionado estable
v1 es estable. Los campos nuevos se añaden sin previo aviso, y los cambios incompatibles llegan como /v2 con 90 días de antelación.
Lo que construyen los equipos con ella
Paneles de clientes
Las agencias llevan la visibilidad en IA de cada cliente a Looker Studio o a su propio portal, con una clave limitada por marca para cada cliente.
Sincronización con el data warehouse
Una tarea nocturna copia los datos de visibilidad, citaciones y competidores a BigQuery o Snowflake, junto a los datos de SEO y analítica.
Alertas
Una comprobación programada publica en Slack o envía un email cuando un prompt prioritario cae en un motor.
Asistentes de IA
La misma clave impulsa el servidor MCP de Geoptie para Claude Code, Cursor y Codex.
Incluido en Profesional y Empresa
Preguntas frecuentes sobre la API de visibilidad en IA
¿Qué datos devuelve la API de Geoptie?
¿Qué planes incluyen acceso a la API?
¿Cómo funciona la autenticación?
¿Cuáles son los límites de uso de la API?
¿Puedo obtener datos de competidores a través de la API?
¿Puedo dar a un cliente acceso a la API solo para su marca?
¿Qué motores de IA cubre la API?
¿También hay un servidor MCP?
Pon la visibilidad en IA junto al resto de tus datos
Empieza con Profesional, crea una clave y tu primera solicitud devolverá tus marcas en menos de un minuto.
Comenzar