Ricky logorickyDocs

Listar los conjuntos de anuncios de Meta

GET
/ads/ad-sets

Los conjuntos de anuncios de las cuentas publicitarias de Meta conectadas, con presupuesto y segmentación, leídos 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+$
campaign_id?string

Solo los conjuntos de anuncios de esta campaña.

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/ad-sets'
{  "data": [    {      "id": "string",      "account_id": "string",      "campaign_id": "string",      "name": "string",      "status": "string",      "effective_status": "string",      "optimization_goal": "string",      "billing_event": "string",      "bid_strategy": "string",      "budget": {        "daily": 0,        "lifetime": 0,        "remaining": 0      },      "start_time": "string",      "end_time": "string",      "targeting": null,      "created_time": "string",      "updated_time": "string"    }  ],  "next_cursor": "string"}