tiktok-api

TikTok API

オンデマンドで TikTok のデータを取得できます。キーワードによる投稿検索（並べ替え・日付フィルター対応）、ハンドル名によるプロフィール検索、フォロワーとフォロー中のアカウント、ハッシュタグや音楽・サウンドのフィード、位置情報に基づく投稿、コメントスレッドに対応しています。呼び出しごとに通常の HTTP GET を 1 回実行するだけで、利用した分だけお支払いいただけます。ログイン、セッション Cookie、ブラウザー自動化、TikTok 開発者アプリの審査は不要です。

ベース URL：https://tiktok.fetcher.sh

クイックリファレンス

ベース URL	https://tiktok.fetcher.sh
認証	Authorization: Bearer bby_live_... または x402（USDC）
料金	1 回あたり $0.004（一律）
エンドポイント	13 個、すべて GET
MCP	https://tiktok.fetcher.sh/mcp
機械可読ファイル	/openapi.json · /llms.txt · /skill.md

必要なエンドポイントはどれですか？

目的	呼び出し
キーワードで投稿を検索（「いいね」数順／新着順も指定可能）	GET /api/post/search
シェア URL で投稿を検索	GET /api/post?url=...
@ユーザー名でプロフィールを検索	GET /api/user/handle/{username}
ユーザーの投稿、フォロワー、フォロー中のアカウントを取得	GET /api/user/{id}/posts / /followers / /followings
投稿のコメントを取得	GET /api/post/{id}/comments
ハッシュタグの投稿を検索	GET /api/hashtag/{id}/posts
特定のサウンドを使用した投稿を検索	GET /api/music/{id}/posts

各項目のすべてのパラメーターについては、references/endpoints.md を参照してください。

認証

同じデータを 2 通りの方法で支払えます。詳しい仕組みは fetcher スキル を参照してください。

# 1. Prepaid credits (recommended — get a key at https://fetcher.sh/topup
#    or via POST /api/credits/topup, see the fetcher skill)
export FETCHER_API_KEY="bby_live_xxxxxxxxxxxx"
curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://tiktok.fetcher.sh/api/post/search?keyword=hello"

# 2. x402 pay-per-call — omit the header; a GET with no payment returns 402
#    with machine-readable payment requirements (USDC on Base, Polygon,
#    Arbitrum, Monad, or Solana). @x402/fetch signs and retries automatically.

すべてのレスポンスは { "status": number, "message": string, "data": ... } 形式です。HTTP ステータスは status と同じ値になります。

エンドポイント（13 個 — すべて GET、1 回あたり $0.004）

エンドポイント	返される内容
/api/post/search	キーワードに一致する投稿。並べ替えと日付範囲のフィルターに対応
/api/post	シェア URL から特定した 1 件の投稿
/api/post/{id}	ID で指定した 1 件の投稿
/api/post/{id}/comments	投稿のコメント
/api/post/{id}/comments/{commentId}/replies	コメントへの返信
/api/user/handle/{username}	@ユーザー名で指定したプロフィール
/api/user/{id}/posts	ユーザーの投稿
/api/user/{id}/followers	ユーザーのフォロワー
/api/user/{id}/followings	ユーザーがフォローしているアカウント
/api/hashtag/handle/{name}	名前で指定したハッシュタグのメタデータ
/api/hashtag/{id}/posts	ハッシュタグの投稿
/api/music/{id}/posts	サウンド／音楽トラックを使用した投稿
/api/location/{locationId}/posts	位置情報がタグ付けされた投稿

{id}、{username}、{name} はパスパラメーターです。省略可能なクエリパラメーター（cursor、region）は、ページネーションまたは地理的な範囲指定に使用します。keyword（検索）と url（投稿検索）は、記載のあるエンドポイントで必須です。

シナリオ

今月の「いいね」数が多い投稿：

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  --data-urlencode "keyword=ai agent" -G \
  --data-urlencode "sortType=MOST_LIKED" \
  --data-urlencode "dateRange=THIS_MONTH" \
  "https://tiktok.fetcher.sh/api/post/search"

昨日の投稿を新しい順に表示：

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  --data-urlencode "keyword=crypto payments" -G \
  --data-urlencode "sortType=DATE_POSTED" \
  --data-urlencode "dateRange=YESTERDAY" \
  "https://tiktok.fetcher.sh/api/post/search"

その他の sortType 値：RELEVANCE。その他の dateRange 値：ALL_TIME、THIS_WEEK、LAST_THREE_MONTHS、LAST_SIX_MONTHS。

シェア URL または ID で投稿を検索：

curl -H "Authorization: Bearer $FETCHER_API_KEY" -G \
  --data-urlencode "url=https://www.tiktok.com/@username/video/1234567890123456789" \
  "https://tiktok.fetcher.sh/api/post"

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://tiktok.fetcher.sh/api/post/1234567890123456789"

投稿のコメントとコメントへの返信：

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://tiktok.fetcher.sh/api/post/1234567890123456789/comments"

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://tiktok.fetcher.sh/api/post/1234567890123456789/comments/9876543210/replies"

@ハンドル名でプロフィールを検索し、投稿、フォロワー、フォロー中のアカウントを取得：

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://tiktok.fetcher.sh/api/user/handle/khaby.lame"

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://tiktok.fetcher.sh/api/user/6935741396776976390/posts"

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://tiktok.fetcher.sh/api/user/6935741396776976390/followers"

ハッシュタグのメタデータと投稿を取得：

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://tiktok.fetcher.sh/api/hashtag/handle/fyp"

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://tiktok.fetcher.sh/api/hashtag/1234567890/posts"

特定のサウンドを使用した投稿と、特定の位置情報が付いた投稿：

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://tiktok.fetcher.sh/api/music/1234567890123456789/posts"

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://tiktok.fetcher.sh/api/location/1234567890123456789/posts"

MCP

{
  "mcpServers": {
    "tiktok": {
      "url": "https://tiktok.fetcher.sh/mcp",
      "headers": { "Authorization": "Bearer bby_live_..." }
    }
  }
}

無料で利用できるツール：search_endpoints、describe_endpoint、check_balance。有料ツール：fetch_data（上記のすべてのエンドポイントに対応）、topup_credits、および名前付きショートカットの tiktok_post_search。代わりに x402 で呼び出しごとに支払う場合は、headers ブロックを省略してください。詳しい手順は fetcher スキル を参照してください。

エラー

• 400 — パラメーターが不足しているか無効です（メッセージに該当項目が示されます）
• 401 — 不明なキー、またはローテーション済みのキーです
• 402 — 支払いが必要です（x402 チャレンジ）、または topup_required（クレジットを使い切っています）
• 404 — 料金設定のないパスです
• レート制限はありません。上流でエラーが発生した場合も返金されません（配信前に決済が確定します）

リファレンス

• 詳細解説：references/endpoints.md（すべてのパラメーター）· references/scenarios.md（各エンドポイントにつき 1 つの curl）· references/faq.md · references/comparison.md（公式 TikTok API およびブラウザースクレイパーとの比較）
• タスクガイド：バズ投稿の検索 · プロフィールとフォロワー
• スラッシュコマンド：/tiktok-search
• エージェントの完全なセットアップ：https://tiktok.fetcher.sh/skill.md
• OpenAPI 3.1 コントラクト：https://tiktok.fetcher.sh/openapi.json
• 簡易カタログ：https://tiktok.fetcher.sh/llms.txt
• 支払い、クレジット、MCP の詳細解説：fetcher スキル
• サイト：https://tiktok.fetcher.sh