数据提供商： DataForSEO

使用 DataForSEO 来比较多个目标对象在 AI 相关提及数据中的表现。

每次调用 $0.10 起在 60 秒内响应

传入多个命名的关键词组或域名组，读取各组在 Google AI Overviews 或 ChatGPT 回答中的提及次数和 AI 搜索量。每组以自身的 key 返回，并按地区、语言、平台、被引用的来源域名和被提及的品牌实体细分；另提供跨所有组的汇总细分统计。每个命名组对应一行数据，且这些数据都位于同一个位置、使用同一种语言；可以通过设置 limit 和 offset 参数来获取后续的行数据。每次调用发送一次请求，按供应商的价目表计费；空结果集会标记为无结果。默认地区为美国（location_code 2840）；ChatGPT 回答仅支持美国英语数据，不在 DataForSEO LLM Mentions 地区列表中的地区会被拒绝。

如何调用

第 1 步接入

首次使用时，将提示词粘贴到 Agent 对话中。Skill 会自动安装 CLI 并完成登录。无法使用 shell 的 Agent 可通过 MCP 接入。

接入

set up https://glasser.ai/SKILL.md

Show me how to use the DataForSEO endpoint /v3/ai_optimization/llm_mentions/multi_target_metrics/live on Glasser.

bash

glasser run -p dataforseo -e '/v3/ai_optimization/llm_mentions/multi_target_metrics/live' -i '{"limit":20,"targets":[{"key":"chat_gpt","target":[{"keyword":"chat gpt"}]},{"key":"claude","target":[{"keyword":"claude"}]}],"language_code":"en","location_code":2840}' --endpoint-version 7

使用接口版本 7。运行前请确认当前价格，并先在开始使用页面安装和登录。

每个 Run 执行一次：

bash

IDEMPOTENCY_KEY=$(uuidgen)

执行下方命令；需要重发时，复制相同命令块再次执行：

bash

curl -X POST https://api.glasser.ai/v1/runs \
  -H "Authorization: Bearer gl_..." \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"dataforseo","endpoint":"/v3/ai_optimization/llm_mentions/multi_target_metrics/live","input":{"limit":20,"targets":[{"key":"chat_gpt","target":[{"keyword":"chat gpt"}]},{"key":"claude","target":[{"keyword":"claude"}]}],"language_code":"en","location_code":2840},"endpoint_version":7}'

重发时请使用相同的 Idempotency-Key：第二次发送只会读取首个 Run。新的幂等键会创建新的 Run 并产生新的费用。此处使用接口版本 7，运行前请确认当前价格。

第 2 步尝试一个具体任务

报告品牌在 AI 回答中的曝光情况时，可以在可用数据中查找品牌提及，并收集支持证据。

复制此提示词到你的 Agent，审阅 AI 可见度报告的证据。

提示词

Use dataforseo:/v3/ai_optimization/llm_mentions/multi_target_metrics/live on Glasser.
Find evidence of my brand in the returned AI visibility data for my monitoring report.

接口结构

