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。
- 先想好是用地点名称搜,还是用坐标搜。
- 向 /v1/instagram/location-search 发送 {"query": "Times Square"} 或 {"latitude": 40.758, "longitude": -73.9855}。
- 轮询 GET /v1/tasks/{task_id},status 变成 succeeded 后读取 results.items。
- 按城市和经纬度挑出正确的结果,把它的 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 之前,先用城市和经纬度确认它就是你要找的地方。
- 知道一个地方的准确位置时,用坐标搜索,结果会列出周边的地点和各自的距离。
相关 API
除了 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 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