Stored read: List asset groups
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.
Request
- Base URL: https://api.adcrunch.dev
- URL: https://api.adcrunch.dev/observe/asset-groups
- Auth: HTTP bearer
Query parameters
Ids to filter on, separated by commas. An id is the bare id its provider gives.
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.
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.
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.
Read one status, normalized across the providers. TikTok ENABLE and DISABLE are read here as ACTIVE and PAUSED.
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.
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.