ユースケース

契約前に Instagram のインフルエンサーを審査する

ユーザー名から Instagram のプロフィール詳細を、プロフィール文・フォロワー数・投稿数・最近の投稿付きで JSON 取得し、提携前のクリエイター審査に。

プリペイド、サブスクなしREST でも MCP でもモデル・データ・エージェントを 1 つのキーで
Instagramlovelyjsonitems[0]"username": "mia.runs""bio": "Trail runner, coffee,…"followers": 84500"posts_count": 612"recent_posts": 12

クリエイターからフォロワー数と料金表付きの提案が届き、手元にはさらに 60 人分を確認するスプレッドシートがあるとします。プロフィールを 1 つずつ開いて、プロフィール文を読み、投稿数を数え、最近の投稿を見るのは時間がかかります。Lovely Router ならそれをデータとして返します。ユーザー名を送ると、プロフィール 1 件につき JSON オブジェクトが 1 つ返り、料金はプリペイド残高からプロフィール単位で支払います。審査用のスクリプト、CRM のジョブ、AI エージェントのどこからでも、1 つの API キーで呼び出せます。プロフィールやコメントのデータは個人を特定できる場合があるため、プライバシーやスパム対策のルールを含め、適法に利用する責任は利用者にあります。

AI エージェントに任せる

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

契約前に Instagram のインフルエンサーを審査する. 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 inputs (links, keywords or accounts) and how many results you need>
01

仕組み

010203
  1. ユーザー名を集める

    スプレッドシート、提案が届く受信箱、検索の実行結果などから集めます。

  2. ツールを実行する

    最大 50 件のユーザー名を usernames に入れ、max_results をプロフィール数に設定して POST /v1/tools/instagram-profile/run に送ります。

  3. 採点して絞り込む

    フォロワー数と投稿数を最低基準と照らし合わせ、プロフィール文でカテゴリと連絡先を確認し、最近の投稿から扱っているトピックを見ます。

02

1 回のリクエストで Instagram のプロフィールを取得する

{}

Instagram のプロフィールを取得するは、usernames にユーザー名を受け取ります。ユーザー名 1 つがプロフィール 1 件で、1 回の実行で最大 50 件まで読み取れます。

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

各プロフィールには、プロフィール文、フォロワー数、投稿数、最近の投稿が含まれます。60 秒を過ぎても実行中の場合は 202 が返ります。ポーリングの方法はツールを実行するをご覧ください。

03

各プロフィールに含まれるもの

{}
フィールドグループ取得できる内容
アイデンティティユーザー名とプロフィール文
オーディエンスフォロワー数
発信量投稿数
最近の活動最近の投稿

フォロワー数はリーチを示すだけで、質は示しません。判断する前に、投稿のエンゲージメントとあわせて確認してください。

04

レシピ

提案リストをふるいにかける。

50 件のユーザー名を実行し、フォロワー数が基準に満たないアカウントや投稿数が少ないアカウントを外して、残りを詳しく見ます。

ジャンルの適合を確認する。

各プロフィール文と最近の投稿のキャプションをモデルに送り、そのクリエイターが自社のカテゴリに合うかを尋ねます。

料金表を検証する。

同じ規模のクリエイターのフォロワー数と投稿数を基に、提示された価格を比較します。

ロスターを最新に保つ。

承認済みのクリエイターを毎月実行し、フォロワー数の伸びを追跡します。

エンゲージメントを確認する。

有力な候補を instagram-posts に回し、直近 20 件の投稿でフォロワーあたりのいいね数を計算します。

普段の言葉で頼みたい場合は、MCP サーバーを接続して Claude Code や Cursor に次のように伝えます。「creators.txt にあるユーザー名の Instagram プロフィールを取得し、フォロワー数、投稿数、プロフィール文から読み取れるジャンルを 1 行にまとめた表を作ってください。max_results はユーザー名の数にしてください。」

05

発見ツールやエンゲージメントのデータと組み合わせる

06

料金

料金はプロフィール単位です。実行を開始すると最大費用(呼び出し料金 + プロフィール単価 × max_results)が仮押さえされ、実際に返った分で精算されて、仮押さえの残りは残高に戻ります。失敗またはタイムアウトした実行は返したプロフィールの分だけを支払い、開始時に拒否された実行は無料です。

60 人のクリエイターを審査すると、60 件分として課金されます。サブスクリプションや月額の最低利用料はなく、$5 からチャージでき、1 つの残高でツールとモデルの両方を支払えます。現在の価格は上のカードに表示されており、料金ではすべてのツールを一覧できます。

07

よくある質問

?
ユーザー名でプロフィールを検索できますか?+

はい。usernames はユーザー名のリストを受け取り、1 回の実行で最大 50 件まで指定できます。

エンゲージメント率は表示されますか?+

直接は表示されません。取得できるのはフォロワー数、投稿数、最近の投稿です。エンゲージメントは、instagram-posts で取得した投稿から計算してください。

ジャンルでクリエイターを探せますか?+

instagram-search でキーワードからユーザーを探し、そのユーザー名をここで実行してください。

連絡先は含まれますか?+

データに含まれるのは、プロフィール文、フォロワー数、投稿数、最近の投稿です。クリエイターがプロフィール文に連絡先を載せている場合は、そこで確認できます。

サブスクリプションは必要ですか?+

いいえ。プリペイド残高にクレジットを追加し、実行ごとに残高から差し引かれます。失敗した実行は返した結果の分だけを支払い、自動で更新されるものは何もありません。

大規模にクリエイターを起用するなら、インフルエンサーリサーチ、ソーシャルリスニング、ツールカタログをご覧ください。

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

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