Instagram Location Search
Instagramは独自のスポットカタログを持っており、投稿に付けられたロケーションタグはすべて、そのカタログの1件をIDで指しています。名称や地図上の地点でカタログを検索することで、店舗、通り、座標といったものが、Instagramがロケーションページやタグ付き投稿に使うIDへと変わります。
Instagram Location Search API の主な機能
- 名称で検索query に地名、ランドマーク、都市名を入力すると、一致するロケーションがIDとともに返ります。
- 地点の周辺を検索緯度と経度を送信すると、その地点の周辺にあるロケーションが一覧になり、それぞれに extra.distance の距離ラベルが付きます。
- 次のステップにすぐ使える一致した各ロケーションには、ロケーションID、ページURL、名称、住所、都市、緯度、経度が含まれるため、詳細取得や投稿取得のリクエストにそのまま渡せます。
Instagram Location Search API のパラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
query | 必須(いずれか1つ以上) | 地名、ランドマーク、都市名で、100文字以内です。latitude と longitude のペアとどちらか一方を指定します。 |
latitude | 必須(いずれか1つ以上) | 周辺を検索する地点の緯度で、-90〜90の範囲で指定します。longitude と一緒に送信してください。 |
longitude | 必須(いずれか1つ以上) | 周辺を検索する地点の経度で、-180〜180の範囲で指定します。latitude と一緒に送信してください。 |
Instagram Location Search API の使い方
名称または座標で検索し、目的の候補を選んで、そのIDを再利用します。
- スポットの名称で検索するか、座標で検索するかを決めます。
- {"query": "Times Square"} または {"latitude": 40.758, "longitude": -73.9855} を /v1/instagram/location-search に POST します。
- status が succeeded になるまで GET /v1/tasks/{task_id} をポーリングし、results.items を読み取ります。
- 都市と座標で目的の候補を選び、その id をInstagram Location InfoまたはInstagram Location Postsで使うために保存します。
curl -X POST "https://api.socq.ai/v1/instagram/location-search" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"Times Square"}'
# To search around a point instead: -d '{"latitude":40.758,"longitude":-73.9855}'
# Matching locations are returned by GET /v1/tasks/{task_id}.Instagram Location Search API の主なユースケース
- 店舗リストのID化: スプレッドシートにある店舗、ホテル、施設の名称を、投稿や詳細の取得に必要なInstagramのロケーションIDに変換します。
- エリアのスポットを一覧化: キャンパス、ショッピングモール、イベント会場の座標を中心に検索し、近くにあるInstagramのロケーションを一覧にします。
- 重複スポットの整理: 名称と座標を比較して、実在の同じ場所を指す複数のInstagramロケーションを見つけ、それぞれから投稿を収集します。
Instagram Location Search API 活用のヒント
- よくある地名の場合は、"Central Park New York" のように query に都市名も含めてください。
- IDを再利用する前に、都市と座標で目的の結果かどうかを確認してください。
- 場所の正確な位置がわかっている場合は座標で検索してください。結果には、その地点の周辺にあるロケーションが距離とともに一覧になります。
関連API
Instagram Location Search API 以外に別の種類の公開Instagramデータが必要な場合は、これらのAPIをご利用ください。
- Instagram Search API — キーワードまたはハンドル名で公開プロフィールを検索し、アカウント情報と表示中のアカウントシグナルを返します。
- Instagram Hashtag Posts API — ハッシュタグで公開投稿を探し、元のタグ情報、メディア、クリエイター、タイムスタンプ、表示中のエンゲージメントを返します。
- Instagram Reels Search API — テキストクエリで公開リールを検索し、キャプション、クリエイター、メディア、タイムスタンプ、表示中のエンゲージメント、クエリ情報を返します。
- Instagram Location Info API — IDまたはロケーションページのURLから1つのロケーションを照会し、名称、カテゴリ、電話番号、座標、タグ付けされた投稿数を返します。
- Instagram Location Posts API — ロケーションにタグ付けされた、人気または最新の公開投稿を収集し、キャプション、投稿者、エンゲージメント、メディアを返します。
- Instagram Hashtag Search API — キーワードに一致するハッシュタグを検索し、ハッシュタグ名、ID、タグページのURL、公開投稿数を返します。
- Instagram Followers Count API
- Instagram Posts API
- Instagram Reels API
- Instagram Comments API
- Instagram Profiles API
- Instagram Followers List API
- Instagram Following List API
- Instagram Tagged Posts API
- Instagram Transcript API
- Instagram Audio Reels API
- Instagram Highlight Items API
- Instagram Post Info API
- Instagram Story Highlights API
- Instagram Trending Reels API
- Instagram Stories API
- Instagram Similar Accounts API
- Instagram Comment Replies API
- Instagram Post Likers API
- Instagram Account Age Checker API