InsightSocial API
TikTok

TikTok Ad Library Ad API reference

Your first 10 calls are free, no card needed. Pricing and FAQ

Get a free API key
Example request
curl "https://api.insightsocial.app/v1/tiktok/adlibrary/ad?ad_id=1869335220395266" \
  -H "x-api-key: $INSIGHTSOCIAL_API_KEY"

Step-by-step: Ad library aggregation

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.

50 credits per call.

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.

dry_run?"1"

Set to 1 to get the price of this call without making it: data.dry_run carries credits_min and credits_max. Nothing is charged.

Value in

  • "1"

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://api.insightsocial.app/v1/tiktok/adlibrary/ad"
{  "success": true,  "platform": "string",  "endpoint": "string",  "schema_version": "2",  "pagination": {    "next_cursor": "string",    "has_more": true,    "page_size": 0,    "stopped_at": "since"  },  "unavailable": [    "string"  ],  "credits_used": 0,  "credits_remaining": 0,  "request_id": "string",  "cached": true,  "idempotent_replay": true,  "charge_reason": "string",  "free_call": true,  "data": {    "post": {      "id": "string",      "url": "http://example.com",      "kind": "string",      "content": {        "text": "string",        "media_urls": [          "http://example.com"        ],        "thumbnail_url": "http://example.com",        "duration_seconds": 0      },      "author": {        "id": "string",        "username": "string",        "display_name": "string",        "avatar_url": "http://example.com",        "verified": true      },      "engagement": {        "views": 0,        "likes": 0,        "comments": 0,        "shares": 0,        "saves": 0      },      "flags": {        "nsfw": true,        "spoiler": true,        "pinned": true,        "deleted": true,        "likes_hidden": true,        "comments_hidden": true,        "shares_hidden": true,        "views_hidden": true,        "saves_hidden": true      },      "published_at": "2019-08-24T14:15:22Z",      "language": "string",      "ext": {        "property1": null,        "property2": null      }    }  }}

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.

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.