ユースケース

自分の業界でどの Instagram リールが再生されているか分析する

Q: URL の代わりにユーザー名を使えますか？

はい。startUrls にはプロフィールのリールタブを指定でき、ユーザー名でも動作します。

Q: 1 回の実行で何本まで返せますか？

最大 200 件で、maxItems で指定します。

任意のプロフィールの Instagram リールを、キャプション・再生数・いいね数・コメント数・動画 URL・日付付きで JSON 取得し、伸びる動画を把握できます。

プリペイド、サブスクなしREST でも MCP でもモデル・データ・エージェントを 1 つのキーで

今の Instagram ではショート動画がリーチを左右しますが、競合のリールの成果は、サムネイルに出る数字を 1 つずつ見るしかありません。業界で勝てるフォーマットを見つけるには、データセットが必要です。Lovely Router は、あらゆるプロフィールのリールタブを読み取ります。プロフィールの URL を送ると、リール 1 件につき JSON オブジェクトが 1 つ返り、料金はプリペイド残高からリール単位で支払います。コンテンツレポート、スクリプト、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>

仕組み

アカウントを選ぶ
オーディエンスがリールを見ているクリエイターやブランドです。
上限を付けてツールを実行する
リールタブを startUrls に入れて POST /v1/tools/instagram-reels/run に送り、input の maxItems で上限を決めます。最近のリールだけを残すには until を使います。
繰り返し現れるものを見つける
再生数で並べ替え、キャプションを読み、上位のクリップを視聴します。複数回登場するフック、長さ、トピックを書き留めましょう。

1 回のリクエストでリールを取得する

Instagram リールを取得するは、startUrls にプロフィールのリールタブを受け取ります。ユーザー名でも動作します。

Shell

curl https://lovelyrouter.com/v1/tools/instagram-reels/run \
  -H "Authorization: Bearer $LOVELY_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "input": {
      "startUrls": [
        "https://www.instagram.com/natgeo/reels/"
      ],
      "until": "2026-09-27",
      "maxItems": 40
    },
    "max_results": 40
  }'

各リールには、キャプション、再生数、いいね数、コメント数、動画 URL、日付が含まれます。60 秒を過ぎても実行中の場合は 202 が返ります。ポーリングの方法はツールを実行するをご覧ください。

各リールに含まれるもの

フィールドグループ	取得できる内容
内容	キャプションと動画 URL
リーチ	再生数
エンゲージメント	いいね数とコメント数
時期	日付

レシピ

フックのライブラリを作る。

業界の 5 つのアカウントからリールを 40 件取得し、再生数で並べ替えて、上位 10 件のキャプションの書き出しを書き留めます。

再生数とフォロワー数を比べる。

リールを instagram-profile と結合し、リールの再生数がフォロワー数を上回っているアカウントを見つけます。

投稿日を選ぶ。

リールを曜日ごとにまとめ、平均再生数を比べます。

動画編集者に指示を出す。

上位のリールのキャプションと動画 URL を、次の制作分の参考として編集者に送ります。

競合を毎月追跡する。

競合 1 社を until を設定して毎月実行し、リール 1 本あたりの再生数がどう変化するかを見ます。

普段の言葉で頼みたい場合は、MCP サーバーを接続して Claude Code や Cursor に次のように伝えます。「この 5 つの Instagram アカウントから最新のリールを 30 件ずつ取得し、再生数でランキングにして、上位 10 件のキャプション、再生数、いいね数、日付を表示してください。maxItems と max_results は 150 にしてください。」