Primeros pasos con la API

La API de Gloriads permite que tus propias herramientas —una hoja de cálculo, un script, una automatización— lean tu cuenta.

Es de solo lectura. Una clave lee tu cuenta y no cambia nada. La API está incluida en todos los planes y durante la prueba gratuita.

Para preguntarle a un asistente de IA sobre tu cuenta no necesitas ninguna clave: consulta Conectar un asistente de IA.

1. Crea una clave

Configuración → API → Crear una clave. Ponle el nombre de la herramienta que la usará y copia la clave. Empieza por key_live_ y se muestra una sola vez.

Cuántas claves puedes tener y cómo revocar una: Autenticación y claves de API.

2. Haz tu primera llamada

Cada solicitud va a https://gloriads.com/api/v1 y lleva tu clave en el encabezado Authorization:

curl https://gloriads.com/api/v1/account \
  -H "Authorization: Bearer YOUR_API_KEY"

/account demuestra que la clave funciona, describe la cuenta a la que pertenece e indica hasta qué día llegan tus cifras de Amazon Ads:

{
  "is_demo": false,
  "subscription": { "status": "active" },
  "api_key": {
    "name": "My script",
    "start": "key_live_ab12",
    "scopes": ["read"],
    "created_at": "2026-09-15T07:55:00.000Z",
    "last_used_at": null
  },
  "connected_app": null,
  "amazon_ads": {
    "connection": "connected",
    "marketplaces": 3,
    "performance_data": {
      "currency": "USD",
      "first_date": "2021-03-01",
      "last_date": "2026-10-09",
      "synced_at": "2026-10-10T06:12:00.000Z",
      "is_syncing": false,
      "history_complete": true
    }
  }
}

Si connection es error, reconecta Amazon Ads en Configuración → Amazon Ads: las cifras dejan de actualizarse hasta que lo hagas.

3. Explora todos los endpoints

Tu rendimiento comparado con un periodo anterior, tus productos, tus campañas de TV por streaming, tus campañas con sus palabras clave y sus anuncios, tus reglas y todo lo que Gloriads hizo en Amazon: Qué lee la API lista todos los endpoints con un ejemplo. La referencia de la API muestra cada parámetro y cada respuesta, con un botón Try it.

Límites

60 solicitudes por minuto y 10.000 por día por cuenta. Si se supera cualquiera de los dos, la API responde 429 con un encabezado Retry-After: consulta Errores.