ScrapeCreators: Tiktok Ad Library Ad

Fetches one TikTok ad by ID or URL.

Tool ID: scrapecreators_tiktok_ad_library_ad

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_ad',
  {
    "ad_id": "ad_123"
  },
);

console.log(result.toolResponse.raw);

CLI

deepline tools execute scrapecreators_tiktok_ad_library_ad --input '{
  "ad_id": "ad_123"
}' --json

Example response

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

Input reference

Fetches one TikTok ad by ID or URL. It first checks Creative Center Top Ads (ads.tiktok.com), then TikTok’s public transparency Ads Library (library.tiktok.com) when the ID is not a Top Ads material. Both sources return the same response shape. Fields TikTok does not expose for a public Ads Library ad are null, empty, or false as appropriate.

Name	Type	Required	Default	Details
`payload.ad_id`	`string`	Yes	—	Creative Center Top Ads material ID or URL, or a public Ads Library ad ID or library.tiktok.com detail URL.

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