Ricky logorickyDocs

Listar los anuncios de Meta

GET
/ads/ads

Los anuncios de las cuentas publicitarias de Meta conectadas, con el texto de su creativo, 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.

Parámetros de consulta

account_id?string

Solo esta cuenta publicitaria conectada.

Patrón^\d+$
campaign_id?string

Solo los anuncios de esta campaña.

Patrón^\d+$
ad_set_id?string

Solo los anuncios de este conjunto.

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/ads'
{  "data": [    {      "id": "string",      "account_id": "string",      "campaign_id": "string",      "ad_set_id": "string",      "name": "string",      "status": "string",      "effective_status": "string",      "creative": {        "id": "string",        "title": "string",        "body": "string",        "call_to_action_type": "string",        "image_url": "string",        "thumbnail_url": "string",        "instagram_permalink_url": "string",        "object_story_spec": null      },      "created_time": "string",      "updated_time": "string"    }  ],  "next_cursor": "string"}

Listar los conjuntos de anuncios de Meta GET

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`.

Consultar los resultados de los anuncios de Meta GET

El gasto, la entrega y las acciones que cuenta Meta para las cuentas publicitarias conectadas en un período, por cuenta, campaña, conjunto o anuncio, calculados en vivo por 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`.