Explore · Google Ads

List (or batch-hydrate) Google ads from your tracked advertisers

get/api/v1/explore/google/ads

Request

Base URL: https://api.adsmom.com
URL: https://api.adsmom.com/api/v1/explore/google/ads
Auth: HTTP bearer

Query parameters

advertiser_idstring

Filter to one advertiser (id token).

querystring

Free-text search across headline and description.

activestring

true | false — active vs ended.

started_afterstring

First shown on/after (ISO 8601).

updated_afterstring

Last shown on/after (ISO 8601).

format'video' | 'image' | 'text'

sort'newest' | 'oldest' | 'reach_desc'

cursorstring

Opaque pagination cursor.

limitnumber

idsstring

Batch-hydrate ad id tokens (comma-separated, max 25). When set, filters/pagination are ignored.

Response

gidstring required

id_tokenstring required

platform'google' required

is_activeboolean required

Shown within the last 30 days.

start_datestring nullable required

end_datestring nullable required

Last-shown date; null while active.

impression_lower_boundnumber nullable required

impression_upper_boundnumber nullable required

format'video' | 'image' | 'text' | 'unknown' required

headlinestring nullable required

primary_textstring nullable required

Creative description (truncated).

thumbnail_urlstring nullable required

Signed, short-lived (~10 min). Fetch promptly or re-request.

Example response

[
  {
    "gid": "gid://adsmom/google/ad/CR1234...",
    "id_token": "google.ad.CR1234...",
    "platform": "google",
    "advertiser": {
      "gid": "gid://adsmom/google/advertiser/AR1234...",
      "id_token": "google.advertiser.AR1234...",
      "name": "Kaufland",
      "origin_country": "DE"
    },
    "is_active": true,
    "start_date": "2026-05-01"
  }
]

Changes

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