Ricky logorickyDocs

Consultar el reporte de anuncios

GET
/reports/ads

La inversión en anuncios de Meta y las conversaciones que trajo cada anuncio en el período. Los días y las horas son de America/Panama, como en las páginas de Reportes; cada número se compara con el período anterior de la misma duración.

Permiso: reports:read.

Autorización

bearerAuth
headerAuthorizationBearer <clave>

Una clave de API de la organización, rky_live_…, creada en Configuración → API. Envíala solo desde un servidor.

Parámetros de consulta

from?string

Primer día, YYYY-MM-DD, America/Panama, incluido. Envíalo junto con to; sin ninguno de los dos, el reporte cubre los últimos 7 días, hoy incluido.

Patrón^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$
Formatodate
to?string

Último día, YYYY-MM-DD, America/Panama, incluido. Un día posterior a hoy cuenta como hoy. El período tiene como máximo 366 días.

Patrón^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$
Formatodate

Cuerpo de la respuesta

Éxito.

application/json
  1. response
data*

La inversión en anuncios de Meta junto a las conversaciones que trajo cada anuncio. Una conversación viene de un anuncio cuando un mensaje del cliente trae una referencia de anuncio de Meta (click-to-chat de WhatsApp o un anuncio de Instagram); esos son días de America/Panama. La inversión, las impresiones y los clics son las cifras diarias de Meta para los días de la propia cuenta publicitaria, así que los bordes de un período pueden diferir por la diferencia entre las zonas horarias.

curl -X GET 'https://getricky.ai/api/v1/reports/ads'
{  "data": {    "period": {      "from": "2026-10-14",      "to": "2026-10-14",      "days": 1,      "granularity": "day",      "time_zone": "America/Panama",      "previous_from": "2026-10-14",      "previous_to": "2026-10-14"    },    "connection": "connected",    "synced_at": "2026-10-14T15:30:00.000Z",    "currency_code": "string",    "totals": {      "spend": 0,      "impressions": 0,      "clicks": 0,      "conversations": 0,      "cost_per_conversation": 0    },    "previous": {      "spend": 0,      "conversations": 0    },    "series": [      {        "slot": "2026-10-14",        "spend": 0,        "conversations": 0      }    ],    "ads": [      {        "ad_id": "120210000000000001",        "ad_name": "string",        "campaign_name": "string",        "headline": "string",        "spend": 0,        "currency_code": "string",        "impressions": 0,        "clicks": 0,        "conversations": 0,        "cost_per_conversation": 0      }    ],    "generated_at": "2026-10-14T15:30:00.000Z"  }}