Insights

Updated: May 21, 2026

Copy for LLM

Ads in WhatsApp Status are available via the Marketing API. Learn more about ads in WhatsApp Status.

You can read insights for ad set and ad objects using Dynamic Creative, Placement Asset Customization, and Segment Asset Customization.

In Ads Manager, you can view your asset level breakdowns. Using the API, you can get the following breakdowns:

body_asset

description_asset

image_asset

title_asset

call_to_action_asset

link_url_asset

video_asset

ad_format_asset

You can combine these in your results with these breakdowns:

age

gender

age, gender

For Dynamic Creative, we currently show only creative-asset level breakdowns such as metrics by image, title, body, video. Insights on full delivered ads are found in Ads Manager under By Dynamic Creative Asset.

Build your query

Get the following fields in your query:

Field	Description
`actions`	Number of actions taken on your ad, grouped by action type.
`clicks`	Total number of clicks on your ad.
`impressions`	Number of times your ad was served.

Facebook supports different values derived from the fields above. For example you can also retrieve ctr and actions_per_impressions.

Examples

To retrieve insights for an ad with the body_asset breakdown:

curl -G
-d "breakdowns=body_asset"
-d "fields=impressions"
-d "access_token=<ACCESS_TOKEN>"
https://graph.facebook.com/<API_VERSION>/<AD_ID>/insights

A sample response looks like this:

{
  "data": [
    {
      "impressions": "8801",
      "date_start": "2016-04-29",
      "date_stop": "2016-05-13",
      "body_asset": {
        "text": "Test text",
        "id": "6051732675652"
      }
    },
    {
      "impressions": "7558",
      "date_start": "2016-04-29",
      "date_stop": "2016-05-13",
      "body_asset": {
        "text": "Test ext new",
        "id": "6051732676452"
      }
    },
  ],
  "paging": {
    "cursors": {
      "before": "MAZDZD",
      "after": "MgZDZD"
    }
  }}

To retrieve insights for an ad set broken down by image_asset and age:

curl -G
-d "breakdowns=image_asset,age"
-d "fields=impressions"
-d "access_token=<ACCESS_TOKEN>"
https://graph.facebook.com/<API_VERSION>/<ADSET_ID>/insights

A sample response looks like this:

{
  "data": [
    {
      "impressions": "5497",
      "date_start": "2016-04-29",
      "date_stop": "2016-05-13",
      "image_asset": {
        "hash": "<REDACTED>",
        "url": "<REDACTED>",
        "id": "6051732672052"
      }
    },
    {
      "impressions": "5962",
      "date_start": "2016-04-29",
      "date_stop": "2016-05-13",
      "image_asset": {
        "hash": "<REDACTED>",
        "url": "<REDACTED>",
        "id": "6051732672652"
      }
    },
  ],
  "paging": {
    "cursors": {
      "before": "MAZDZD",
      "after": "MwZDZD"
    }