ユースケース

TikTok・Instagram・YouTube のクリエイターデータを取得できるインフルエンサー検索 API

Instagram、TikTok、YouTube でトピック別にクリエイターを探し、フォロワー数、投稿、リール、再生数を JSON で取得。コードやエージェントから使え、結果単位で課金。

プリペイド、サブスクなしREST でも MCP でもモデル・データ・エージェントを 1 つのキーで
InstagramTikTokYouTubeX (Twitter)lovelyjsonitems[0]"handle": "@trailmix.eats""followers": 184200"posts": 612"avg_views": 41300"bio": "Plant-based recipes…""verified": false

インフルエンサーマーケティングのキャンペーンを運用している、あるいはクリエイター発掘のプロダクトを作っているなら、並べ替えて比較できるクリエイターデータが必要です。誰がそのトピックについて投稿しているか、オーディエンスの規模はどれくらいか、最近のコンテンツの成果はどうか。Lovely Router はこれをデータツールとして提供します。Instagram、TikTok、YouTube をキーワードで検索し、プロフィール、投稿、リール、ショート動画、X のプロフィールを JSON で取得できます。料金は結果単位で、モデルと同じキーから支払います。

AI エージェントに任せる

このプロンプトを Claude Code、Cursor、Codex などのコーディングエージェントに貼り付けてください。ドキュメントの場所と API キーの使い方をエージェントに伝えます。

Find creators by topic on Instagram, TikTok, YouTube and X, then pull their followers, posts, reels and views. Use the Lovely Router data tools: each returns JSON and is billed per result.

- Docs (read first): https://lovelyrouter.com/docs/tools/find.md and https://lovelyrouter.com/docs/tools/run.md
- Plan first: POST https://lovelyrouter.com/v1/tools/suggest with `{"task": "<my task in plain words>"}` (free). It returns the tools to run in order, each with an example `input`, the `input_required` fields, an estimated cost and a ready-made `run` request. Replace the example values with my task's; if a field is unclear, read the tool with GET https://lovelyrouter.com/v1/tools/<id>. To browse instead, POST https://lovelyrouter.com/v1/tools/discover searches the catalog.
- Show me the plan and its estimated cost (`total_est_cost_usd`) before running anything large.
- Run: POST https://lovelyrouter.com/v1/tools/<id>/run with `{"input": {...}, "max_results": N}`. A 200 has the finished run with `items`; a 202 means it is still running, so poll the `poll` path until `status` is `succeeded`, `failed`, `timed_out` or `stopped`.
- Only delivered results are billed. Keep max_results small on the first run, check the output, then scale up.
- If you support MCP, connect https://lovelyrouter.com/mcp instead (Streamable HTTP, same key; https://lovelyrouter.com/docs/tools/mcp.md) and use suggest_tools, get_tool and run_tool.
- Auth: read my API key from the LOVELY_API_KEY environment variable and send it as `Authorization: Bearer $LOVELY_API_KEY`. Never print or commit the key. If it is not set, ask me to create one at https://lovelyrouter.com/app/keys.
- Billing is prepaid: every call is charged to my balance, so test with a small request before running anything large.
- Every docs page is plain Markdown; the full index is https://lovelyrouter.com/llms.txt.

My task: <the niche, the platforms, the follower range and what to compare>
01

仕組み

010203
  1. トピックからクリエイターを探す

    Instagram 検索でキーワードに一致するプロフィールを探すか、TikTok 検索や YouTube 検索でキーワードに一致する動画を探します。動画の検索結果にはすべて、投稿者またはチャンネルが記載されています。

  2. 数値を取得する

    見つけたハンドルをプロフィール系・コンテンツ系のツールに送ります。自己紹介とフォロワー数、最近の投稿とリール、YouTube の動画とショート動画、X のプロフィールを取得できます。

  3. スコアを付けて候補を絞る

    いいね数、コメント数、再生数をフォロワー数と比べるのは自前のコードでもできますし、JSON をモデルに渡して、順位付きの候補リストを作らせることもできます。

02

1 回のリクエストで Instagram のクリエイターを検索する

次の実行は、「coffee roaster」に一致する Instagram アカウントを検索し、最大 20 件を返します。

curl https://lovelyrouter.com/v1/tools/instagram-search/run \
  -H "Authorization: Bearer $LOVELY_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "input": {"search": "coffee roaster", "searchType": "user", "searchLimit": 20},
    "max_results": 20
  }'

