CaptapiInstall

Summary

Fetches popular TikTok songs, optionally filtered by country, time period, ranking type, new-on-board status, or commercial music clearance. You can limit the returned items and request a 24-hour cached response.

Inputs

• Country — Two-letter ISO country code; defaults to US.
• Period — Ranking period in days: 7, 30, or 120. The declared description says 180 is converted to 120; defaults to 7.
• Page — Page number; defaults to 1.
• RankType — Ranking type: popular or surging; defaults to popular.
• NewOnBoard — When true, returns only sounds newly appearing in the Top 100.
• CommercialMusic — When true, returns only sounds cleared for the Commercial Music Library.
• Limit — Maximum number of items to return; defaults to 20 and is capped at 20.
• Cache — When true, serves from the 24-hour response cache when available; cache hits cost 0 credits and include cached and cachedAt in the response envelope. Defaults to false, which fetches fresh data.

Output shape

A response envelope containing popular TikTok song results.

A cache hit includes cached and cachedAt fields. The declared pricing is 2 credits per call, except cache hits, which cost 0 credits.

Links

• n8n community nodes installation guide