Instagram Search API

Instagram Search

主要特性

• 主页关键词搜索按关键词、handle、名称或账号短语搜索公开 Instagram 主页。
• 主页身份与计数在公开可见的前提下返回 username、显示名称、bio、主页 URL、头像、验证状态、隐私状态和可见计数。
• 一致的主页结构对宽泛关键词、名称和精确 handle 搜索返回一致的标准化主页结构。
• 请求结果上限使用 results_limit 设置每次搜索请求的主页记录上限。
• 公开数据边界响应范围不包含私密、受限、已删除或登录后才可见的主页数据。

参数

如何使用

把主页搜索词作为异步任务提交，轮询 task ID，完成后再用 cursor 分页读取标准化主页结果。

1. 准备一个非空的主页关键词、handle 或搜索短语。
2. 向 /v1/instagram/search POST query 和可选的 results_limit。
3. 轮询 /v1/tasks/{task_id}，直到状态变为 succeeded 或 failed。
4. 通过 /v1/tasks/{task_id}?limit=50 读取 data.results，有更多主页时继续传 results.next_cursor。

curl -X POST "https://api.socq.ai/v1/instagram/search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"sustainable travel","results_limit":25}'

# 轮询 GET /v1/tasks/{task_id}，再读取 /v1/tasks/{task_id}?limit=50，并使用 data.results。

最佳使用场景

• 达人发现： 按关键词、handle、分类或活动短语查找相关公开主页，再做进一步补全。
• 账号补全： 为选中的搜索结果补全公开主页身份、bio、验证状态、隐私状态和可见计数字段。
• 品牌发现： 查找与名称、产品分类或市场短语相关的公开品牌和组织主页。
• 研究目录： 构建可审核的公开 Instagram 主页清单，用于研究、线索筛选或内部分析。
• 主页筛选流程： 选出相关主页后，再调用 Posts、Reels 或 Followers Count API 获取更深的公开记录。

使用建议

• 搜索流程里要把 429 当作常见压力信号处理，用 backoff 和更小的结果窗口，不要高频硬重试。
• 保存 task ID、稳定 profile ID、username 和标准 URL，方便搜索重放、追踪和审计。
• Search 适合发现主页；如果需要更深的帖子、Reels 或计数数据，再调用对应 API。
• 不要默认这个接口能读取私有、登录后可见或账号自有数据，除非公开 API 文档明确支持。
• 用户输入的搜索词进入生产管道前需要清洗和校验。

相关 API