tiktok-scraper

TikTok Scraper 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 skill をご覧ください。

# 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 から特定した単一の投稿
/api/post/{id}	ID で指定した単一の投稿
/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 skill をご覧ください。

エラー

• 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