InsightSocial API
TikTok

Adlibrary › Search

GET
/v1/tiktok/adlibrary/search

Returns TikTok Ad Library ads matching a keyword or advertiser name, each with creative, title, advertiser, impressions and date; include=ad adds the brand, landing page and advertiser link.

Use it to find ads by query or advertiser_name; pass an ad id from the results to adlibrary/ad for the full record.

Metered: 100–340 credits. We reserve the ceiling when the call starts and charge what it actually used when it finishes.

Re-running the exact same call within 1h is free.

Paginates by cursor — see Pagination.

Authorization

apiKey
x-api-key<token>

Your key from the dashboard. It starts with isk_.

In: header

Query Parameters

query?string

Keyword or phrase to search the TikTok Ad Library. Provide at least one of: query, advertiser_name.

advertiser_name?string

Advertiser name as it appears in the TikTok Ad Library. Provide at least one of: query, advertiser_name.

cursor?string

Cursor from the previous response to fetch the next page.

include?"ad"

Set to ad (one token only) to fill the registered brand name, the landing page, the advertiser's TikTok profile link and avatar (post.ext.ad.brand_name, post.ext.ad.landing_page, post.ext.ad.profile_web_link, post.author.avatar_url), plus the objectives, countries and source where the library has them, on every ad in this one call.

Value in

  • "ad"
limit?integer

Take the top N ads of the page (1 to 12) after the search has run. It is not a page size: next_cursor still advances past the full page.

Range1 <= value <= 12

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/tiktok/adlibrary/search"
{  "success": true,  "platform": "instagram",  "endpoint": "/v1/instagram/profile/posts",  "data": {    "items": [      "…"    ],    "dropped": 0  },  "pagination": {    "next_cursor": "is2.eyJwIjoyfQ",    "has_more": true,    "page_size": 12  },  "credits_used": 20,  "credits_remaining": 9980,  "request_id": "req_1a2b3c4d5e6f",  "cached": false,  "idempotent_replay": false,  "charge_reason": "miss",  "free_call": false}

Adlibrary › Ad GET

Returns one TikTok Ad Library ad: creative video, title, advertiser account, landing page, brand name, and first-shown date. Use it when you already have an ad id or library URL; use adlibrary/search to find ads by keyword or advertiser name first. **100 credits** per call. Re-running the exact same call within 6h is free.

Ads › Top GET

Returns TikTok's Creative Center leaderboard of top-performing ads for a market and time window, each with click-through rate, board rank, like count, industry, objective, and the ad video. Use it to find ad creative that actually performed. It is one window with no cursor, so set limit for depth and change country, period, or order_by for a different board. **Metered: 200–2000 credits.** We reserve the ceiling when the call starts and charge what it actually used when it finishes. Re-running the exact same call within 6h is free.