Instagram Location Posts
地点帖子是大家打上地点标签发出的图片和 Reel,小到街角咖啡馆,大到比赛日的体育场,每条都带着说明文字、作者、点赞、评论和媒体。持续关注这些帖子,能第一时间看到人们在某个地方分享了什么,适合做本地趋势研究、活动现场追踪,也方便找到常在某个地点发内容的创作者。
Instagram Location Posts API 主要特性
- 一个地点的所有公开帖子提交 location_id 或地点页面链接,返回在这里标记过的公开帖子和 Reel。
- 热门还是最新,自己选sort_by 为 top 时返回 Instagram 为这个地点排在前面的帖子;为 recent 时从最新的开始取,一直取到 results_limit。
- 帖子内容一应俱全每条帖子都有 shortcode、链接、说明文字、作者、点赞数、评论数、发布时间,以及图片或视频,多图帖子的每一张都会列出来。
- 地点信息跟着帖子走extra.location_id 和 extra.location_name 记在每条记录上,同时采集多个地点时不会混。
Instagram Location Posts API 参数
| 参数 | 必填 | 描述 |
|---|---|---|
location_id | 必填(至少一项) | 要看帖子的那个地点的数字 ID。与 url 任选其一。 |
url | 必填(至少一项) | 地点页面链接,例如 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、sort_by(top 或 recent)和 results_limit 发到 /v1/instagram/location-posts。
- 轮询 GET /v1/tasks/{task_id},直到 status 变成 succeeded。
- 帖子在 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}'
# 想看最新的帖子,把 sort_by 改成 "recent"。
# 帖子通过 GET /v1/tasks/{task_id} 返回。Instagram Location Posts API 最佳使用场景
- 追踪活动现场: 演唱会、球赛、展会进行期间,持续采集场馆的最新帖子,汇总现场照片、文字和反应。
- 发现本地热点: 翻看某个街区或地标最近的帖子文字和画面,了解大家这周在那里聊什么。
- 找本地创作者: 根据某个地点热门帖子的作者,整理一份常在这里发内容的创作者名单。
Instagram Location Posts API 使用建议
- 不只是看一眼的话,用 sort_by recent,它会按 results_limit 一页页往下取。
- 定时跑 recent,并记下已经见过的帖子 id,每次只新增新帖子。
- 看到值得深挖的帖子,把链接交给 Instagram Comments 或 Instagram Post Likers,看看背后的讨论和人群。
相关 API
除了 Instagram Location Posts API,需要其他类型的 Instagram 公开数据时,可以使用以下 API。
- Instagram Posts API — 按 username 采集公开帖子、媒体、标签、提及、时间和互动指标。
- Instagram Reels API — 按 username 采集公开 Reels、媒体、音频、标签、提及和互动指标。
- Instagram Comments API — 从帖子 URL 采集公开评论、作者、时间、点赞数和回复数。
- Instagram Post Info API — 通过已知公开帖子、Reel 或旧版 IGTV URL 查询说明文字、作者身份、媒体、时间、可见互动和输入上下文。
- Instagram Post Likers API — 通过帖子 URL 列出可见点赞列表中的账号,返回用户名、名称、头像和认证状态。
- Instagram Location Info API — 通过地点 ID 或地点页面 URL 查询单个地点,返回名称、类别、电话、经纬度和标记帖子数。
- 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