instagram/
location-search

地名、または緯度と経度でInstagramのロケーションを検索し、名称、住所、都市、座標を含むロケーションIDを返します。詳細取得などの次のリクエストにそのまま使えます。

Instagram Location Search API

名称または座標
ロケーションID
周辺のスポット
1リクエストあたり0.5クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

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を再利用します。

  1. スポットの名称で検索するか、座標で検索するかを決めます。
  2. {"query": "Times Square"} または {"latitude": 40.758, "longitude": -73.9855} を /v1/instagram/location-search に POST します。
  3. status が succeeded になるまで GET /v1/tasks/{task_id} をポーリングし、results.items を読み取ります。
  4. 都市と座標で目的の候補を選び、その 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を再利用する前に、都市と座標で目的の結果かどうかを確認してください。
  • 場所の正確な位置がわかっている場合は座標で検索してください。結果には、その地点の周辺にあるロケーションが距離とともに一覧になります。

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のデータを、対応する他のソーシャルプラットフォームの公開データと組み合わせられます。

Instagram Location Search API — よくある質問

Instagram Location Search APIは、地名、または緯度と経度でInstagramのロケーションを検索するAPIです。名称、ロケーションページのURL、住所、都市、座標とともに、ロケーションIDを返します。

名称または座標でスポットを検索してください。各結果の id フィールドが、Instagramがロケーションページに使うロケーションIDです。

はい。latitude と longitude を一緒に送信すると、タスクがその地点の周辺にあるロケーションを返します。

返されるロケーションの件数にかかわらず、1回の検索につき0.5クレジットです。