Asset groups

Stored read: List asset groups

Available on: Google Ads

Lists the asset groups of every ad account your organization connects, newest first.

Google Ads only, and Performance Max only

An asset group is Performance Max’s delivery container. A Performance Max campaign has no ad groups and no ads: the asset group holds the headlines, images, videos and audience signals that Google’s automation assembles into placements itself.

Every other provider lists nothing here, and that is normal rather than a failure.

A sibling, not a child

An asset group is a child of a campaign and a sibling of an ad group — not a layer beneath one. That is why it takes campaignId and never adGroupId, and why a Performance Max campaign answers nothing under /observe/ad-groups or /observe/ads.

get/observe/asset-groups

Request

  • Base URL: https://api.adcrunch.dev
  • URL: https://api.adcrunch.dev/observe/asset-groups
  • Auth: HTTP bearer

Query parameters

idsstring

Ids to filter on, separated by commas. An id is the bare id its provider gives.

cursorstring

The nextCursor of the previous page. Omit it to get the first page. Send it with no change, and with the same filters as the request that answered it: a cursor from a different query gets a 400 invalid_cursor. Do not build or change a cursor.

limitinteger

The greatest number of rows on the page, from 1 to 500. The default is 100. A greater value gets a 400, with error of invalid_request.

advertiserIdstring

Read one ad account from what AdCrunch holds, prefixed acc_. One your organization does not own answers an empty list rather than a failure. To ask the provider instead, put the advertiser in the path.

'meta'
OR
'tiktok'
OR
'snapchat'
OR
'gads'
OR
'dv360'
OR
'x'
OR
'openai'
status'ACTIVE' | 'PAUSED' | 'DELETED' | 'ARCHIVED'

Read one status, normalized across the providers. TikTok ENABLE and DISABLE are read here as ACTIVE and PAUSED.

campaignIdstring

Read only what this campaign holds. Send the bare id its provider gives, which is the campaignId every row answers.

Response

The matching asset groups, and how many there are in all. Only Google Ads advertisers answer rows.

nextCursorstring

Send this value as cursor to get the next page. It is absent on the last page.

Example response

{
  "data": [
    {
      "advertiserId": "acc_4829301756",
      "budgetLevel": "campaign",
      "campaignId": "20993874561",
      "createdAt": 1789610000000,
      "createdTime": null,
      "currency": "EUR",
      "deletedAt": null,
      "id": "6390218745",
      "name": "Performance Max — winter",
      "path": "20993874561/6390218745",
      "provider": "gads",
      "status": "ACTIVE",
      "type": "asset_group",
      "updatedAt": null,
      "updatedTime": null
    }
  ],
  "nextCursor": "eyJwIjpbMTc4OTYxMDAwMDAwMCwiZ2FkcyIsImFzc2V0X2dyb3VwIiwiNjM5MDIxODc0NSJdLCJxIjoiMmdtajdydHJyam8ifQ"
}

Changes

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