InsightSocial API
TikTok

Adlibrary › Ad

GET
/v1/tiktok/adlibrary/ad

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.

Authorization

apiKey
x-api-key<token>

Your key from the dashboard. It starts with isk_.

In: header

Query Parameters

ad_id?string

TikTok Ad Library ad id, or a library.tiktok.com ads/detail URL. Provide at least one of: ad_id, url.

url?string

TikTok Ad Library ads/detail URL. Provide at least one of: ad_id, url.

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/ad"
{  "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}

User › Posts GET

Returns a Threads user's most recent posts, usually about 15. Send limit above 15 (up to 50) to collect more of the same feed, with view counts and display names filled in. Use it for a recent-activity window of about 15 posts. Set limit above 15 for deeper history on the same feed, or use search for a keyword lookup. **Metered: 20–3300 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 24h is free.

Adlibrary › Search GET

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](/docs/pagination).