Stored read: List creatives

Available on:

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

Meta only, today

A standalone Creative is Meta’s model. TikTok has none — its creative material (the video or image, the ad text, the call to action) is embedded in the Ad itself, so a TikTok advertiser lists nothing here and AdCrunch does not invent a creative for it. Google Ads has none either: it keeps its creative material on the ad_group_ad link resource.

An empty answer for those providers is normal, and it is not a failure.

No parent

A creative is account-level: it belongs to an advertiser and not to any one campaign or ad group, and one creative can be reused across many ads. So there is no campaign or ad group to filter by, and a row carries no campaignId and no adGroupId.

Freshness

A creative is re-read only when the ad that carries it changes. A body-copy tweak or a thumbnail swap made in the provider’s own interface lags until the next ad-level change reaches AdCrunch.

Not an Asset

A Creative is the provider’s — the assembled payload it returns once an ad exists. An Asset is yours: a source media file your organization owns, held before any ad references it. They are deliberately unlinked; read the Assets API for those.

GET/observe/creatives

Authorization

AuthorizationBearer token · headerrequired

Send Authorization: Bearer <credential>.

Use an API key (acr_…), from the AdCrunch console under Settings → API keys.

The credential names the organization, and no operation takes an organization parameter.

See https://docs.adcrunch.dev/api/authentication.

Query parameters

idsstring

cursorstring

min length 1

limitinteger

min 1 · max 500 · default: 100

advertiserIdstring

matches ^(acc_)[\s\S]{0,}$

providerstring

statusstring

Allowed:ACTIVEPAUSEDDELETEDARCHIVED

Responses

200

The matching creatives, and how many there are in all. Only Meta advertisers answer rows today.

dataobject[]required

The matching rows. From the store, the row AdCrunch stored last comes first; from the provider, the provider’s own order. An empty array means nothing matched, which is a normal answer and not a failure.

Show properties

Array of object

advertiserIdstringrequired

The advertiser that owns it, prefixed acc_.

createdAtnumber | nullrequired

When AdCrunch first stored this row. Null when the row was read live: AdCrunch holds no copy of it. createdAt, updatedAt and deletedAt are AdCrunch’s own times, so all three are null together on a live row.

createdTimenumber | nullrequired

When the provider created the entity. This is the provider’s own time, so a live row carries it. Null where the provider reports none.

currencystring | nullrequired

The account currency, ISO 4217. Every row of one advertiser carries the same one. Null when AdCrunch does not know it yet.

deletedAtnumber | nullrequired

When AdCrunch marked the row deleted. A listing never carries a deleted row, so this is null.

idstringrequired

The id the provider gives, with no prefix. It is unique for one provider and one type, and it may legitimately recur across two types or two providers.

namestringrequired

The name at the provider.

pathstringrequired

The ancestors and this entity, ids joined by /, oldest first. This is what makes a subtree one string comparison.

providerstringrequired

The ad platform: meta, tiktok or gads. Those three are the providers whose entities AdCrunch reads, and https://docs.adcrunch.dev/connect/providers says how deep each one goes.

statusstringrequired

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

Allowed:ACTIVEPAUSEDDELETEDARCHIVED

updatedAtnumber | nullrequired

When AdCrunch last rewrote this row. Null if it never changed.

updatedTimenumber | nullrequired

When the provider last edited the entity. Null where the provider reports none.

typestringrequired

The type the provider uses, kept as the provider writes it: creative. Only Meta has a creative of its own. The resource names the concept, and the row keeps the provider’s own word, because a Meta adset and a Google Ads ad_group are not the same object.

nextCursorstring

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

400

The request does not match the schema of this operation: a field is missing or has the wrong type, or the body is not valid JSON. error is invalid_request, and issues names each field. Nothing was changed. Or AdCrunch cannot use the cursor: it cannot read it, or the cursor belongs to a different query. Then error is invalid_cursor. Send the nextCursor of the previous page with no change, or omit cursor to get the first page.

Any of:

object

issuesobject[]required

One entry for each field that does not match.

Show properties

Array of object

instringrequired

The part of the request that holds the field.

Allowed:bodycookieheadersparamsquery

messagestringrequired

A sentence to show a person. Written to say what to do next. Reworded whenever it can be said better, so never branch on it.

pathstringrequired

A JSON Pointer into that part of the request, such as /filename. An empty string is the whole part.

errorstringrequired

A stable code for the failure. This is the field to branch on. It does not change for a given failure.

Allowed:invalid_request

messagestringrequired

A sentence to show a person. Written to say what to do next. Reworded whenever it can be said better, so never branch on it.

object

errorstringrequired

A stable code for the failure. This is the field to branch on. It does not change for a given failure.

Allowed:invalid_cursor

messagestringrequired

A sentence to show a person. Written to say what to do next. Reworded whenever it can be said better, so never branch on it.

401

No API key, or one that does not resolve. See the security scheme. error is unauthorized.

errorstringrequired

A stable code for the failure. This is the field to branch on. It does not change for a given failure.

Allowed:unauthorized

messagestringrequired

A sentence to show a person. Written to say what to do next. Reworded whenever it can be said better, so never branch on it.

403

The caller does not hold observe:read. error is forbidden.

errorstringrequired

A stable code for the failure. This is the field to branch on. It does not change for a given failure.

Allowed:forbidden

messagestringrequired

A sentence to show a person. Written to say what to do next. Reworded whenever it can be said better, so never branch on it.

Request

curl -X GET 'https://api.pr-775.adcrunch.dev/observe/creatives' \
  -H 'Authorization: Bearer YOUR_TOKEN'

const response = await fetch("https://api.pr-775.adcrunch.dev/observe/creatives", {
  method: "GET",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN"
  }
});

import requests

response = requests.get(
    "https://api.pr-775.adcrunch.dev/observe/creatives",
    headers={
        "Authorization": "Bearer YOUR_TOKEN"
    },
)

Response

{
  "data": [
    {
      "advertiserId": "acc_1203456789012345",
      "createdAt": 1789610000000,
      "createdTime": null,
      "currency": "EUR",
      "deletedAt": null,
      "id": "120210000000003",
      "name": "Bestsellers carousel — FR",
      "path": "120210000000003",
      "provider": "meta",
      "status": "ACTIVE",
      "type": "creative",
      "updatedAt": null,
      "updatedTime": null
    }
  ],
  "nextCursor": "eyJwIjpbMTc4OTYxMDAwMDAwMCwibWV0YSIsImNyZWF0aXZlIiwiMTIwMjEwMDAwMDAwMDAzIl0sInEiOiI5MTZmZHNjbWx6In0"
}

{
  "issues": [
    {
      "in": "body",
      "message": "string",
      "path": "string"
    }
  ],
  "error": "invalid_request",
  "message": "string"
}

{
  "error": "unauthorized",
  "message": "string"
}

{
  "error": "forbidden",
  "message": "string"
}