获取搜索可见性报告

读取指定搜索可见性报告，返回报告配置、最近一次观测任务和最近聚合指标；该接口不消耗搜索可见性 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

返回响应

🟢200

application/json

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

Bodyapplication/json

示例

{
    "name": "string",
    "reportId": "string",
    "displayName": "string",
    "brand": "string",
    "domain": "string",
    "aliases": [
        "string"
    ],
    "competitors": [
        {
            "domain": "string",
            "name": "string",
            "aliases": [
                "string"
            ]
        }
    ],
    "queries": [
        "string"
    ],
    "sources": [
        "string"
    ],
    "locale": "string",
    "region": "string",
    "maxRank": 0,
    "latestRunId": "string",
    "latestRunStatus": "string",
    "latestMetrics": {},
    "createdAt": "string",
    "updatedAt": "string"
}

🟠400

🟠401

🟠403

🟠404

🟠405

🟠415

🟠429

🔴500

🔴502

请求参数

请求示例代码

返回响应