TikTok Search Suggestions API

What is the TikTok Search Suggestions API?

The TikTok Search Suggestions API lets you search and return matching results from TikTok with a single REST call. No OAuth, no scraping infrastructure, and no platform SDKs — send the URL, get clean structured JSON back. Results are cached for 24 hours, so repeat lookups are instant and free.

What you get

• Ranked, structured result list
• Title, URL, author, and thumbnail per result
• Engagement metrics where available
• Configurable result limit

Try it

Fill in the parameters below and copy a ready-to-run request in your language of choice.

curl "https://api.captapi.com/v1/tiktok/search-suggestions?q=skincare" \
  -H "Authorization: Bearer capt_live_..."

Example response

{
  "success": true,
  "cached": false,
  "creditsUsed": 28,
  "data": {
    "total": 2,
    "results": [
      {
        "title": "Top result",
        "url": "https://example.com/1",
        "author": "@creator",
        "views": 530120
      },
      {
        "title": "Second result",
        "url": "https://example.com/2",
        "author": "@maker",
        "views": 210430
      }
    ]
  }
}

Response structure

A successful call returns success, cached, creditsUsed, and a data object with the following fields:

Parameters

Authentication: send your key as Authorization: Bearer capt_live_.... A typical call costs 28 credits — billed per result, so the exact amount scales with how many items you request. Repeat calls for the same request are served from cache for free (metrics refresh within ~1 hour).

How it works

1. 1. Sign up — get 100 free credits, no card required.
2. 2. Create a key from your dashboard.
3. 3. Send one request to /v1/tiktok/search-suggestions and parse the JSON response.

Use cases

Frequently asked questions

More TikTok APIs