instagram/
location-search

按地点名称或经纬度搜索 Instagram 地点,返回地点 ID 以及名称、地址、城市和经纬度,拿到的 ID 可以直接用于后续查询。

Instagram Location Search API

名称或坐标
地点 ID
周边地点
每次请求 0.5 积分
等待提交
等待提交

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

README

由 SocQ 维护 · 更新于

Instagram Location Search

Instagram 有一套自己的地点库,帖子上的每个地点标签都通过 ID 指向库里的某一条。按名称或地图上的一个点去搜这个地点库,就能把一家店、一条街或一组坐标,换成 Instagram 地点页和标记帖子所用的那个 ID。

Instagram Location Search API 主要特性

  • 按名字搜在 query 里填地点名称、地标或城市,返回匹配的地点和它们的 ID。
  • 按坐标搜周边提交纬度和经度,列出这个点周围的地点,每个结果的距离写在 extra.distance 里。
  • 拿来就能接着用每个结果都有地点 ID、页面链接、名称、地址、城市、纬度和经度,可以直接拿去查地点详情或地点帖子。

Instagram Location Search API 参数

参数必填描述
query必填(至少一项)地点名称、地标或城市,最多 100 个字符。与 latitude、longitude 任选一种方式。
latitude必填(至少一项)搜索中心点的纬度,取值 -90 到 90,需和 longitude 一起提交。
longitude必填(至少一项)搜索中心点的经度,取值 -180 到 180,需和 latitude 一起提交。

如何使用 Instagram Location Search API

按名称或坐标搜索,挑出对的那个结果,再复用它的 ID。

  1. 先想好是用地点名称搜,还是用坐标搜。
  2. 向 /v1/instagram/location-search 发送 {"query": "Times Square"} 或 {"latitude": 40.758, "longitude": -73.9855}。
  3. 轮询 GET /v1/tasks/{task_id},status 变成 succeeded 后读取 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"}'

# 按坐标搜周边:-d '{"latitude":40.758,"longitude":-73.9855}'
# 匹配的地点通过 GET /v1/tasks/{task_id} 返回。

Instagram Location Search API 最佳使用场景

  • 把门店名单换成地点 ID: 把表格里的门店、酒店或场馆名称批量换成 Instagram 地点 ID,后面查帖子、查详情都用得上。
  • 摸清一片区域: 以校园、商场或活动场地的坐标为中心搜索,列出附近所有 Instagram 地点。
  • 合并重复地点: 对比名称和经纬度,找出指向同一个真实地方的几个 Instagram 地点,再分别采集它们的帖子。

Instagram Location Search API 使用建议

  • 地名比较常见时,在 query 里带上城市,例如 "Central Park New York"。
  • 复用某个结果的 ID 之前,先用城市和经纬度确认它就是你要找的地方。
  • 知道一个地方的准确位置时,用坐标搜索,结果会列出周边的地点和各自的距离。

除了 Instagram Location Search API,需要其他类型的 Instagram 公开数据时,可以使用以下 API。

  • Instagram Search API — 按关键词或账号名称搜索公开主页及可见账号信息。
  • Instagram Hashtag Posts API — 按 hashtag 发现公开帖子,返回来源标签、媒体、创作者、时间和可见互动指标。
  • Instagram Reels Search API — 按文本 query 搜索公开 Reels,返回说明文字、创作者、媒体、时间、可见互动指标和查询上下文。
  • Instagram Location Info API — 通过地点 ID 或地点页面 URL 查询单个地点,返回名称、类别、电话、经纬度和标记帖子数。
  • Instagram Location Posts API — 采集在某个地点标记的热门或最新公开帖子,返回说明文字、作者、互动数据和媒体。
  • Instagram Hashtag Search API — 按关键词查找匹配的话题标签,返回标签名称、ID、标签页 URL 和公开帖子数量。

探索其他平台

还可以将 Instagram 数据与其他已支持社交平台的公开数据结合使用。

Instagram Location Search API — 常见问题

Instagram Location Search API 是一个用于按地点名称或经纬度查找 Instagram 地点的 API。它返回地点 ID,以及名称、地点页面链接、地址、城市和经纬度。

按名称或坐标搜索这个地方,每个结果的 id 字段就是 Instagram 地点页使用的地点 ID。

能。同时提交 latitude 和 longitude,任务会返回这个点周围的地点。

每次搜索收 0.5 积分,不论返回多少个地点。