Meta ads

One metric per day, optionally against the previous range, split by top creators, or as running totals

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

Operation id getMetaAdsTimeseries

Request

curl

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

Parameters

NameInTypeNotes
organization_idqueryinteger
start_datequerystring (date)
end_datequerystring (date)
metricquerystringOne of purchase_valuelast_click_revenuecreator_earningsroasspendcpaaovconversionslink_clicksctrthumbstop
modequerystringOne of dailycumulative
comparequeryboolean
splitquerystringOne of creators
limitqueryinteger
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
date_rangeobject
date_range.end_datestring (date)
date_range.start_datestring (date)
metricstring
modestring
pointsarray of object
points[].[].datestring (date)
points[].[].valuenumber
previous_pointsarray of object
previous_points[].[].datestring (date)
previous_points[].[].valuenumber
seriesarray of object
series[].[].creatorobject
series[].[].creator.avatar_urlstring, nullable
series[].[].creator.colorstring
series[].[].creator.handlestring, nullable
series[].[].creator.idinteger
series[].[].creator.namestring
series[].[].pointsarray of object
series[].[].points[].[].datestring (date)
series[].[].points[].[].valuenumber
series[].[].valuenumber
successboolean

Example

{
  "date_range": {
    "end_date": "2026-11-01",
    "start_date": "2026-11-01"
  },
  "metric": "string",
  "mode": "string",
  "points": [
    {
      "date": "2026-11-01",
      "value": 125.5
    }
  ],
  "previous_points": [
    {
      "date": "2026-11-01",
      "value": 125.5
    }
  ],
  "series": [
    {
      "creator": {
        "avatar_url": "https://example.com/p/1",
        "color": "string",
        "handle": "string",
        "id": 1024,
        "name": "Example name"
      },
      "points": [
        {
          "date": "2026-11-01",
          "value": 125.5
        }
      ],
      "value": 125.5
    }
  ],
  "success": true
}

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

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