CrawlForge
SEODataForSEO5 credits

serp_rank

查看某域名针对某个关键词在 Google 自然结果中的排名——真实的 SERP 排名位置，而非 Custom Search 的排序。返回目标的自然排名、排名 URL 以及其占据的每一个位置。由 DataForSEO 提供支持。

使用场景

关键词排名追踪

持续监控您的页面在目标关键词上的排名，及早发现排名下滑

竞争对手 SERP 监控

追踪竞争对手域名在对您业务至关重要的关键词上的排名

SEO 排名审计

审计一组关键词的自然排名，以确定页面优化和内容工作的优先级

本地与设备 SEO 检查

按地理位置以及 desktop 与 mobile 对比排名，从而发现地域或设备差异

排名追踪仪表盘

将每日自然排名数据接入您自己的仪表盘和报表流水线

Endpoint

POST/api/v1/tools/serp_rank
Auth Required
2 req/s on Free plan
5 credits

Parameters

NameTypeRequiredDefaultDescription
keyword
stringRequired-
要查询排名的搜索关键词
Example: managed wordpress hosting
target
stringRequired-
要在结果中定位的域名或 URL
Example: example.com
depth
numberOptional100
要扫描的结果数量（10-200；100 = 1 页费用）
Example: 100
device
stringOptionaldesktop
要模拟的设备："desktop" 或 "mobile"
Example: mobile
location_name
stringOptionalUnited States
地理位置，例如 'United States' 或 'London,England,United Kingdom'
Example: United States
location_code
numberOptional-
数字形式的 DataForSEO 地理位置代码（会覆盖 location_name）
Example: 2840
language_code
stringOptionalen
语言代码（例如 'en'）
Example: en
serp_rank 测量的是真实的自然排名位置，而非 Custom Search 的排序。depth 控制扫描多少结果——100 条结果等于一页费用。使用 location_name/location_code 和 device 来检查特定地域和设备的排名。

请求示例

terminalBash
curl -X POST https://crawlforge.dev/api/v1/tools/serp_rank \
  -H "X-API-Key: cf_test_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "keyword": "managed wordpress hosting",
    "target": "example.com",
    "depth": 100,
    "device": "desktop",
    "location_name": "United States",
    "language_code": "en"
  }'

响应示例

200 OK1,450ms
{
  "success": true,
  "data": {
    "keyword": "managed wordpress hosting",
    "target": "example.com",
    "location": "United States",
    "language": "en",
    "device": "desktop",
    "depth": 100,
    "found": true,
    "rank": 3,
    "url": "https://example.com/",
    "all_positions": [
      3,
      27
    ],
    "results_scanned": 100,
    "checked_at": "2026-07-01T14:30:00Z"
  },
  "credits_used": 5,
  "credits_remaining": 995,
  "processing_time": 1450
}
Field Descriptions
data.rank最佳自然排名位置（如果在 depth 范围内未找到目标，则为 null）
data.url占据最佳排名位置的 URL
data.all_positions目标在扫描的 depth 范围内占据的每一个自然排名位置
data.found目标是否出现在扫描的 depth 范围内
credits_used每次查询固定消耗 5 credits（100 条结果 = 1 页费用）
processing_time查询通常在 1-2 秒内完成

错误处理

缺少 keyword 或 target（400 Bad Request）

keyword 和 target 均为必填项。请提供搜索关键词以及域名或 URL。

depth 无效（400 Bad Request）

depth 必须介于 10 到 200 之间。更大的 depth 会扫描更多结果。

device 无效（400 Bad Request）

device 必须为 "desktop" 或 "mobile"。

配额超限（429 Too Many Requests）

SERP 提供商设有每日限额。升级您的套餐 以获得更高配额。

专业提示： 将一个纯域名（example.com）作为 target 传入，即可匹配该域名下的每一个排名 URL。当地理位置名称存在歧义时，使用 location_code 进行精确的地理定向。

Credit 费用

5 credits
每次查询 5 credits
扫描最多 100 条结果的固定费用。仅对成功的查询扣除 credits。

包含内容：

真实的自然 SERP 排名位置（而非 Custom Search 排序）

排名 URL 以及目标占据的每一个位置

地理位置和语言定向

desktop 和 mobile 设备模拟

扫描深度最多 200 条结果

套餐推荐：

Free 套餐： 1,000 个一次性试用 credits = 200 次查询

Hobby 套餐： 5,000 credits = 1,000 次查询（$19/mo）

Professional 套餐： 50,000 credits = 10,000 次查询（$99/mo）

相关工具

search_web
搜索 Google 并获取结构化 SERP 结果（5 credits）
track_changes
持续监控排名页面的变更（3 credits）
analyze_content
分析排名页面的主题和可读性（3 credits）
deep_research
具备 AI 分析的多源研究（10 credits）
准备好试用 serp_rank 了吗？免费注册，获取 1,000 credits，开始追踪您的排名。