The Meta ads table grouped by creator with each creator's ads, totals, quick view counts and histograms
GET
/api/public/v1/meta_ads/creatorsConnectorAnswers empty results in the documented shape until the brand switches on this connection.
Operation id getMetaAdsByCreator
Request
curl
curl "https://creator.growthdept.ai/api/public/v1/meta_ads/creators" \
-H "Authorization: Bearer gdc_..."Parameters
| Name | In | Type | Notes |
|---|---|---|---|
| organization_id | query | integer | |
| start_date | query | string (date) | |
| end_date | query | string (date) | |
| sort | query | string | One of purchase_valuelast_click_revenuecreator_earningsroasspendcpaaovconversionslink_clicksctrthumbstopnamelaunched_at |
| metric | query | string | One of purchase_valuelast_click_revenuecreator_earningsroasspendcpaaovconversionslink_clicksctrthumbstop |
| direction | query | string | One of ascdesc |
| page | query | integer | |
| per_page | query | integer | |
| q | query | string | |
| ads | query | string | One of allactivewith_gmv |
| creator_ids | query | string | |
| campaign_ids | query | string | |
| ad_set_ids | query | string | |
| product_tags | query | string | |
| launched | query | string | One of 71430 |
| quick_view | query | string | One of scalingburningfatiguingnew |
| purchase_value_min | query | number | |
| purchase_value_max | query | number | |
| cpa_min | query | number | |
| cpa_max | query | number | |
| spend_min | query | number | |
| spend_max | query | number | |
| roas_min | query | number | |
| roas_max | query | number | |
| ctr_min | query | number | |
| ctr_max | query | number | |
| thumbstop_min | query | number | |
| thumbstop_max | query | number |
Responses
200Success
| Field | Type | Notes |
|---|---|---|
| ad_count | integer | |
| creator_count | integer | |
| date_range | object | |
| date_range.end_date | string (date) | |
| date_range.start_date | string (date) | |
| direction | string | |
| group_by | string | |
| histograms | object | |
| items | array of object | |
| items[].[].ads | array of object | |
| items[].[].ads[].[].ad_name | string | |
| items[].[].ads[].[].ad_set_id | string | |
| items[].[].ads[].[].ad_set_name | string | |
| items[].[].ads[].[].creative_name | string, nullable | |
| items[].[].ads[].[].creator | , nullable | |
| items[].[].ads[].[].fatiguing | boolean | |
| items[].[].ads[].[].id | string | |
| items[].[].ads[].[].is_new | boolean | |
| items[].[].ads[].[].launched_at | string (date-time), nullable | |
| items[].[].ads[].[].meta_ads_count | integer | |
| items[].[].ads[].[].metrics | object | |
| items[].[].ads[].[].metrics.aov | number | |
| items[].[].ads[].[].metrics.conversions | integer | |
| items[].[].ads[].[].metrics.cpa | number | |
| items[].[].ads[].[].metrics.ctr | number | |
| items[].[].ads[].[].metrics.last_click_commission | number | |
| items[].[].ads[].[].metrics.last_click_revenue | number | |
| items[].[].ads[].[].metrics.link_clicks | integer | |
| items[].[].ads[].[].metrics.purchase_value | number | |
| items[].[].ads[].[].metrics.roas | number | |
| items[].[].ads[].[].metrics.spend | number | |
| items[].[].ads[].[].metrics.thumbstop | number | |
| items[].[].ads[].[].metrics.tw_metrics | object | |
| items[].[].ads[].[].product_tag | string, nullable | |
| items[].[].ads[].[].sparkline | array of number | |
| items[].[].ads[].[].status | string | One of activepauseddraft |
| items[].[].ads[].[].thumbnail_color | string | |
| items[].[].ads[].[].thumbnail_url | string, nullable | |
| items[].[].ads_active_count | integer | |
| items[].[].ads_count | integer | |
| items[].[].creator | object | |
| items[].[].creator.avatar_url | string, nullable | |
| items[].[].creator.color | string | |
| items[].[].creator.handle | string, nullable | |
| items[].[].creator.id | integer | |
| items[].[].creator.name | string | |
| items[].[].fatiguing | boolean | |
| items[].[].is_new | boolean | |
| items[].[].launched_at | string, nullable | |
| items[].[].metrics | object | |
| items[].[].metrics.aov | number | |
| items[].[].metrics.conversions | integer | |
| items[].[].metrics.cpa | number | |
| items[].[].metrics.ctr | number | |
| items[].[].metrics.last_click_commission | number | |
| items[].[].metrics.last_click_revenue | number | |
| items[].[].metrics.link_clicks | integer | |
| items[].[].metrics.purchase_value | number | |
| items[].[].metrics.roas | number | |
| items[].[].metrics.spend | number | |
| items[].[].metrics.thumbstop | number | |
| items[].[].metrics.tw_metrics | object | |
| items[].[].sparkline | array of number | |
| metric | string | |
| pagination | object | |
| pagination.page | integer | |
| pagination.per_page | integer | |
| pagination.total | integer | |
| pagination.total_pages | integer | |
| quick_view_counts | object | |
| sort | string | |
| success | boolean | |
| total | integer | |
| totals | object | |
| totals.aov | number | |
| totals.conversions | integer | |
| totals.cpa | number | |
| totals.ctr | number | |
| totals.last_click_commission | number | |
| totals.last_click_revenue | number | |
| totals.link_clicks | integer | |
| totals.purchase_value | number | |
| totals.roas | number | |
| totals.spend | number | |
| totals.thumbstop | number | |
| totals.tw_metrics | object | |
| tw_metric_columns | array of object | |
| tw_metric_columns[].[].key | string | |
| tw_metric_columns[].[].label | string | |
| tw_metric_columns[].[].value_type | string |
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": [
{
"ads": [
{
"ad_name": "Example name",
"ad_set_id": "string",
"ad_set_name": "Example name",
"creative_name": "Example name",
"creator": {},
"fatiguing": true,
"id": "string",
"is_new": true,
"launched_at": "2026-11-01T15:04:05Z",
"meta_ads_count": 3,
"metrics": {
"aov": null,
"conversions": null,
"cpa": null,
"ctr": null,
"last_click_commission": null,
"last_click_revenue": null,
"link_clicks": null,
"purchase_value": null,
"roas": null,
"spend": null,
"thumbstop": null,
"tw_metrics": null
},
"product_tag": "string",
"sparkline": [
null
],
"status": "active",
"thumbnail_color": "string",
"thumbnail_url": "https://example.com/p/1"
}
],
"ads_active_count": 3,
"ads_count": 3,
"creator": {
"avatar_url": "https://example.com/p/1",
"color": "string",
"handle": "string",
"id": 1024,
"name": "Example name"
},
"fatiguing": true,
"is_new": true,
"launched_at": "2026-11-01T15:04:05Z",
"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": {}
},
"sparkline": [
125.5
]
}
],
"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.