SEO API：搜索结果、关键词与网站排名
查询实时 Google 自然搜索结果，比较关键词需求和排名难度，扩展种子词，找出带来网站搜索可见性的关键词与页面，并识别搜索意图。所有接口共用 SocQ API Key、异步任务流程和标准化结果格式。
可用的 SEO API
按输入和研究目标选择接口：单个查询使用 Google Organic SERP；已有词表使用 Keyword Difficulty、Keyword Overview、Keyword Search Volume 或 Search Intent；种子词扩展使用 Keyword Suggestions 或 Related Keywords；域名和页面研究使用 Keywords for Site、Ranked Keywords 或 Relevant Pages。
seo/google-organic-serp
搜索每条结果 0.1 积分
seo/keyword-difficulty
搜索每个关键词 0.1 积分
seo/keyword-overview
搜索每个关键词 0.15 积分
seo/keyword-search-volume
搜索每次请求 24 积分
seo/keywords-for-site
搜索每条结果 0.1 积分
seo/keyword-suggestions
搜索每条结果 0.1 积分
seo/ranked-keywords
搜索每条结果 0.1 积分
seo/related-keywords
搜索每条结果 0.1 积分
seo/relevant-pages
搜索每条结果 0.15 积分
seo/search-intent
搜索每个关键词 0.1 积分
可以获取哪些 SEO 数据？
常用分析字段采用标准化顶层结构；接口返回额外上下文时，同时保留完整来源对象。
Google 自然搜索结果
获取指定查询和搜索市场下的标题、目标 URL、排名、结果元素类型及其他可用详情。
搜索需求与付费指标
衡量已有或新发现关键词的可用搜索量、CPC、付费竞争程度和月度搜索历史。
自然排名难度
在指定市场中比较最多 1,000 个关键词的可用 0–100 难度分数。
关键词发现
从种子查询或网站扩展建议词和相关词，并在可用时返回需求指标、月度历史和关系深度。
网站与页面可见性
查找域名、子域名或页面的排名关键词、URL、位置、预估流量信息、索引页面和排名分布。
搜索意图
为提交的关键词识别可用的主要、次要意图标签及其概率分数。
SocQ SEO API 与 DataForSEO 对比
如果产品既需要核心 Google 搜索数据，又需要公开社交数据，并希望统一鉴权、任务生命周期和结果模型，SocQ 的接入更直接。DataForSEO 提供覆盖更广的专业 SEO 数据目录，同时需要按不同产品处理调用方法和响应结构。
| 能力 | SocQ | DataForSEO |
|---|---|---|
| 适用场景 | 核心 Google SERP、关键词、排名、页面和意图工作流，并可同时接入公开社交数据 API | 专业 SEO 与 SEM 数据基础设施，覆盖更多搜索引擎、反向链接、站内分析、商业、商品和应用数据 |
| 鉴权 | SEO 与支持的社交数据接口共用一个 Bearer API Key | 使用 API login 和生成密码进行 Basic Authentication |
| 请求模型 | 直接提交 JSON 对象，并统一使用异步提交、轮询和存储结果读取流程 | 不同产品使用 Live 或 Standard 等方法，请求采用任务对象数组 |
| 结果模型 | 标准化顶层字段，同时保留完整来源上下文 | 按不同 API 产品返回原生嵌套 tasks 和 result 结构 |
| 成本展示 | 接口卡片展示积分规则，提交前提供估算，控制台显示最终消耗 | 按量计费，价格随 API、调用方法、优先级、结果深度和可选参数变化 |
SEO API 如何工作
每个接口都遵循相同的异步生命周期，同时接收对应研究流程所需的输入形式。
1. 选择输入形式
提交单个查询、已有关键词列表、种子词或目标域名与页面，并设置接口支持的市场和语言字段。
2. 跟踪任务
轮询 /v1/tasks/{task_id}，直到处理成功或失败；遇到临时压力响应时采用退避重试。
3. 读取标准化结果
读取 data.results.items；当 has_more 为 true 时，继续使用 next_cursor 获取后续结果。
已有待评估词表时，可以从 Keyword Overview 开始；其他研究流程的准确 payload 请查看对应接口卡片。
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 tools"
],
"location_code": 2840,
"language_code": "en"
}'
# 轮询 GET /v1/tasks/{task_id}
# 读取 data.results.items；当 has_more 为 true 时继续使用 next_cursor常见 SEO API 使用场景
SERP 研究与监测
记录指定市场中某个查询返回的自然结果、目标 URL、元素类型和排名位置。
关键词优先级排序
在已有关键词组合中比较需求、CPC、付费竞争、自然难度和月度历史。
长尾词与内容规划
将种子词扩展为建议词和相关查询，用于内容简报、主题集群和推广规划。
竞品搜索可见性研究
查找公开竞品域名或页面对应的关键词、排名 URL、位置和预估流量信息。
页面机会分析
整理相关索引页面和排名分布，找出值得进一步研究的页面与主题。
意图分流与报告
使用主要和次要意图标签，将关键词分配到内容、付费搜索、产品页或报告流程。
限制与解读
结果取决于所选接口、搜索市场、语言、来源可用性，以及提交的查询、关键词、域名或页面范围。
- 每个接口都有独立的 payload 契约：部分接收关键词数组，其余接收单个查询、种子词、域名、子域名或页面 URL。
- location、language、depth、results_limit 和 offset 的支持范围因接口而异，请以对应接口页面作为请求契约。
- Google Organic SERP 返回实时结果页查询；关键词与网站指标属于分析信号，不应视为同一种实时快照。
- 来源数据不可用时，返回记录、单项指标、月度观测、意图标签或概率分数可能缺失。
- 搜索量、付费竞争、自然难度、预估流量和分类意图是不同信号，不能作为同一种分数解读。
- extra 字段用于保留灵活的来源上下文，不是稳定的标准化 schema。
- 这些接口使用 SocQ API Key 鉴权，不读取私有 Google Ads 或 Google Search Console 账户数据。
SEO API 常见问题
什么是 SocQ SEO API？
SocQ SEO API 是一组异步 REST 接口，开发者可以通过 SocQ 平台统一的 API Key 和任务流程，将 Google 搜索数据能力接入应用。
SocQ SEO API 覆盖哪些能力？
它通过需要鉴权的异步接口提供 Google 自然搜索结果、关键词需求与难度、关键词发现、网站与页面可见性以及搜索意图分类。
应该选择哪个 SEO 接口？
单个结果页使用 Google Organic SERP；已有词表使用 Difficulty、Overview、Search Volume 或 Search Intent；种子词扩展使用 Suggestions 或 Related Keywords；域名和页面研究使用 Keywords for Site、Ranked Keywords 或 Relevant Pages。
需要 Google Ads 或 Search Console 凭证吗？
不需要。请求使用 SocQ API Key 鉴权，这些接口不会访问私有 Google Ads 或 Google Search Console 账户数据。
所有 SEO API 结果都是实时的吗？
Google Organic SERP 会执行实时结果页查询；关键词、意图、网站和页面指标取决于来源可用性，应按所选接口的含义进行解读。
SEO 接口如何计费？
计费方式因接口而异。每个接口页面都会说明积分是按提交输入、固定请求成本还是返回结果计算。
结合多平台数据，获得更完整的业务洞察
将不同平台的公开账号、内容与互动数据统一起来，帮助你持续跟踪品牌、达人和话题表现，更高效地完成跨平台监测与分析。
Instagram API
通过统一异步流程查询已知 username 或发现公开主页，并采集粉丝列表记录、关注关系、账号发布的帖子、标记主页的帖子、hashtag 结果、Reels、字幕文本、评论、账号计数、互动指标和媒体元数据。
TikTok API
通过统一异步流程采集受支持的 TikTok 公开资料、直接视频元数据、顶级评论、视频搜索结果和指定标签下的视频。
YouTube API
通过统一异步流程采集受支持的公开 YouTube 频道资料、视频详情、频道视频、评论、Shorts、关键词与话题标签结果和可用字幕。
Facebook API
采集公开 Facebook Page、帖子、群组帖子、评论、关键词匹配活动和可用视频字幕，获得标准化身份、内容、来源、格式、地点、媒体、reaction、出席和互动字段。
X API
获取公开账号、关注者与关注列表、帖子、回复、引用帖、转发用户、搜索结果和当前趋势，用于研究和监测。
LinkedIn API
通过已知 URL 获取公开 LinkedIn 个人主页、公司、帖子和职位数据，并返回标准化身份、职业、企业、内容、互动和职位字段。