instagram/
location-posts

IDまたはURLを指定して、Instagramのロケーションにタグ付けされた公開投稿とリールを収集し、キャプション、投稿者、いいね数、コメント数、メディア、タイムスタンプを人気順または新着順で返します。

Instagram Location Posts API

ロケーションIDまたはURL
人気順または新着順
カルーセルメディア
結果1件あたり0.5クレジット
準備完了
準備完了

パラメータを入力してリクエストを送信してください。タスクのステータスと正規化された結果がここに表示されます。

README

SocQ 編集 · 更新

Instagram Location Posts

ロケーション投稿とは、街角のカフェから試合当日のスタジアムまで、人々がスポットをタグ付けして投稿する写真やリールのことで、それぞれキャプション、投稿者、いいね数、コメント、メディアが含まれます。これを追うと、その場所で今まさに共有されているものが見えるため、地域のトレンド調査、イベントの取材、特定のスポットから発信するクリエイターの発見に役立ちます。

Instagram Location Posts API の主な機能

  • 1つのスポットの投稿を取得location_id またはロケーションページのリンクを指定すると、そこにタグ付けされた公開投稿とリールを取得できます。
  • 人気順または新着順sort_by を top にすると、Instagramがそのスポットで上位と判断した投稿を返し、recent にすると新しい順に results_limit まで取得を続けます。
  • 投稿のすべての情報各投稿には、ショートコード、リンク、キャプション、投稿者、いいね数とコメント数、投稿日時、画像や動画のメディアが含まれ、カルーセルはすべてのスライドが一覧になります。
  • 投稿にスポット情報を付与extra.location_id と extra.location_name が各レコードにロケーションを紐づけるため、複数のスポットを組み合わせるときに便利です。

Instagram Location Posts API のパラメータ

パラメータ必須説明
location_id必須(いずれか1つ以上)タグ付けされた投稿を取得したいスポットの数値IDです。url とどちらか一方を指定します。
url必須(いずれか1つ以上)ロケーションページへのリンクです(例:https://www.instagram.com/explore/locations/212988663/)。location_id とどちらか一方を指定します。
sort_by任意top はそのスポットで上位の投稿(デフォルト)、recent は新しい投稿から順に取得します。
results_limit任意返す投稿の件数で、1〜100の範囲で指定します。デフォルトは20です。

Instagram Location Posts API の使い方

スポットと並び順を選んでタスクを実行し、投稿を読み取ります。

  1. Instagram Location SearchでロケーションIDを調べるか、ロケーションページのリンクをコピーします。
  2. location_id、top または recent の sort_by、results_limit を /v1/instagram/location-posts に POST します。
  3. status が succeeded になるまで GET /v1/tasks/{task_id} をポーリングします。
  4. results.items から投稿を読み取り、残りは results.next_cursor をたどって取得します。
curl -X POST "https://api.socq.ai/v1/instagram/location-posts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"location_id":"384695225271379","sort_by":"top","results_limit":20}'

# Switch sort_by to "recent" for the newest posts first.
# The posts are returned by GET /v1/tasks/{task_id}.

Instagram Location Posts API の主なユースケース

  • イベントの取材: 開催中のスタジアム、コンサート会場、フェスの会場で新着投稿を集め、写真、キャプション、反応を収集します。
  • 地域のトレンド発見: 地区やランドマークの最近のキャプションとメディアを確認し、今週そこで何が話題になっているかを把握します。
  • 地元クリエイターの発掘: スポットの人気投稿の投稿者をもとに、そのロケーションから発信しているクリエイターのリストを作ります。

Instagram Location Posts API 活用のヒント

  • 簡単なスナップショット以上の件数が必要な場合は sort_by に recent を使ってください。results_limit の範囲で多くの投稿をページ送りして取得できます。
  • recent での取得を定期実行し、取得済みの投稿の id を保存しておくと、実行のたびに新しい投稿だけを追加できます。
  • 気になる投稿のURLをInstagram CommentsやInstagram Post Likersに渡すと、その投稿をめぐる会話とオーディエンスがわかります。

Instagram Location Posts API 以外に別の種類の公開Instagramデータが必要な場合は、これらのAPIをご利用ください。

  • Instagram Posts API — ユーザー名から、公開投稿、メディア、ハッシュタグ、メンション、タイムスタンプ、エンゲージメントを取得します。
  • Instagram Reels API — ユーザー名から、公開リール、メディア、オーディオ、ハッシュタグ、メンション、エンゲージメントを取得します。
  • Instagram Comments API — 投稿URLから、公開コメント、投稿者、タイムスタンプ、いいね、返信を取得します。
  • Instagram Post Info API — 既知の公開投稿、リール、旧IGTVのURLを検索し、キャプション、投稿者情報、メディア、タイムスタンプ、表示中のエンゲージメント、入力情報を返します。
  • Instagram Post Likers API — 投稿URLの、表示されているいいねしたユーザーの一覧からアカウントを取得し、ユーザー名、名前、アイコン、認証バッジの有無を返します。
  • Instagram Location Info API — IDまたはロケーションページのURLから1つのロケーションを照会し、名称、カテゴリ、電話番号、座標、タグ付けされた投稿数を返します。

他のプラットフォームを見る

Instagramのデータを、対応する他のソーシャルプラットフォームの公開データと組み合わせられます。

Instagram Location Posts API — よくある質問

Instagram Location Posts APIは、ロケーションIDまたはロケーションページのURLを入力として、Instagramのロケーションにタグ付けされた公開投稿を収集するAPIです。投稿リンク、キャプション、投稿者、いいね数とコメント数、メディア、投稿日時を、人気順または新着順で返します。

Instagram Location Search APIでスポットのロケーションIDを調べ、sort_by を top または recent に設定してここに送信してください。

top はInstagramがそのスポットで上位と判断した投稿を返し、recent はタグ付けされた新しい投稿から順に results_limit に達するまで取得します。

sort_by が recent の場合は最大100件で、results_limit のデフォルトは20です。

返された投稿1件につき0.5クレジットです。