CaptapiInstall

Summary

Searches TikTok users by query and returns a page of matching profiles. Use the cursor from a previous response to fetch the next page; optionally serve cached results or enable scraper fallback when native search is unavailable.

Inputs

• Query (required) — Search text matched against usernames, display names, and bios; the declared minimum is 2 characters.
• Limit — Maximum results to return (default 20; maximum 100).
• Cursor — Pagination cursor from the previous response’s nextCursor, passed verbatim. Omit it or pass 0 for the first page; a null nextCursor indicates the end.
• Fallback — When true, opts into the scraper actor if native search is unavailable. It may take about 2 minutes, is capped at 100 seconds, and can return a degraded empty page on timeout. When false, an unavailable native search returns an empty degraded page.
• Cache — When true, serves a response from the 24-hour cache when available; otherwise fetches fresh results. Cache hits cost 0 credits and include cached and cachedAt in the response envelope.

Output shape

A paginated response containing matching TikTok users.

The response includes nextCursor for requesting another page; null means there are no more results. The properties describe a degraded empty page when native search is unavailable and fallback is disabled, and possible degraded-empty results on fallback timeout. Cache hits include cached and cachedAt in the envelope.

Links

• n8n community nodes installation guide