搜索可见性观测结果列表

分页读取观测任务下的关键词级搜索可见性结果；读取操作不消耗 credits。

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

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

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

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

Bodyapplication/json

示例

{
    "results": [
        {
            "name": "string",
            "resultId": "string",
            "reportId": "string",
            "runId": "string",
            "query": "string",
            "source": "string",
            "checkedAt": "string",
            "cacheHit": true,
            "metrics": {
                "visible": true,
                "top10": true,
                "top20": true,
                "bestRank": 0,
                "averageRankWithPenalty": 0,
                "bestCompetitorRank": 0,
                "competitorGap": 0,
                "matchedUrlCount": 0,
                "visibilityScore": 0
            },
            "observedItems": [
                {
                    "rank": 0,
                    "title": "string",
                    "url": "string",
                    "domain": "string"
                }
            ],
            "brandMatches": [
                {
                    "rank": 0,
                    "url": "string",
                    "domain": "string",
                    "registrableDomain": "string",
                    "title": "string"
                }
            ],
            "competitorMatches": [
                {
                    "rank": 0,
                    "url": "string",
                    "domain": "string",
                    "registrableDomain": "string",
                    "title": "string",
                    "competitorDomain": "string",
                    "competitorName": "string"
                }
            ]
        }
    ],
    "nextPageToken": "string"
}

🟠400

🟠401

🟠403

🟠404

🟠405

🟠415

🟠429

🔴500

🔴502

请求参数

请求示例代码

返回响应