Available on:

Asks the provider for one ad now, and gives its payload with the field names of the provider.

The keys are the provider’s. A Meta ad answers id, name, campaign_id, adset_id, status and a creative that holds one key, the creative id. A Meta ad that has a bid of its own also answers bid_amount. A TikTok ad answers ad_id, ad_format, call_to_action, landing_page_url, video_id and image_ids. A Google Ads ad_group_ad answers id, name, status, adGroupId and campaignId.

The payload holds the fields AdCrunch asks the provider for, and no more. Read the creative under /observe/{advertiserId}/creatives for the material a Meta ad runs.

Money

AdCrunch changes one thing in the payload: the money of Meta, bid_amount. Meta writes each amount in a unit that depends on the currency. This read gives each one as a number in whole units of the currency of the advertiser. It is the unit of budget on a row: 250 is 250.00. When AdCrunch does not know the currency of the advertiser, each of these fields is null.

A TikTok amount is in whole units already, so it does not change. A Google Ads field whose name ends in Micros states its unit, so it stays in micros: 12340000 is 12.34.

When there is nothing to give

404 — the provider holds no such ad on this ad account, the provider has no ad at all, or your organization does not own the advertiser in the path. They are deliberately not told apart: distinguishing them would confirm that a ad exists to somebody who cannot read it.

{
  "account_id": "1203456789012345",
  "adset_id": "120210000000001",
  "campaign_id": "120210000000000",
  "created_time": "2026-09-16T23:06:40+0000",
  "creative": {
    "id": "120210000000003"
  },
  "id": "120210000000002",
  "name": "Carousel — bestsellers",
  "status": "ACTIVE",
  "updated_time": "2026-09-20T10:26:40+0000"
}