Meta ads

Every Meta ads metric for the range with the previous range, the change and a daily sparkline

GET/api/public/v1/meta_ads/overview
ConnectorAnswers empty results in the documented shape until the brand switches on this connection.

Operation id getMetaAdsOverview

Request

curl

curl "https://creator.growthdept.ai/api/public/v1/meta_ads/overview" \
  -H "Authorization: Bearer gdc_..."

Parameters

NameInTypeNotes
organization_idqueryinteger
start_datequerystring (date)
end_datequerystring (date)
qquerystring
adsquerystringOne of allactivewith_gmv
creator_idsquerystring
campaign_idsquerystring
ad_set_idsquerystring
product_tagsquerystring
launchedquerystringOne of 71430
quick_viewquerystringOne of scalingburningfatiguingnew
purchase_value_minquerynumber
purchase_value_maxquerynumber
cpa_minquerynumber
cpa_maxquerynumber
spend_minquerynumber
spend_maxquerynumber
roas_minquerynumber
roas_maxquerynumber
ctr_minquerynumber
ctr_maxquerynumber
thumbstop_minquerynumber
thumbstop_maxquerynumber

Responses

200Success

FieldTypeNotes
availabilityobject
availability.creator_earningsboolean
availability.last_click_revenueboolean
date_rangeobject
date_range.end_datestring (date)
date_range.start_datestring (date)
metricsobject
previous_rangeobject
previous_range.end_datestring (date)
previous_range.start_datestring (date)
successboolean

Example

{
  "availability": {
    "creator_earnings": true,
    "last_click_revenue": true
  },
  "date_range": {
    "end_date": "2026-11-01",
    "start_date": "2026-11-01"
  },
  "metrics": {},
  "previous_range": {
    "end_date": "2026-11-01",
    "start_date": "2026-11-01"
  },
  "success": true
}

Errors: 401404422429with an error and usually a message. See errors.

Example values are made up from each field's type and name.