Explore · TikTok Ads

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

get/api/v1/explore/tiktok/ads

Request

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

Query parameters

advertiser_idstring

Filter to one advertiser (id token).

querystring

Free-text search across creative text.

activestring

true | false — active vs ended.

started_afterstring

First shown on/after (ISO 8601).

format'video' | 'image'
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'tiktok' required
api_idstring required

TikTok-native ad id.

is_activeboolean required
start_datestring nullable required
end_datestring nullable required

Last-shown date; null while active.

reach_upper_boundnumber nullable required
reach_lower_boundnumber nullable required
format'video' | 'image' | 'unknown' required
primary_textstring nullable required

Ad description.

thumbnail_urlstring nullable required

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

Example response

[
  {
    "gid": "gid://adsmom/tiktok/ad/0192f1c3-...",
    "id_token": "tiktok.ad.0192f1c3-...",
    "platform": "tiktok",
    "api_id": "17420...",
    "advertiser": {
      "gid": "gid://adsmom/tiktok/advertiser/0192f1c3-...",
      "id_token": "tiktok.advertiser.0192f1c3-...",
      "name": "Kaufland",
      "username": "@kaufland"
    },
    "is_active": true,
    "start_date": "2026-05-01"
  }
]

Changes

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