ScrapeCreators: Tiktok Ad Library Search

Searches TikTok’s public Ads Library using either query for a general search or advertiser_name for advertiser-specific results.

Tool ID: scrapecreators_tiktok_ad_library_search

Run this action

Use the TypeScript SDK for one call. Use ctx.tools.execute(...) inside a Play for durable calls, scheduled calls, or CSV processing.

import { Deepline } from 'deepline';

const deepline = await Deepline.connect();
const result = await deepline.tools.execute(
  'scrapecreators_tiktok_ad_library_search',
  {
    "query": "software companies hiring engineers",
    "advertiser_name": "Example",
    "adv_biz_ids": "adv_biz_123"
  },
);

console.log(result.toolResponse.raw);

CLI

deepline tools execute scrapecreators_tiktok_ad_library_search --input '{
  "query": "software companies hiring engineers",
  "advertiser_name": "Example",
  "adv_biz_ids": "adv_biz_123"
}' --json

Example response

The static output schema lacks the details for a reliable example. Use deepline describe scrapecreators_tiktok_ad_library_search --json for the complete live contract.

Input reference

Searches TikTok’s public Ads Library using either query for a general search or advertiser_name for advertiser-specific results. Advertiser-name searches resolve the name through TikTok’s advertiser typeahead first, then search the selected advertiser entity and return adv_biz_ids on each ad. You can pass adv_biz_ids with advertiser_name to pin the exact advertiser shown in TikTok’s See all ads link. TikTok requires the name with the ID and ignores an ID-only search, so provide exactly one of query or advertiser_name. If TikTok has no matching advertiser entity, the API falls back to TikTok’s name search. Results are global, sorted by the latest shown date, support cursor pagination, and include a public TikTok Ads Library URL for each ad.

Name	Type	Required	Default	Details
`payload.query`	`string`	No	—	General ad search. Provide either query or advertiser_name, not both.
`payload.advertiser_name`	`string`	No	—	Advertiser name to resolve through TikTok’s typeahead and search by advertiser entity. Falls back to TikTok’s name search when no entity matches. Provide either advertiser_name or query, not both.
`payload.adv_biz_ids`	`string`	No	—	TikTok advertiser business ID from a See all ads link. Use it with advertiser_name to pin the exact advertiser. Required companion: advertiser_name. ID-only searches return 400 because TikTok ignores the ID without the name.
`payload.cursor`	`string`	No	—	Opaque cursor returned from the previous response.

Output reference

Standard tool result payload.

Name	Type	Required	Default	Details
`result.data`	`unknown`	Yes	—	Provider response payload.
`result.meta`	`object`	No	—	Additional response metadata (status, paging).

Deepline cost

Pricing model: fixed (per call).
Estimated Deepline credits: 0.02 per pricing unit.

​Run this action

​CLI

​Example response

​Input reference

​Output reference

​Deepline cost

​Related documentation

Run this action

CLI

Example response

Input reference

Output reference

Deepline cost

Related documentation