创建搜索可见性观测任务

为报告创建一次新的采样观测任务。该接口会按关键词、搜索来源和排名深度消耗 credits；forceRefresh=true 重新观测时同样消耗 credits。
接口标签：搜索可见性、SEO
接口特性：

支持 Google、Bing、Baidu 多搜索来源的关键词排名观测

支持 Top10、Top20、Top50 三种观测深度，按深度折算 credits

返回可见性评分、最佳排名、Top10/Top20 覆盖率和来源覆盖率

支持品牌别名和竞品域名配置，输出品牌匹配和竞品差距

创建报告和创建观测任务消耗 credits，读取报告、任务和结果不消耗 credits

credits = 关键词数量 × 各搜索来源单次消耗之和。Google/Bing 在 maxRank=10/20/50 时分别消耗 1/2/5 credits；Baidu 在 maxRank=10/20/50 时分别消耗 10/20/50 credits。例如 10 个关键词 × google_web × maxRank=20 消耗 20 credits；10 个关键词 × google_web + bing_web × maxRank=20 消耗 40 credits；10 个关键词 × baidu_web × maxRank=20 消耗 200 credits
详情页：https://www.gugudata.com/api/details/search-visibility

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200

application/json

接口正常响应。请求成功，业务状态请结合响应体中的自定义业务码判断。

Bodyapplication/json

示例

{
    "name": "string",
    "runId": "string",
    "reportId": "string",
    "state": "string",
    "forceRefresh": true,
    "creditCost": 0,
    "tasksTotal": 0,
    "tasksSucceeded": 0,
    "tasksFailed": 0,
    "metrics": {
        "queryCoverageRate": 0,
        "top10PresenceRate": 0,
        "top20PresenceRate": 0,
        "bestRank": 0,
        "averageVisibleRank": 0,
        "averageRankWithPenalty": 0,
        "competitorGap": 0,
        "sourceCoverage": {
            "google_web": 0
        },
        "visibilityScore": 0
    },
    "errorSummary": [
        {}
    ],
    "createdAt": "string",
    "updatedAt": "string",
    "completedAt": "string"
}

🟠400

🟠401

🟠403

🟠404

🟠405

🟠415

🟠429

🔴500

🔴502

请求参数

请求示例代码

返回响应