リクエストは最大 60 秒待ちます。完了した実行は、status、charge_usd に入った費用、items に入ったアカウントを返します。それより長くかかる実行は 202 と poll パスを返します。ポーリングとページ送りについてはツールを実行するで解説しています。

次に、残したいアカウントを調べます。Instagram のプロフィールはユーザー名 1 件につき 1 件の結果を返し、自己紹介、フォロワー数、投稿数、最近の投稿を含みます。max_results を省略すると、上限はリストの件数になります。

cURL
curl https://lovelyrouter.com/v1/tools/instagram-profile/run \
  -H "Authorization: Bearer $LOVELY_API_KEY" \
  -H "content-type: application/json" \
  -d '{"input": {"usernames": ["natgeo"]}}'
03

ツール

Instagram
Instagram を検索

キーワードで Instagram のユーザー・場所・ハッシュタグを検索。

$0.00345 / result詳細 →
Instagram
Instagram のプロフィールを取得

ユーザー名で Instagram のプロフィールを取得:自己紹介、フォロワー数、投稿数、最近の投稿。

$0.00345 / profile詳細 →
Instagram
Instagram の投稿を取得

Instagram アカウントの最近の投稿:キャプション、いいね、コメント数、メディア URL、日付。

$0.001225 / post詳細 →
Instagram
Instagram リールを取得

Instagram アカウントのリール:キャプション、再生数、いいね、コメント、動画 URL、日付。

$0.001225 / reel詳細 →
TikTok
TikTok の動画を検索

キーワードやハッシュタグで TikTok 動画を検索:キャプション、再生数、いいね、シェア、投稿者、音楽。

$0.00045 / video詳細 →
TikTok
TikTok アカウントの動画を取得

TikTok アカウントの動画一覧(投稿者のフォロワー数・いいね数付き)。

$0.00045 / video詳細 →
YouTube
YouTube の動画を検索

キーワード検索、または YouTube のリンク(検索結果・チャンネル・再生リスト・動画の URL)から YouTube 動画を取得:タイトル、再生数、高評価、コメント数、長さ、チャンネル、日付。

$0.00125 / video詳細 →
YouTube
YouTube チャンネルの動画を取得

YouTube チャンネルの動画(@MrBeast のようなハンドルまたはチャンネル URL):タイトル、再生数、高評価、コメント数、長さ、日付。

$0.00125 / video詳細 →
YouTube
YouTube ショートを取得

YouTube チャンネルのショート:タイトル、再生数、高評価、コメント、日付。

$0.00125 / short詳細 →
X (Twitter)
X(Twitter)のプロフィールを取得

X/Twitter アカウントのプロフィール:自己紹介、フォロワー、フォロー、認証、各種カウント。

$0.000375 / profile詳細 →
ツール送るもの各結果の内容
instagram-searchキーワードの search、searchType(user、hashtag、place、popular)一致するプロフィール、ハッシュタグ、場所、または話題のリール
instagram-profileusernames自己紹介、フォロワー数、投稿数、最近の投稿
instagram-postsstartUrls(プロフィール URL またはユーザー名)、untilキャプション、いいね数、コメント数、メディア、フォロワー数付きの投稿者、日付
instagram-reelsstartUrls(リールタブまたはユーザー名)、untilキャプション、再生数、いいね数、コメント、動画 URL、日付
tiktok-searchkeywords、sortType、dateRange、locationキャプション、再生数、いいね数、シェア数、投稿者、音楽
tiktok-profileusernames、since、until動画 1 本と、投稿者のフォロワー数・いいね数
youtube-searchkeywordsタイトル、再生数、いいね数、コメント数、長さ、チャンネル、日付
youtube-channelyoutubeHandles またはチャンネル URLタイトル、再生数、いいね数、コメント数、長さ、日付
youtube-shortsyoutubeHandles またはショートタブの URLタイトル、再生数、いいね数、コメント、日付
x-profiletwitterHandles自己紹介、フォロワー数、フォロー数、認証状態、各種カウント

各ツールのページには、完全な入力スキーマと入力例が載っています。結果のフィールド名はツールごとに異なるため、まず小さな検索を実行して、何が返ってくるかを確認してください。

04

レシピ

ニッチ分野で伸びているクリエイターを探す。

"keywords": ["home espresso"]、"sortType": "MOST_LIKED"、"dateRange": "LAST_THREE_MONTHS"、"location": "US" を指定して tiktok-search を実行します。動画を投稿者ごとにまとめ、よく登場する投稿者に tiktok-profile を実行して、フォロワー数と投稿頻度を確認します。

