ユースケース

キーワードで Instagram のアカウント・場所・ハッシュタグを探す

Q: 何を検索できますか？

キーワードでユーザー、場所、ハッシュタグを検索できます。popular タイプでは人気のリールを検索できます。

Q: 1 回の実行で複数の検索語を使えますか？

はい。search にカンマ区切りで入れます。searchLimit は各語に適用されます。

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

合計で最大 250 件で、searchLimit が 1 語あたりの件数を決めます。

Q: フォロワー数は取得できますか？

このツールが見つけるのは、アカウント、場所、タグです。プロフィール文とフォロワー数は、ユーザー名を instagram-profile に通して取得してください。

キーワードで Instagram のユーザー、場所、ハッシュタグを検索して JSON で取得。アウトリーチやリサーチ向けに、クリエイターや地域の店舗のリストを作れます。

API キーを取得ドキュメントを読む

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

クリエイターを審査する、競合を見守る、キャンペーンにタグを付ける。そのどれも、まずアカウントを見つけなければ始まりません。アプリ内の検索は、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>

仕組み

検索語を書く
カンマ区切りの 1 つの search に複数の語を入れます。たとえば coffee roaster, specialty coffee のようにし、必要なら都市名も加えます。
タイプと上限を選ぶ
POST /v1/tools/instagram-search/run に送ります。searchType は user、place、hashtag、popular のいずれかで、input の searchLimit が検索語ごとの上限です。
リストを次へ渡す
ユーザー名はプロフィールや投稿のツールに渡して審査し、ハッシュタグはタグの実行に渡して、残りは CRM に保存します。

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

Instagram を検索するは、search の語と searchType を受け取ります。popular は、アカウントやタグではなく、そのキーワードで話題のリールを返します。

Shell

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": 50
    },
    "max_results": 50
  }'

結果は、選んだタイプに応じて、一致するユーザー、場所、ハッシュタグのいずれかです。60 秒を過ぎても実行中の場合は 202 が返ります。ポーリングの方法はツールを実行するをご覧ください。

各結果に含まれるもの

フィールドグループ	取得できる内容
ユーザー	キーワードに一致するアカウント（`searchType` が `user` の場合）
場所	キーワードに一致するロケーション（`place` の場合）
ハッシュタグ	キーワードに一致するタグ（`hashtag` の場合）
人気のリール	キーワードで話題のリール（`popular` の場合）

このツールが見つけるのは候補です。フォロワー数、プロフィール文、エンゲージメントを確認するには、ユーザー名をプロフィールや投稿のツールに通してください。

レシピ

クリエイターのロングリストを作る。

ニッチなキーワード 10 個で user を検索し、searchLimit を 25 にして、ユーザー名をマージし、重複を除きます。

地域の店舗をマッピングする。

restaurant prague のように、キーワードと都市名で place を検索し、アウトリーチ先の店舗を一覧にします。

キャンペーンのハッシュタグを選ぶ。

商品に関する語で hashtag を検索し、自社のカテゴリに合うタグを選びます。

トピックで人気のリールを確認する。

コンテンツを企画する前に、popular を使って、キーワードで何が話題になっているかを確認します。

審査パイプラインに流し込む。

ユーザー名を instagram-profile に渡し、フォロワー数の基準を満たすものを残します。

普段の言葉で頼みたい場合は、MCP サーバーを接続して Claude Code や Cursor に次のように伝えます。「Instagram のユーザーを『vegan bakery』と『plant based bakery』で 1 語あたり 25 件ずつ検索し、ユーザー名を重複なしで 1 つのリストにしてください。searchLimit は 25、max_results は 50 にしてください。」