FB Pixel

Facebook Ads Ad Insights - Data API Endpoint

Ad Insights by ad object id, access token, breakdowns, date preset, fields and level.


Get bulk Ad Insights data from the Facebook Ads API | Official API: https://developers.facebook.com/docs/marketing-apis | 👥  Contributors: steve 🚩  Report

✏️ Inputs

Ad Object ID ad_object_id Required

ID of the Facebook Ad object:

  • Account: act_<AD_ACCOUNT_ID>
  • Campaign: <CAMPAIGN_ID>
  • Ad Set: <ADSET_ID>
  • Ad: <AD_ID>

See more under “Making Calls” here.

Access Token access_token Required

Your access token for the Marketing API: https://developers.facebook.com/apps/

Breakdowns breakdowns Optional

How to break down action results. Supports more than one breakdowns.

See more here: https://developers.facebook.com/docs/marketing-api/insights/parameters/v7.0#parameters-and-fields

Date Preset date_preset Optional

Date to fetch data back from: today, yesterday, this_month, last_month, this_quarter, lifetime, last_3d, last_7d, last_14d, last_28d, last_30d, last_90d, last_week_mon_sun, last_week_sun_sat, last_quarter, last_year, this_week_mon_today, this_week_sun_today, this_year

E.g. lifetime
Fields fields Default account_id,ad_id,adset_id,campaign_id,date_start,date_stop,impressions,spend,ad_name,adset_name,campaign_name

Fields to get back, separated by commas. See the full list of available fields. Popular fields:

  • account_id
  • ad_id
  • adset_id
  • campaign_id
  • date_start
  • date_stop
  • impressions
  • spend

  • ad_name

  • adset_name
  • campaign_name

  • canvas_avg_view_percent

  • canvas_avg_view_time
  • clicks
  • conversion_values
  • conversions
  • cost_per_action_type
  • cost_per_conversion
  • cpc
  • cpm
  • ctr
  • estimated_ad_recall_rate
  • estimated_ad_recallers
  • frequency
  • full_view_impressions
  • full_view_reach
  • purchase_roas
  • website_ctr
  • website_purchase_roas
Level level Optional

Level of aggreagtion

📝 Notes

Posted by steve on Sept. 28, 2020, 6:30 a.m. 🚩  Report

⚡️ Endpoint

GET https://graph.facebook.com/v6.0/{{ad_object_id}}/insights?access_token={{ access_token }}&fields={{ fields }}&level={{ level }}&breakdowns={{ breakdowns }}&date_preset={{ date_preset }}

Body

None

Headers