アプローチ前に候補を精査する。

各ハンドルに対し、until を 90 日前にして instagram-reels を実行します。リール 1 本あたりの再生数の中央値を instagram-profile のフォロワー数と並べると、今もオーディエンスに届いているのが誰かがわかります。

キャンペーンの成果を測る。

協業したクリエイターに instagram-posts を実行し、until をキャンペーン開始日に設定して、それ以降の投稿だけを取得します。スポンサー投稿のいいね数とコメント数をそれ以外の投稿と比べます。

1 人のクリエイターをプラットフォーム横断で把握する。

クリエイターのハンドルを使って youtube-channel、youtube-shorts、x-profile を実行し、どこでオーディエンスが最も大きいかを確認します。

ハッシュタグから始める。

Instagram のハッシュタグ投稿は、ハッシュタグに対応する投稿を各投稿の投稿者付きで返すので、instagram-profile に渡すハンドルのリストが得られます。

05

エージェントにリサーチを任せる

MCP サーバーを Claude Code に接続します。

Shell
claude mcp add --transport http lovely-tools https://lovelyrouter.com/mcp \
  --header "Authorization: Bearer $LOVELY_API_KEY"

あとは次のように頼みます。「直近 3 か月にホームエスプレッソについて投稿した米国の TikTok クリエイターを 15 人探してください。それぞれのフォロワー数と直近 10 本の動画の再生数を取得し、再生数の中央値で並べた表をください。すべての実行に max_results を設定し、始める前に見積もり費用を教えてください。」

06

料金

どの実行もプリペイド残高から課金されます。結果(プロフィール、投稿、リール、動画)1 件ごとの料金に加え、呼び出し料金があるツールではそれもかかります。実行の開始時に、最大費用(呼び出し料金 + 結果単価 × max_results)が残高から仮押さえされます。実行が終わると、返った結果の分だけを支払い、仮押さえの残りは残高に戻ります。失敗またはタイムアウトした実行は返した結果の分だけを支払い、開始時に拒否された実行は無料です。

サブスクリプションや月額の最低利用料はありません。現在の価格は上のカードに表示されており、料金ではすべてのツールを一覧できます。大規模な調査の費用を抑えるには、まず検索し、すべての実行に max_results を設定し、残すアカウントについてだけプロフィールと投稿の全体を取得しましょう。

07

よくある質問

?
Instagram でキーワードからクリエイターを検索できますか?+

はい。searchType を user にして instagram-search を実行すると、キーワードに一致するプロフィールが返ります。ほかの検索タイプでは、ハッシュタグ、場所、話題のリールが返ります。

エンゲージメントの測定にはどの数値を使えますか?+

フォロワー数は Instagram、TikTok、X のプロフィール系ツールから取得でき、Instagram の投稿にも投稿者のフォロワー数が含まれます。いいね数、コメント数、再生数はすべての投稿、リール、動画に付いているため、クリエイターごとのエンゲージメント率を自前のコードで計算できます。

Instagram、TikTok、YouTube のアカウントは必要ですか?+

必要なのは Lovely Router の API キーと、実行をまかなえる残高だけです。これらのツールはどれもログインを求めません。送るのはハンドル、プロフィール URL、キーワードです。

1 回の実行で何人のクリエイターを確認できますか?+

プロフィール系ツールは、リスト内のハンドル 1 件につき 1 件の結果を返します。1 回の実行の上限はツールごとに決まっており、各ツールのページに記載されています。長いリストは複数の実行に分けてください。同時に進行できる実行は最大 10 件です。

クリエイターのデータは個人データにあたりますか?+

特定可能な人物のプロフィールや投稿は、GDPR などのプライバシー法のもとで個人データにあたる場合があります。データを適法に収集・利用する責任は利用者にあり、人物のプロファイリングや法律で禁じられた方法での連絡など、ツールを使ってはならない用途は利用規定に定められています。

アプローチ用のリストを作る前に、利用規定をお読みください。誰が語っているかではなく、ブランドについて何が語られているかを追うにはソーシャルリスニングを、競合の広告キャンペーンについては広告インテリジェンスをご覧ください。

モデル・データ・エージェントを 1 つのプリペイドキーで

サブスクリプションなし。チャージして必要な分だけ使い、すべての請求をログで確認できます。