API de insights de anuncios

La API de insights de anuncios proporciona datos y estadísticas de rendimiento de los anuncios de Meta. Gracias a la flexibilidad de sus opciones de informes, puedes personalizar las 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 insights de anuncios, necesitarás lo siguiente:

Una aplicación. (Consulta Desarrollo de aplicaciones de Meta para obtener más información).
El permiso ads_read. (Para obtener más información, consulta Permisos y Autorización.)

También debes configurar los anuncios de modo que se realice 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 insights de anuncios

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

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

De forma predeterminada, las solicitudes GET devuelven métricas básicas del objeto publicitario, normalmente 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 las solicitudes

Puedes obtener datos mucho más específicos si utilizas tres componentes principales en la solicitud: parámetros (para especificar elementos como 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 que se han producido en los últimos siete días de la campaña, podrías incluir lo siguiente:

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

Solicitud de ejemplo

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 insights de anuncios puede ser muy eficaz, por lo que te recomendamos que sigas leyendo para descubrir cómo dominar sus funciones:

Parámetros y campos
Métricas
Desgloses
Solicitudes asíncronas
Límites y prácticas recomendadas
Guías específicas para los informes de conversiones, los informes de nivel de producto y el modelo de marketing mix.

También puedes consultar documentación de referencia generada automáticamente para el perímetro de insights de cada objeto publicitario:

Si tienes previsto incluir datos de la API de insights 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.