Agent skill, easy

Search TikTok, as a skill your agent installs.

TikTok search API for an agent: it sends a keyword to a catalog endpoint and reads video caption, views and likes back. Several providers sell the call, so the agent tries the cheapest first. You pay per call, and a failed call costs nothing.

Give this to your agent
set up looot - https://looot.ai/skill.md

Install

How do I install this skill?

Two steps. Set up looot once, then save this skill file where your agent reads skills.

1. Set up looot once

Give this line to your agent
set up looot - https://looot.ai/skill.md

Works in Claude Code, Cursor, Codex and ChatGPT through MCP. Searching and inspecting are free.

2. Save the skill

Save the skill file for Claude Code
mkdir -p ~/.claude/agent-skills/looot-tiktok-search && curl -fsSL https://looot.ai/agent-skills/tiktok-search/SKILL.md -o ~/.claude/agent-skills/looot-tiktok-search/SKILL.md

Or open the raw SKILL.md and drop it into the skills folder of your own agent.

When it starts

What do I say to start this skill?

Any of these starts it. The agent asks for what is missing, nothing more.

  • Example prompt
    find TikTok videos about home workouts

  • Example prompt
    what is trending on TikTok for this keyword

  • Example prompt
    show the top videos and their view counts

It asks for

  • A keyword
  • How many videos

It hands back

  • Video caption
  • Views
  • Likes and comments
  • Shares
  • Author

List caption, author, views, likes and link, sorted by views. Say the keyword and the date of the search.

How it runs

What does the agent do when it runs?

Four moves, in this order, with the price known before any money moves.

  1. Step 1

    Discover

    looot discover finds the endpoints that match the task. It is free.

  2. Step 2

    Inspect

    looot inspect shows the price and the exact input before anything is spent. It is free.

  3. Step 3

    Run

    looot run executes the call with an idempotency key, so a retry never charges twice. The agent reads the run status, not the HTTP code.

  4. Step 4

    Fall back

    On a provider error or a timeout the agent tries the next endpoint in the skill, cheapest first. It never retries a bad input elsewhere.

Providers, cheapest first

What actually differs between providers

Today the price runs from $0.0010 to $0.0012 across 3 endpoints. The dearest costs about 1.2 times the cheapest. Price is only one difference. Each entry below says what that endpoint takes or returns that the others do not.

  1. TikHub logoTikHub

    Takes a keyword, a count and an offset, and pages with a search ID.

    tikhub-api-tiktok-web-fetch-search-video
    $0.0010 / call
  2. TikHub logoTikHub

    Takes a keyword with a region, a sort type and a publish-time filter.

    tikhub-api-tiktok-app-fetch-video-search-result
    $0.0010 / call
  3. AnyAPI logoAnyAPI

    Returns videos with caption, views, likes, comments and shares as normalized JSON, with sort and posting-date filters and a flat price per request.

    anyapi-run-tiktok-search-keyword
    $0.0012 / call
  4. Any Site API

    Searches videos by keyword with a count, and bills per result.

    anysite-api-tiktok-videos-search
    price on request

Cost

What 100 runs of this skill cost

$0.1000

100 searches cost about $0.1000 through the cheapest endpoint, at TikHub, and about $0.1200 through the dearest. Each run is one call.

The file

What is inside the SKILL.md?

The whole file, as your agent reads it. No price is written in it: the agent reads the live price with looot inspect.

SKILL.md for Search TikTok
---
name: looot-tiktok-search
description: Search TikTok. Use when the user says things like "find TikTok videos about home workouts", "what is trending on TikTok for this keyword" or "show the top videos and their view counts". Runs through looot, billed per call.
---

# Search TikTok

TikTok search API for an agent: it sends a keyword to a catalog endpoint and reads video caption, views and likes back. Several providers sell the call, so the agent tries the cheapest first. You pay per call, and a failed call costs nothing.

This skill needs the looot skill set up first: https://looot.ai/skill.md

## Ask for these inputs

The job takes a keyword. Example: home workout.

- A keyword
- How many videos

## Run it

