API de estadísticas de anuncios

La API de estadísticas de anuncios proporciona datos de rendimiento y estadísticas de los anuncios de Meta. Con sus opciones flexibles para informes, puedes personalizar tus solicitudes y obtener prácticamente cualquier métrica disponible en el administrador de anuncios de Meta.

Antes de empezar

Para acceder a la API de estadísticas de anuncios, necesitarás lo siguiente:

Una app. Consulta Desarrollo de apps con Meta para obtener más información.
Permiso "ads_read". (Para obtener más información, consulta Permisos y Autorización).

También debes configurar tus anuncios para realizar un seguimiento de las acciones que te interesan. Para ello, puedes usar herramientas como la API de conversiones o el píxel de Meta.

Llamar a la API de estadísticas de anuncios

La API de estadísticas de anuncios está disponible como un perímetro de todos los objetos de anuncio. (Obtén más información sobre la jerarquía de anuncios de Meta aquí).

Recurso	Proporciona
`/{ad-account-id}/insights`	Estadísticas de una cuenta publicitaria
`/{campaign-id}/insights`	Estadísticas de una campaña publicitaria
`/{ad-set-id}/insights`	Estadísticas de un conjunto de anuncios
`/{ad-id}/insights`	Estadísticas de un anuncio

De forma predeterminada, las solicitudes GET devolverán métricas básicas para el objeto de anuncio, generalmente de los últimos 30 días.

Ejemplo de solicitud

curl -G \ -d "access_token=<ACCESS_TOKEN>" \ "https://graph.facebook.com/v26.0/<CAMPAIGN_ID>/insights"

Ejemplo de respuesta:

{
  "data": [
    {
      "account_id": "<AD_ACCOUNT_ID>",
      "campaign_id": "<CAMPAIGN_ID>",
      "date_start": "2025-03-14",
      "date_stop": "2025-04-12",
      "impressions": "361324",
      "spend": "5339.5"
    }
  ],
  "paging": {
    "cursors": {
    "before": "MAZDZD",
    "after": "MAZDZD"
    }
  }
}

Personalizar tus solicitudes

Puedes obtener datos mucho más específicos si usas los tres componentes principales en tu solicitud: parámetros (para especificar intervalos de tiempo, intervalos de atribución, etc.), campos (es decir, métricas) y desgloses. Por ejemplo, para conocer el número de clics (todos), por género, realizados en los últimos 7 días de tu campaña, puedes incluir:

Parámetros: date_preset=last_7d
Campos: clicks
Desgloses: gender

Ejemplo de solicitud

curl -G \ -d "date_preset=last_7d" \ -d "fields=clicks" \ -d "breakdowns=gender" \ -d "access_token=<ACCESS_TOKEN>" \ "https://graph.facebook.com/v26.0/<CAMPAIGN_ID>/insights"

Ejemplo de respuesta

{
  "data": [
    {
      "clicks": "7346",
      "date_start": "2025-04-06",
      "date_stop": "2025-04-12",
      "gender": "female"
    },
    {
      "clicks": "3788",
      "date_start": "2025-04-06",
      "date_stop": "2025-04-12",
      "gender": "male"
    },
    {
      "clicks": "79",
      "date_start": "2025-04-06",
      "date_stop": "2025-04-12",
      "gender": "unknown"
    },
  ],
  "paging": {
    "cursors": {
    "before": "MAZDZD",
    "after": "MAZDZD"
    }
  }
}

Más información

La API de estadísticas de anuncios puede ser muy eficaz, por lo que te recomendamos que sigas leyendo y aprendas a dominar sus funciones:

Parámetros y campos
Métricas
Desgloses
Solicitudes asincrónicas
Límites y prácticas recomendadas
Guías específicas para informes de conversiones, informes en el nivel del producto y modelo de marketing mix

Además, puedes encontrar documentación de referencia generada automáticamente para el perímetro de estadísticas de cada objeto de anuncio:

Si tienes planeado incluir datos de la API de estadísticas de anuncios en tu solución, revisa también las Condiciones de la plataforma de Meta y las Políticas para desarrolladores de la API de marketing.