搜索可见性观测任务列表

分页读取指定报告下的搜索可见性观测任务；读取操作不消耗 credits。

接口详情官网地址: https://www.gugudata.com/api/details/search-visibility
请求方法: GET
接口路径: /v1/searchVisibilityReports/{reportId}/runs
OpenAPI: https://www.gugudata.com/openapi/gugudata.openapi.3.1.json

运行前请设置 searchVisibilityReportId；未设置时集合运行自动跳过。

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

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

Bodyapplication/json

示例

{
    "runs": [
        {
            "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"
        }
    ],
    "nextPageToken": "string"
}

🟠400

🟠401

🟠403

🟠404

🟠405

🟠415

🟠429

🔴500

🔴502

请求参数

请求示例代码

返回响应