json

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "limit",
    "targets"
  ],
  "properties": {
    "tag": {
      "type": "string",
      "maxLength": 2048,
      "minLength": 1
    },
    "limit": {
      "type": "integer",
      "maximum": 1000,
      "minimum": 1
    },
    "offset": {
      "type": "integer",
      "maximum": 10000,
      "minimum": 0
    },
    "filters": {
      "type": "array",
      "description": "DataForSEO filter expression, passed through unchanged: one condition [field, operator, value], or conditions joined by \"and\" / \"or\" ([[a], \"and\", [b]]). Field names come from this endpoint's result items; the number of conditions allowed is in the endpoint's docUrl."
    },
    "targets": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "key",
          "target"
        ],
        "properties": {
          "key": {
            "type": "string",
            "maxLength": 250,
            "minLength": 1
          },
          "target": {
            "type": "array",
            "items": {
              "anyOf": [
                {
                  "type": "object",
                  "required": [
                    "domain"
                  ],
                  "properties": {
                    "domain": {
                      "type": "string",
                      "pattern": "^(?!https?:\\/\\/)(?!www\\.)[a-z0-9.-]+$",
                      "maxLength": 63,
                      "minLength": 1
                    },
                    "search_scope": {
                      "type": "array",
                      "items": {
                        "enum": [
                          "any",
                          "sources",
                          "search_results"
                        ],
                        "type": "string"
                      },
                      "maxItems": 3,
                      "minItems": 1
                    },
                    "search_filter": {
                      "enum": [
                        "include",
                        "exclude"
                      ],
                      "type": "string"
                    },
                    "include_subdomains": {
                      "type": "boolean"
                    }
                  },
                  "additionalProperties": false
                },
                {
                  "type": "object",
                  "required": [
                    "keyword"
                  ],
                  "properties": {
                    "keyword": {
                      "type": "string",
                      "maxLength": 250,
                      "minLength": 1
                    },
                    "match_type": {
                      "enum": [
                        "word_match",
                        "partial_match"
                      ],
                      "type": "string"
                    },
                    "search_scope": {
                      "type": "array",
                      "items": {
                        "enum": [
                          "any",
                          "question",
                          "answer",
                          "brand_entities",
                          "fan_out_queries"
                        ],
                        "type": "string"
                      },
                      "maxItems": 5,
                      "minItems": 1
                    },
                    "search_filter": {
                      "enum": [
                        "include",
                        "exclude"
                      ],
                      "type": "string"
                    }
                  },
                  "additionalProperties": false
                }
              ]
            },
            "maxItems": 10,
            "minItems": 1
          }
        },
        "additionalProperties": false
      },
      "maxItems": 10,
      "minItems": 2
    },
    "order_by": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "maxItems": 3,
      "description": "DataForSEO sorting rules, passed through unchanged: up to 3 \"field,asc\" or \"field,desc\" strings, using the same field names as filters."
    },
    "platform": {
      "type": "string",
      "maxLength": 2048,
      "minLength": 1
    },
    "language_code": {
      "type": "string",
      "maxLength": 2048,
      "minLength": 1
    },
    "language_name": {
      "type": "string"
    },
    "location_code": {
      "type": "integer"
    },
    "location_name": {
      "type": "string"
    },
    "internal_list_limit": {
      "type": "integer"
    },
    "initial_dataset_filters": {
      "type": "array",
      "description": "DataForSEO filter expression, passed through unchanged: one condition [field, operator, value], or conditions joined by \"and\" / \"or\" ([[a], \"and\", [b]]). Field names come from this endpoint's result items; the number of conditions allowed is in the endpoint's docUrl."
    }
  },
  "additionalProperties": false
}

json

{
  "limit": 20,
  "targets": [
    {
      "key": "chat_gpt",
      "target": [
        {
          "keyword": "chat gpt"
        }
      ]
    },
    {
      "key": "claude",
      "target": [
        {
          "keyword": "claude"
        }
      ]
    }
  ],
  "language_code": "en",
  "location_code": 2840
}

计费说明

基础费用	有无匹配数据均按此价格收费。	$0.10
每行	按返回的每行计费。	$0.001
每次运行的费用上限	总费用不会超过此金额。	$1.10
数据提供商错误	数据提供商未能响应。	$0.00
运行超时	运行超过时间限制。	$0.00
内部错误	内部错误导致运行未能完成。	$0.00

方法POST版本7数据提供商文档 ↗

使用此接口 ↗

按 platform 分类

按 task 分类

按数据提供商

销售与联系人

搜索与 SEO

本地商家

社交与评价

招聘与职业

使用 DataForSEO 来比较多个目标对象在 AI 相关提及数据中的表现。

如何调用

第 1 步接入

第 2 步尝试一个具体任务

接口结构

计费说明