1. Find the endpoint: `looot discover --mode auto --query "tiktok search"`. The endpoints listed below are the known matches.
2. Read the price and the input schema before spending: `looot inspect <endpoint-id>`. Tell the user the price, then run.
3. Run it: `looot run anyapi-run-tiktok-search-keyword --input '{"query":"home workout"}' --idempotency-key <new-key> --wait`. Reuse the same key only to retry the same request.
4. Read the run's `status` and `error`, not the HTTP status. A run can return `failed` with a normal response.
5. If a run fails with a provider error or times out, try the next endpoint from the list below, cheapest first. If it fails on your input (a 4xx style error), fix the input. Do not retry it on other providers.

## Endpoints

Each endpoint reads the same job from a different provider. They differ in inputs, fields and price. Run `looot inspect` on the ones that take the input you hold, start with the cheapest, and move to the next on a provider error.

- `anyapi-run-tiktok-search-keyword`: returns videos with caption, views, likes, comments and shares as normalized JSON, with sort and posting-date filters and a flat price per request
- `anysite-api-tiktok-videos-search`: searches videos by keyword with a count, and bills per result
- `tikhub-api-tiktok-web-fetch-search-video`: takes a keyword, a count and an offset, and pages with a search ID
- `tikhub-api-tiktok-app-fetch-video-search-result`: takes a keyword with a region, a sort type and a publish-time filter

## What comes back

- Video caption
- Views
- Likes and comments
- Shares
- Author

## Answer rule

List caption, author, views, likes and link, sorted by views. Say the keyword and the date of the search.

## Before you start

- Set the sort. Most-liked and newest answer different questions, and the default may not be the one you need.
- Keep the search ID when you page. One provider needs it for the second page and later.
- Note the region. TikTok serves different results per market, and one endpoint takes a region parameter to set it.

## Cost rules

- Searching and inspecting are free. Running is billed per call at the price `looot inspect` shows.
- Say the price before the first run, and the total after a batch.
- Never loop a failing call. Stop after two failures and report what failed.

## When not to use this skill

Use `looot-reddit-search` instead when you want written discussion, not short videos.

Page for people: https://looot.ai/agent-skills/tiktok-search

Wrong fit

When should I use a different skill?

Use Search Reddit when you want written discussion, not short videos.

FAQ

What do people ask about this skill?

Which hooks and formats a topic uses, how many views a typical post earns and who posts most. Your agent can rank by views and list the phrases that repeat in the captions.

Send the keyword to a TikTok search endpoint. Your agent reads back the videos with their caption, views, likes, comments and shares.

On the providers that support it. One takes a sort and a posting-date window, and another takes a sort type and a publish-time filter.

The catalog has hashtag endpoints from the same providers. Ask your agent to search the catalog for TikTok hashtag results and show the price first.

Page with the cursor, the offset or the search ID the first call returns. Each page is billed as a call.

You pay per call, and the price depends on the provider your agent picks. This page reads the cheapest live price from the catalog and shows no number when the catalog is unreachable.

No. A call that fails at the provider costs nothing, and your agent can retry it or send it to another provider.

No. One looot key reaches every provider in the catalog. You top up once, and each call is billed at the price shown before it runs.

Send a POST to /v1/runs with the endpoint id, the input and a new idempotency key, and your looot token in the Authorization header. With wait set to 30, the answer comes back in the response when the run ends within 30 seconds. Otherwise poll GET /v1/runs/<runId>.

That needs scheduled runs, not available yet. Run it by hand whenever you want fresh results.

No. looot bills per call, and nothing runs while your agent is idle.

The same job as a page with the full price ladder: TikTok search API for AI agents. Updated 2026-10-04.

Platforms and providers behind this skill

For agents
skill
looot-tiktok-search
file
https://looot.ai/agent-skills/tiktok-search/SKILL.md
difficulty
easy
input
a keyword
endpoint
anyapi-run-tiktok-search-keyword
endpoint
anysite-api-tiktok-videos-search
endpoint
tikhub-api-tiktok-web-fetch-search-video
endpoint
tikhub-api-tiktok-app-fetch-video-search-result
setup
https://looot.ai/skill.md
llms.txt
https://looot.ai/llms.txt
updated
2026-10-04

Try this skill with your own agent.

Start your workspace, top up, and save the skill where your agent reads it.