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件のロケーションレコードを読み取ります。
- Instagram Location Searchでロケーションを検索してIDを取得するか、instagram.com からロケーションページのリンクをコピーします。
- {"location_id": "384695225271379"} を /v1/instagram/location-info に POST します。
- status が succeeded になるまで GET /v1/tasks/{task_id} をポーリングします。
- ロケーションは 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 の元になっている投稿を読み取れます。
関連API
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 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