instagram/
location-posts

用地点 ID 或链接采集在 Instagram 地点标记的公开帖子和 Reel,返回说明文字、作者、点赞、评论、媒体和发布时间,可按热门或最新排序。

Instagram Location Posts API

地点 ID 或链接
热门或最新
多图媒体
每条结果 0.5 积分
等待提交
等待提交

填写参数并发送请求,任务状态和标准化结果会显示在这里。

README

由 SocQ 维护 · 更新于

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

选好地点和排序方式,跑完任务,读出帖子。

  1. 用 Instagram Location Search 查到地点 ID,或者复制地点页面链接。
  2. 把 location_id、sort_by(top 或 recent)和 results_limit 发到 /v1/instagram/location-posts。
  3. 轮询 GET /v1/tasks/{task_id},直到 status 变成 succeeded。
  4. 帖子在 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,看看背后的讨论和人群。

除了 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 数据与其他已支持社交平台的公开数据结合使用。

Instagram Location Posts API — 常见问题

Instagram Location Posts API 是一个用于通过地点 ID 或地点页面链接获取在 Instagram 地点标记的公开帖子的 API。它返回帖子链接、说明文字、作者、点赞数、评论数、媒体和发布时间,可按热门或最新排序。

先用 Instagram Location Search API 查到这个地方的地点 ID,再把它连同 sort_by(top 或 recent)提交到这里。

top 返回 Instagram 为这个地点排在前面的帖子;recent 从最新标记的帖子开始返回,一直翻页到 results_limit。

sort_by 为 recent 时最多 100 条,results_limit 默认 20。

每返回一条帖子收 0.5 积分。