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 の使い方
スポットと並び順を選んでタスクを実行し、投稿を読み取ります。
- Instagram Location SearchでロケーションIDを調べるか、ロケーションページのリンクをコピーします。
- location_id、top または recent の sort_by、results_limit を /v1/instagram/location-posts に POST します。
- status が succeeded になるまで GET /v1/tasks/{task_id} をポーリングします。
- 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に渡すと、その投稿をめぐる会話とオーディエンスがわかります。
関連API
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 Followers Count API
- Instagram Search API
- Instagram Profiles API
- Instagram Followers List API
- Instagram Following List API
- Instagram Hashtag Posts API
- Instagram Tagged Posts API
- Instagram Transcript API
- Instagram Audio Reels API
- Instagram Highlight Items API
- Instagram Reels Search API
- Instagram Story Highlights API
- Instagram Trending Reels API
- Instagram Stories API
- Instagram Similar Accounts API
- Instagram Comment Replies API
- Instagram Location Search API
- Instagram Hashtag Search API
- Instagram Account Age Checker API