Get Facebook account-level insights

Get aggregated performance insights for the entire Facebook Ad account including impressions, clicks, spend, CTR, CPC, and conversions. Use when user asks 'how are my Facebook ads performing', 'show my Facebook ad spend', 'Facebook account performance'.

get/api/v1/facebook/insights/account

Request

  • Base URL: https://localhost:3000
  • URL: https://localhost:3000/api/v1/facebook/insights/account
  • Auth: OAuth 2 (authorization code, authorization URL /oauth/authorize, token URL /oauth/token)

Query parameters

date_presetstring

Predefined date range (e.g. last_7d, last_30d, last_90d, this_month, last_month)

start_datestring date

Start date for custom range (YYYY-MM-DD)

end_datestring date

End date for custom range (YYYY-MM-DD)

Response

Account-level performance insights

object required

Changes

No recorded changes to this operation across all 1 revision of this API.