instagram/
location-info

IDまたはロケーションページのURLからInstagramのロケーションを検索し、名称、カテゴリ、電話番号、都市、座標、タグ付けされた投稿数を取得します。

Instagram Location Info API

ロケーションIDまたはURL
スポットの詳細
タグ付き投稿数
1リクエストあたり0.5クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

Instagram Location Info

Instagramで人々がタグ付けするスポットには、それぞれ専用のロケーションページがあり、名称、カテゴリ、住所、都市、電話番号、地図上の座標、そしてタグ付けされた投稿数の累計が掲載されています。こうした詳細情報があれば、ロケーションIDだけの状態から、地図への表示、周辺の店舗との比較、自社データへの紐づけができるようになります。

Instagram Location Info API の主な機能

  • IDまたはページリンクで指定数値の location_id を使うか、instagram.com/explore/locations/ のリンクを貼り付けると、IDがそこから読み取られます。
  • スポットの概要を一目で確認レコードには、ロケーションの名称、カテゴリ、電話番号、住所、都市、緯度、経度、ページURLが含まれます。
  • どれだけ賑わっているかを把握extra.media_count でそのロケーションにタグ付けされた投稿数がわかり、extra には営業時間のステータスと郵便番号も含まれます。

Instagram Location Info API のパラメータ

パラメータ必須説明
location_id必須(いずれか1つ以上)ロケーションの数値IDで、Instagram Location Searchが返す値です。url とどちらか一方を指定します。
url必須(いずれか1つ以上)ロケーションページのリンクです(例:https://www.instagram.com/explore/locations/212988663/)。location_id とどちらか一方を指定します。

Instagram Location Info API の使い方

ロケーションを見つけ、IDまたはリンクを送信して、1件のロケーションレコードを読み取ります。

  1. Instagram Location Searchでロケーションを検索してIDを取得するか、instagram.com からロケーションページのリンクをコピーします。
  2. {"location_id": "384695225271379"} を /v1/instagram/location-info に POST します。
  3. status が succeeded になるまで GET /v1/tasks/{task_id} をポーリングします。
  4. ロケーションは results.items の最初の要素です。
curl -X POST "https://api.socq.ai/v1/instagram/location-info" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"location_id":"384695225271379"}'

# Or send {"url": "https://www.instagram.com/explore/locations/384695225271379/"}.
# The location record is returned by GET /v1/tasks/{task_id}.

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

  • 店舗・施設データベースの拡充: タグ付き投稿から集めたロケーションIDに、カテゴリ、電話番号、住所、座標を追加します。
  • 店舗・施設の注目度比較: 競合するレストラン、ホテル、観光スポットの media_count を並べ、どこで最も多く投稿されているかを確認します。
  • タグ付きスポットの地図化: 緯度と経度でロケーションをプロットし、街の中でアクティビティが集中している場所を把握します。

Instagram Location Info API 活用のヒント

  • 手元にあるのが地名や座標だけの場合は、まずInstagram Location Searchから始めてください。
  • 都市、地区、ランドマークの位置は緯度と経度で判断してください。電話番号と住所は主に店舗などの事業者向けに入力されています。
  • 同じ location_id をInstagram Location Postsに渡すと、media_count の元になっている投稿を読み取れます。

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

  • Instagram Search API — キーワードまたはハンドル名で公開プロフィールを検索し、アカウント情報と表示中のアカウントシグナルを返します。
  • Instagram Hashtag Posts API — ハッシュタグで公開投稿を探し、元のタグ情報、メディア、クリエイター、タイムスタンプ、表示中のエンゲージメントを返します。
  • Instagram Reels Search API — テキストクエリで公開リールを検索し、キャプション、クリエイター、メディア、タイムスタンプ、表示中のエンゲージメント、クエリ情報を返します。
  • Instagram Location Posts API — ロケーションにタグ付けされた、人気または最新の公開投稿を収集し、キャプション、投稿者、エンゲージメント、メディアを返します。
  • Instagram Location Search API — 場所の名前、または緯度と経度からロケーションIDを検索し、名称、住所、市区町村、座標を返します。
  • Instagram Hashtag Search API — キーワードに一致するハッシュタグを検索し、ハッシュタグ名、ID、タグページのURL、公開投稿数を返します。

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

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

Instagram Location Info API — よくある質問

Instagram Location Info APIは、数値のロケーションIDまたはロケーションページのURLを入力として、Instagramのロケーション1件の詳細を取得するAPIです。スポットの名称、カテゴリ、電話番号、住所、都市、座標、タグ付けされた投稿数を返します。

地名または座標でInstagram Location Search APIを実行するか、ロケーションページのURLで /explore/locations/ に続く数字をコピーしてください。

はい。extra.media_count に、そのロケーションにタグ付けされた投稿数が入っています。

1回の検索につき0.5クレジットです。