ユースケース

Pinterest トレンドリサーチ：
保存されているアイデアを知る

Q: ピンの結果には何が含まれますか？

画像、タイトル、リンク、保存数です。

Q: Pinterest のボードやプロフィールから始められますか？

はい。ピン、アイデア、コレクション、プロフィール、検索のリンクを startUrls に渡します。

Q: 1 回の実行で何件のピンを取得できますか？

max_results で指定し、最大 200 件です。

Pinterest を検索し、ピンを画像・タイトル・リンク・保存数付きの JSON で取得。ビジュアルのトレンドや、商品やコンテンツに活かせるアイデアを見つけられます。

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

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

デザイナー、マーチャンダイザー、コンテンツチームは数か月先を見て計画を立てます。インテリア、ファッション、料理、ウェディングのアイデアについて、最も良いシグナルは Pinterest で人々が何を保存しているかです。サイトをスクロールしても、得られるのは感覚であって表ではありません。Lovely Router は検索をデータに変えます。キーワードを送ると、ピン 1 件につき JSON オブジェクトが 1 つ返り、料金はプリペイド残高からピン 1 件ごとに課金されます。

AI エージェントに任せる

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

Pinterest トレンドリサーチ：保存されているアイデアを知る. 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>

仕組み

追跡するテーマをリストにする
minimalist living room のような普通の検索フレーズを使うか、Pinterest のピン、ボード、プロフィール、検索のリンクを貼って、すでに知っている場所から始めます。
上限を付けてツールを実行する
max_results を付けて POST /v1/tools/pinterest-search/run に送ります。実行は最大費用を残高から仮押さえし、ピンを JSON で返します。
保存数で順位を付ける
保存数で並べ替えて上位のタイトルと画像を見て、毎月繰り返せば、どのテーマが伸びているかがわかります。

1 回のリクエストでテーマ別のピンを取得する

Pinterest ピンの検索は、search にキーワードを、maxItems にピン数の上限を受け取ります。

Shell

curl https://lovelyrouter.com/v1/tools/pinterest-search/run \
  -H "Authorization: Bearer $LOVELY_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "input": {
        "search": "minimalist living room",
        "maxItems": 30
      },
    "max_results": 30
  }'

キーワードの代わりに startUrls を渡すこともできます。ピン、アイデア、コレクション、プロフィール、検索のリンクです。60 秒を過ぎても実行中の場合は 202 が返ります。ポーリングの方法はツールを実行するをご覧ください。

ピンごとに含まれる情報

フィールド群	取得できる内容
内容	画像とタイトル
出典	ピンへのリンク
需要	保存数

ツールが返すのは検索結果に表示される内容です。モデルに画像のラベル付け、タイトルのテーマ分け、上位ピンからの商品ブリーフの作成を任せられます。

レシピ

来シーズンの色を選ぶ。

5 つのカラーパレットのフレーズで検索し、それぞれの上位 50 件のピンの保存数を比べて、人々が保存し続けているパレットを見極めます。

商品デザイナーへのブリーフを作る。

商品タイプで検索して最も保存されている 30 件のピンを取得し、共通する形、素材、スタイリングをモデルに説明してもらいます。

コンテンツカレンダーを組む。

毎月カテゴリのキーワードで実行し、タイトルを保存数と一緒に保存します。順位を上げているトピックをカレンダーに入れます。

発売前にニッチを確認する。

売りたいスタイルで検索します。最初の 100 件のピンで保存数が全体に少なければ関心は弱く、多ければ需要の所在がわかります。

競合のボードを研究する。

プロフィールまたはコレクションのリンクを startUrls に渡し、どのピンが最も多く保存されているかを調べます。

普段の言葉で頼みたい場合は、MCP サーバーを接続して Claude Code や Cursor に次のように伝えます。「Pinterest で 'small balcony garden ideas' を検索して 40 件のピンを取得し、保存数順に並べて、繰り返し現れる 3 つのスタイルを教えてください。max_results は 40 に設定してください。」