Meta ads

The Meta ads table grouped by ad, ad set or product, with totals, quick view counts and histograms

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

Operation id getMetaAdsByCreative

Request

curl

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

Parameters

NameInTypeNotes
organization_idqueryinteger
start_datequerystring (date)
end_datequerystring (date)
group_byquerystringOne of adad_setproduct
sortquerystringOne of purchase_valuelast_click_revenuecreator_earningsroasspendcpaaovconversionslink_clicksctrthumbstopnamelaunched_at
metricquerystringOne of purchase_valuelast_click_revenuecreator_earningsroasspendcpaaovconversionslink_clicksctrthumbstop
directionquerystringOne of ascdesc
pagequeryinteger
per_pagequeryinteger
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
ad_countinteger
creator_countinteger
date_rangeobject
date_range.end_datestring (date)
date_range.start_datestring (date)
directionstring
group_bystring
histogramsobject
itemsarray of object
items[].[].ad_namestring
items[].[].ad_set_idstring
items[].[].ad_set_namestring
items[].[].creative_namestring, nullable
items[].[].creator, nullable
items[].[].fatiguingboolean
items[].[].idstring
items[].[].is_newboolean
items[].[].launched_atstring (date-time), nullable
items[].[].meta_ads_countinteger
items[].[].metricsobject
items[].[].metrics.aovnumber
items[].[].metrics.conversionsinteger
items[].[].metrics.cpanumber
items[].[].metrics.ctrnumber
items[].[].metrics.last_click_commissionnumber
items[].[].metrics.last_click_revenuenumber
items[].[].metrics.link_clicksinteger
items[].[].metrics.purchase_valuenumber
items[].[].metrics.roasnumber
items[].[].metrics.spendnumber
items[].[].metrics.thumbstopnumber
items[].[].metrics.tw_metricsobject
items[].[].product_tagstring, nullable
items[].[].sparklinearray of number
items[].[].statusstringOne of activepauseddraft
items[].[].thumbnail_colorstring
items[].[].thumbnail_urlstring, nullable
metricstring
paginationobject
pagination.pageinteger
pagination.per_pageinteger
pagination.totalinteger
pagination.total_pagesinteger
quick_view_countsobject
sortstring
successboolean
totalinteger
totalsobject
totals.aovnumber
totals.conversionsinteger
totals.cpanumber
totals.ctrnumber
totals.last_click_commissionnumber
totals.last_click_revenuenumber
totals.link_clicksinteger
totals.purchase_valuenumber
totals.roasnumber
totals.spendnumber
totals.thumbstopnumber
totals.tw_metricsobject
tw_metric_columnsarray of object
tw_metric_columns[].[].keystring
tw_metric_columns[].[].labelstring
tw_metric_columns[].[].value_typestring

Example

{
  "ad_count": 3,
  "creator_count": 3,
  "date_range": {
    "end_date": "2026-11-01",
    "start_date": "2026-11-01"
  },
  "direction": "string",
  "group_by": "string",
  "histograms": {},
  "items": [
    {
      "ad_name": "Example name",
      "ad_set_id": "string",
      "ad_set_name": "Example name",
      "creative_name": "Example name",
      "creator": {
        "avatar_url": "https://example.com/p/1",
        "color": "string",
        "handle": "string",
        "id": 1024,
        "name": "Example name"
      },
      "fatiguing": true,
      "id": "string",
      "is_new": true,
      "launched_at": "2026-11-01T15:04:05Z",
      "meta_ads_count": 3,
      "metrics": {
        "aov": 125.5,
        "conversions": 3,
        "cpa": 125.5,
        "ctr": 125.5,
        "last_click_commission": 125.5,
        "last_click_revenue": 125.5,
        "link_clicks": 3,
        "purchase_value": 125.5,
        "roas": 125.5,
        "spend": 125.5,
        "thumbstop": 125.5,
        "tw_metrics": {}
      },
      "product_tag": "string",
      "sparkline": [
        125.5
      ],
      "status": "active",
      "thumbnail_color": "string",
      "thumbnail_url": "https://example.com/p/1"
    }
  ],
  "metric": "string",
  "pagination": {
    "page": 1,
    "per_page": 1,
    "total": 3,
    "total_pages": 1
  },
  "quick_view_counts": {},
  "sort": "string",
  "success": true,
  "total": 3,
  "totals": {
    "aov": 125.5,
    "conversions": 3,
    "cpa": 125.5,
    "ctr": 125.5,
    "last_click_commission": 125.5,
    "last_click_revenue": 125.5,
    "link_clicks": 3,
    "purchase_value": 125.5,
    "roas": 125.5,
    "spend": 125.5,
    "thumbstop": 125.5,
    "tw_metrics": {}
  },
  "tw_metric_columns": [
    {
      "key": "string",
      "label": "string",
      "value_type": "string"
    }
  ]
}

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

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