SEO Data API
使用统一的 SEO API 入口完成已知关键词指标、搜索量历史、关键词建议和相关查询发现。
可用的 SEO API
根据研究问题选择 Keyword Difficulty、Keyword Overview、Keyword Search Volume、Keyword Suggestions 或 Related Keywords。
可以获取哪些 SEO 数据？
SocQ 标准化关键词记录，同时保留各 endpoint 特有字段的完整来源对象。
难度与概览信号
比较可用的自然难度、需求、付费竞争、搜索意图和月度观测。
搜索量历史
衡量已准备关键词列表的当前需求、CPC、竞争和月度历史。
建议词与关系发现
将一个种子查询扩展为建议词或相关词，并保留指标和关系上下文。
SocQ SEO API 与分别接入关键词服务对比
SocQ 将五项关键词研究能力纳入统一的鉴权、异步任务和存储结果契约。
| 能力 | SocQ | 分别接入 |
|---|---|---|
| 覆盖范围 | 难度、概览、搜索量、建议词和相关词 | 分别接入各 endpoint |
| 任务流程 | 提交、轮询并读取标准化记录 | 自行构建请求、重试、持久化和结果处理 |
| 结果上下文 | 标准化字段与完整来源对象 | 来源特定响应对象 |
| 计费 | 按 endpoint 使用输入、请求或返回结果计费 | 来源特定计费逻辑 |
SEO API 如何工作
五个 endpoint 均使用 SocQ 统一的异步生命周期和基于 cursor 的存储结果页。
1. 选择研究流程
按 endpoint 要求提交已准备关键词列表或一个种子查询，并设置支持的搜索市场。
2. 跟踪任务
轮询 /v1/tasks/{task_id}，直到任务成功或失败。
3. 读取关键词记录
读取 data.results.items；has_more 为 true 时继续使用 next_cursor。
此示例补充已准备词表；其余四个 endpoint 的特有 payload 请查看对应 catalog 卡片。
curl -X POST "https://api.socq.ai/v1/seo/keyword-overview" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"keywords":["keyword research","seo analytics"],"location_code":2840,"language_code":"en"}'
# 轮询 GET /v1/tasks/{task_id}
# 读取 data.results.items，并在 has_more 为 true 时继续使用 next_cursor常见 SEO API 使用场景
已知词表优先级
在已选关键词之间比较需求和自然难度。
长尾词发现
从一个种子扩展建议词和相关查询，用于内容简报或投放规划。
趋势与意图分组
按可用月度需求、竞争和分类意图组织关键词。
限制与解读
不同 endpoint 的输入、可用字段、边界和计费方式不同，并受搜索上下文影响。
- Difficulty、Overview 和 Search Volume 接收已准备的关键词数组；Suggestions 和 Related Keywords 接收一个种子查询。
- 搜索市场、语言、depth、limit 和 offset 支持取决于所选 endpoint。
- 来源无可用数据时，返回行或单项指标可能缺失。
- 付费竞争、自然难度、搜索量和分类意图是不同信号。
- extra 是灵活的完整来源对象，不是稳定的标准化 schema。
SEO API 常见问题
SocQ SEO API 套件是什么？
它包含五个需要鉴权的异步 endpoint，用于关键词指标、搜索量、建议词和相关查询研究。
应该选择哪个 endpoint？
已知关键词使用 Difficulty、Overview 或 Search Volume；扩展种子查询使用 Suggestions 或 Related Keywords。
这些 endpoint 如何计费？
计费因 endpoint 而异；请在各 catalog 页面查看按输入、固定请求或返回结果计费的规则。
结合多平台数据，获得更完整的业务洞察
将不同平台的公开账号、内容与互动数据统一起来，帮助你持续跟踪品牌、达人和话题表现，更高效地完成跨平台监测与分析。
Instagram API
通过统一异步流程查询已知 username 或发现公开主页，并采集粉丝列表记录、关注关系、账号发布的帖子、标记主页的帖子、hashtag 结果、Reels、字幕文本、评论、账号计数、互动指标和媒体元数据。
TikTok API
通过统一异步流程采集受支持的 TikTok 公开资料、直接视频元数据、顶级评论、视频搜索结果和指定标签下的视频。
YouTube API
通过统一异步流程采集受支持的公开 YouTube 频道资料、视频详情、频道视频、评论、Shorts、关键词与话题标签结果和可用字幕。
X API
获取公开账号、关注者与关注列表、帖子、回复、引用帖、转发用户、搜索结果和当前趋势，用于研究和监测。
Facebook API
采集公开 Facebook Page、帖子、群组帖子、评论、关键词匹配活动和可用视频字幕，获得标准化身份、内容、来源、格式、地点、媒体、reaction、出席和互动字段。
LinkedIn API
通过已知 URL 获取公开 LinkedIn 个人主页、公司、帖子和职位数据，并返回标准化身份、职业、企业、内容、互动和职位字段。