CaptapiInstall

Summary

Fetches one TikTok Creative Center Top Ads leaderboard page and returns up to 20 ads, with optional filters and keyword matching. The query filters that page’s candidate pool; it does not search the full ad library.

Inputs

• Query — Optional keyword matched case-insensitively as a whole word against title, brandName, industry, or objective. Use Match to require any or all query tokens. A query with no literal hits returns an empty ads list.
• Match — Token matching mode: any (default, OR) or all (AND).
• Country — Two-letter ISO country code; defaults to US.
• Period — Lookback window in days: 7, 30, or 180; defaults to 30.
• OrderBy — Sort order: for_you (default), likes, ctr, impressions, or cost.
• Industry — Optional Creative Center industry key or label.
• Objective — Optional campaign objective, such as Traffic, Conversion, or Reach.
• AdFormat — Optional format filter: spark or non_spark.
• Limit — Maximum ads to return, up to 20. This trims the single leaderboard page and does not scan additional candidates.
• Cache — Set true to use the 24-hour response cache; defaults to false, which fetches fresh data.

Output shape

A response containing an ads list and an envelope with metadata.

The leaderboard page contains about 20 candidates. The envelope includes candidatesScanned for the pre-filter pool size; cache hits also include cached and cachedAt. Advertiser names may be null, and there is no tags field.

Links

• n8n community nodes installation guide