Ricky logorickyDocs

Listar las campañas de Meta

GET
/ads/campaigns

Las campañas de las cuentas publicitarias de Meta conectadas, leídas en vivo de Meta. Responde rule_violation cuando la organización no conectó Meta Ads, y forbidden cuando Meta ya no acepta su conexió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.

account_id?string

Solo esta cuenta publicitaria conectada.

Patrón^\d+$
active_only?string

true devuelve solo lo que Meta está entregando ahora (estado efectivo ACTIVE).

Predeterminado"false"
Uno de"true""false"

Cuerpo de la respuesta

Éxito.

application/json
  1. response
data*array<>
next_cursor*|

Pásalo como cursor para la página siguiente; null en la última página.

curl -X GET 'https://getricky.ai/api/v1/ads/campaigns'
{  "data": [    {      "id": "string",      "account_id": "string",      "name": "string",      "objective": "string",      "status": "string",      "effective_status": "string",      "buying_type": "string",      "bid_strategy": "string",      "budget": {        "daily": 0,        "lifetime": 0,        "remaining": 0      },      "start_time": "string",      "stop_time": "string",      "created_time": "string",      "updated_time": "string"    }  ],  "next_cursor": "string"}