TikTok search API for AI assistants

The TikTok search API takes a keyword or phrase and returns matching videos, each with its caption, the creator handle, the post time, and engagement counts. Your assistant uses it to monitor what videos are popular on a topic.

What it does

You pass a search query, and you can set the sort order and the number of results. The provider returns videos that match, with the caption text, the creator handle and display name, when the video was posted, and counts for likes, comments, shares, and views.

Each video comes with its TikTok link and video ID, so your assistant can pass the link to you or call another endpoint to get the video file or the full metadata.

How a Joshu assistant uses it

When you ask what videos are trending on a topic, Joshu searches TikTok and returns the three or four most liked or most recent videos with a note on their engagement.

Before planning a campaign or researching trends, Joshu pulls recent TikTok videos for your keywords and picks out the ones with high engagement or from relevant creators.

When monitoring competitors or industry hashtags, Joshu can run the same search weekly and flag new videos that match your criteria.

Choosing a provider

Providers differ in how they rank results and in which fields they include. Some return only recent videos from the last week, and some search further back. Some providers add the music track or the hashtags used, and some include the creator profile details.

curl https://hello.joshu.me/api/router/call \
  -H "Authorization: Bearer $JOSHU_ROUTER_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "endpoint": "anyapi.tiktok.search.videos",
    "params": {
      "query": "cooking",
      "sortBy": 0,
      "datePosted": 0
    }
  }'