TikTok search API

TikTok Search API

Find public TikTok videos matching a keyword. Returns a cursor-paginated page with platform-native fields on each item.

Input: Search keyword. Returns: a page of results with a cursor for the next, in TikTok's own field names. Price: 1 credit per call; failed reads are free.

Try this API Read reference

GET /v1/tiktok/search Search keyword · Cursor page

Recorded response

GET /v1/tiktok/search

Query q=latte artlimit=20

Each call1 credit

Retrieval failurefree

{
  "success": true,
  "available": true,
  "creditsCharged": 1,
  "data": {
    "items": [
      {
        "description": "How to Pour Latte Art - Milk Steaming + Pouring",
        "views": 513204,
        "likes": 59778,
        "comments": 296
      }
    ],
    "fetchedAt": "2026-09-02T06:48:38Z"
  }
}

Key fields shown · full response below

See it in action

Try it with a sample keyword.

The snippets use q for the search term. Replace the sample keyword with the phrase your workflow is tracking.

Try this API live

Pick a sample input

Start from a valid shape, then replace the sample value with your public target.

Selected latte art Open

Preview the request

Use a server-side key and send parameters as query values.

GET https://api.sourcevine.io/v1/tiktok/search

curl -G 'https://api.sourcevine.io/v1/tiktok/search' \
  -H 'Authorization: Bearer sv_live_...' \
  --data-urlencode 'q=latte art' \
  --data-urlencode 'limit=20'

const params = new URLSearchParams({
  "q": "latte art",
  "limit": "20",
});

const res = await fetch('https://api.sourcevine.io/v1/tiktok/search?' + params, {
  headers: { Authorization: 'Bearer sv_live_...' },
});

const body = await res.json();
console.log(body.data);

import requests

r = requests.get(
    "https://api.sourcevine.io/v1/tiktok/search",
    params={"q": "latte art", "limit": "20"},
    headers={"Authorization": "Bearer sv_live_..."},
)

body = r.json()
print(body["data"])

Replays the recorded response. Nothing leaves your browser.

Read the response

Every success includes availability, a fetch timestamp and billing context.

GET /v1/tiktok/search Not run

Hit Show sample response to see the response.

A real TikTok Search API response, recorded against the public target above.

available 1 credit recorded

Shortened to fit. items 3 of 20. A live call returns all of it.

{
  "data": {
    "items": [
      {
        "url": "https://www.tiktok.com/@tannercolson/video/7669054888969555230",
        "likes": 60148,
        "views": 517122,
        "cached": false,
        "shares": 3681,
        "videoId": "7669054888969555230",
        "collects": 19814,
        "comments": 296,
        "fetchedAt": "2026-09-02T16:15:12Z",
        "channelLink": "https://www.tiktok.com/@tannercolson",
        "channelName": "tannercolson",
        "contentType": "video",
        "description": "How to Pour Latte Art - Milk Steaming + Pouring",
        "publishedAt": "2026-08-01T13:30:19Z",
        "cacheAgeSeconds": null,
        "sourceTimestamp": null
      },
      {
        "url": "https://www.tiktok.com/@baristaswag/video/7636439059925044501",
        "likes": 24397,
        "views": 586749,
        "cached": false,
        "shares": 1438,
        "videoId": "7636439059925044501",
        "collects": 9996,
        "comments": 72,
        "fetchedAt": "2026-09-02T16:15:12Z",
        "channelLink": "https://www.tiktok.com/@baristaswag",
        "channelName": "baristaswag",
        "contentType": "video",
        "description": "If your big tulips don’t fit, you're missing the second step👇⁠ ⁠ It all comes down to two phases:⁠ Phase 1: The Push (First 2-3 Hearts)⁠ Your goal is to create a wide base. Push each new heart into the previous one to make the design stretch and wrap.⁠ Phase 2: The Stack (Final 2-3 Hearts)⁠ Your goal is to build height. Use very small, gentle forward movements to stack layers on top of the base you just created.⁠ ⁠ Save this for your next practice session!⁠ What design is giv…",
        "publishedAt": "2026-05-05T16:03:45Z",
        "cacheAgeSeconds": null,
        "sourceTimestamp": null
      },
      {
        "url": "https://www.tiktok.com/@bennnclark/video/7665534507512122637",
        "likes": 65966,
        "views": 933122,
        "cached": false,
        "shares": 2604,
        "videoId": "7665534507512122637",
        "collects": 8566,
        "comments": 200,
        "fetchedAt": "2026-09-02T16:15:12Z",
        "channelLink": "https://www.tiktok.com/@bennnclark",
        "channelName": "bennnclark",
        "contentType": "video",
        "description": "Latte art world championship bracket came out today and guess who’s in it… #latteartist #southbaycoffee #southbayla ",
        "publishedAt": "2026-07-23T01:49:20Z",
        "cacheAgeSeconds": null,
        "sourceTimestamp": null
      }
    ],
    "cached": false,
    "fetchedAt": null,
    "nextCursor": null,
    "cacheAgeSeconds": null
  },
  "success": true,
  "available": true
}

Ship it anywhere

Use this API from code, no-code tools, MCP clients and agents.

We build and maintain theseFirst-party surfaces, versioned with the API.

HTTP Any backend, worker or cron job

Works anywhere that can make an HTTP requestNo plugin to install, and none to wait for.

Make HTTP → Make a request Zapier Webhooks by Zapier → Custom Request n8n HTTP Request node Agents Scoped reads for a tool-using model

Response

Response fields.

Each response includes typed availability, a fetch timestamp, and only the public fields this API promises.

Field	Type	Meaning
items	array	A page of public TikTok posts or videos.
nextCursor	string \| null	Pass as cursor to request the next page.
items[].views	integer \| null	Present only where the platform reports it.
items[].likes	integer \| null	Per-item public like count.
items[].cached	boolean	Matches the page provenance on cached reads.
fetchedAt	ISO datetime	When Sourcevine read the public page.
sourceTimestamp	ISO datetime \| null	The platform timestamp when it is available.
cached	boolean	True when this answer repeats an identical request made moments earlier.
cacheAgeSeconds	integer	Seconds since the reading was taken.

Request flow

How a request is handled.

01 Send a keyword
Send a search keyword. Sourcevine normalizes the query and returns a cursor page.
02 Checked
A missing or empty keyword is refused before any fetch, and not charged.
03 Read
The public data is read when you call. An identical request moments earlier is answered again, free.
04 Typed availability
Deleted, private and unsupported resources return explicit statuses, so clients can stop retrying facts about the world.
05 JSON back
TikTok names stay intact, so your code reads collects instead of reverse-engineering a generic schema.

fetchedAtcreditsChargedavailable

Every response carries fetchedAt and the platform timestamp, so you know how old a reading is before you act on it. TikTok Search API fits recurring search checks in dashboards, spreadsheets, workflows and agents.

Boundaries

What this API does not return.

No contact or bio fields
Bios, email addresses, phone numbers, postal addresses and messenger handles are outside the response contract.
No private data
Private accounts, restricted content and unavailable resources return typed availability instead of guessed data.
No comments or downloads
List APIs return recent public post metadata and metrics. They do not return comment bodies, media files or hidden analytics.

Use cases

Where teams use TikTok Search API.

Creator monitoring

Pull the latest public posts from a watched account on a schedule.

Campaign capture

Build a dataset of recent brand mentions or campaign posts before reporting.

Lead enrichment

See whether a profile is active before spending human review time.

Content ops

Feed recent public videos into moderation, analytics or publishing workflows.

Pricing

1 credit per call, and nothing for a failed read.

The response and X-Credits-Charged header tell you what happened, including when it is zero.

Charged1 credit

AnsweredThe public data came back.
Not found or privateThe lookup was made, and that is the answer. The response says which.
Empty resultThe lookup was made and found nothing to return, such as an account with no posts.

Not charged0 credits

Failure on our sideA timeout or a read we could not complete.
Unsupported URLThe wrong kind of URL: refused before any fetch.
Cache hitAn identical request moments earlier, answered again.

FAQ

Common questions.

What does TikTok Search API return?

Find public TikTok videos matching a keyword. Returns a cursor-paginated page with platform-native fields on each item.

How is it billed?

A call costs 1 credit, including an empty result. Retrieval failures are not charged.

What happens when the resource is private or deleted?

The request returns available=false with a typed availability status. Not-found and private results are charged like any lookup; unsupported URLs and retrieval failures are not.

Does Sourcevine return contact data?

No. Bios, emails, phone numbers, postal addresses and private or restricted content are outside the public response contract.

Do I need to log in to TikTok?

No. Your integration authenticates with a Sourcevine API key. You do not need to supply TikTok credentials or a session.

TikTok Search API

Try it with a sample keyword.

Pick a sample input

Preview the request

Read the response

Use this API from code, no-code tools, MCP clients and agents.

Response fields.

How a request is handled.

What this API does not return.

Where teams use TikTok Search API.

Creator monitoring

Campaign capture

Lead enrichment

Content ops

1 credit per call, and nothing for a failed read.

Common questions.

What does TikTok Search API return?

How is it billed?

What happens when the resource is private or deleted?

Does Sourcevine return contact data?

Do I need to log in to TikTok?

Other APIs you may need.