实时 LLM 提及交叉聚合指标
curl --request POST \
--url https://api.aisa.one/apis/v1/dataforseo/ai_optimization/llm_mentions/cross_aggregated_metrics/live \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
[
{
"targets": [
{
"aggregation_key": "<string>",
"target": [
{
"domain": "<string>",
"keyword": "<string>",
"search_filter": "<string>",
"search_scope": [
"<string>"
],
"include_subdomains": true,
"match_type": "<string>"
}
]
}
],
"location_name": "<string>",
"location_code": 123,
"language_name": "<string>",
"language_code": "<string>",
"platform": "<string>",
"initial_dataset_filters": [
"<unknown>"
],
"internal_list_limit": 123,
"tag": "<string>"
}
]
'import requests
url = "https://api.aisa.one/apis/v1/dataforseo/ai_optimization/llm_mentions/cross_aggregated_metrics/live"
payload = [
{
"targets": [
{
"aggregation_key": "<string>",
"target": [
{
"domain": "<string>",
"keyword": "<string>",
"search_filter": "<string>",
"search_scope": ["<string>"],
"include_subdomains": True,
"match_type": "<string>"
}
]
}
],
"location_name": "<string>",
"location_code": 123,
"language_name": "<string>",
"language_code": "<string>",
"platform": "<string>",
"initial_dataset_filters": ["<unknown>"],
"internal_list_limit": 123,
"tag": "<string>"
}
]
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify([
{
targets: [
{
aggregation_key: '<string>',
target: [
{
domain: '<string>',
keyword: '<string>',
search_filter: '<string>',
search_scope: ['<string>'],
include_subdomains: true,
match_type: '<string>'
}
]
}
],
location_name: '<string>',
location_code: 123,
language_name: '<string>',
language_code: '<string>',
platform: '<string>',
initial_dataset_filters: ['<unknown>'],
internal_list_limit: 123,
tag: '<string>'
}
])
};
fetch('https://api.aisa.one/apis/v1/dataforseo/ai_optimization/llm_mentions/cross_aggregated_metrics/live', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.aisa.one/apis/v1/dataforseo/ai_optimization/llm_mentions/cross_aggregated_metrics/live",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
[
'targets' => [
[
'aggregation_key' => '<string>',
'target' => [
[
'domain' => '<string>',
'keyword' => '<string>',
'search_filter' => '<string>',
'search_scope' => [
'<string>'
],
'include_subdomains' => true,
'match_type' => '<string>'
]
]
]
],
'location_name' => '<string>',
'location_code' => 123,
'language_name' => '<string>',
'language_code' => '<string>',
'platform' => '<string>',
'initial_dataset_filters' => [
'<unknown>'
],
'internal_list_limit' => 123,
'tag' => '<string>'
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.aisa.one/apis/v1/dataforseo/ai_optimization/llm_mentions/cross_aggregated_metrics/live"
payload := strings.NewReader("[\n {\n \"targets\": [\n {\n \"aggregation_key\": \"<string>\",\n \"target\": [\n {\n \"domain\": \"<string>\",\n \"keyword\": \"<string>\",\n \"search_filter\": \"<string>\",\n \"search_scope\": [\n \"<string>\"\n ],\n \"include_subdomains\": true,\n \"match_type\": \"<string>\"\n }\n ]\n }\n ],\n \"location_name\": \"<string>\",\n \"location_code\": 123,\n \"language_name\": \"<string>\",\n \"language_code\": \"<string>\",\n \"platform\": \"<string>\",\n \"initial_dataset_filters\": [\n \"<unknown>\"\n ],\n \"internal_list_limit\": 123,\n \"tag\": \"<string>\"\n }\n]")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.aisa.one/apis/v1/dataforseo/ai_optimization/llm_mentions/cross_aggregated_metrics/live")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("[\n {\n \"targets\": [\n {\n \"aggregation_key\": \"<string>\",\n \"target\": [\n {\n \"domain\": \"<string>\",\n \"keyword\": \"<string>\",\n \"search_filter\": \"<string>\",\n \"search_scope\": [\n \"<string>\"\n ],\n \"include_subdomains\": true,\n \"match_type\": \"<string>\"\n }\n ]\n }\n ],\n \"location_name\": \"<string>\",\n \"location_code\": 123,\n \"language_name\": \"<string>\",\n \"language_code\": \"<string>\",\n \"platform\": \"<string>\",\n \"initial_dataset_filters\": [\n \"<unknown>\"\n ],\n \"internal_list_limit\": 123,\n \"tag\": \"<string>\"\n }\n]")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.aisa.one/apis/v1/dataforseo/ai_optimization/llm_mentions/cross_aggregated_metrics/live")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "[\n {\n \"targets\": [\n {\n \"aggregation_key\": \"<string>\",\n \"target\": [\n {\n \"domain\": \"<string>\",\n \"keyword\": \"<string>\",\n \"search_filter\": \"<string>\",\n \"search_scope\": [\n \"<string>\"\n ],\n \"include_subdomains\": true,\n \"match_type\": \"<string>\"\n }\n ]\n }\n ],\n \"location_name\": \"<string>\",\n \"location_code\": 123,\n \"language_name\": \"<string>\",\n \"language_code\": \"<string>\",\n \"platform\": \"<string>\",\n \"initial_dataset_filters\": [\n \"<unknown>\"\n ],\n \"internal_list_limit\": 123,\n \"tag\": \"<string>\"\n }\n]"
response = http.request(request)
puts response.read_body{
"version": "<string>",
"status_code": 123,
"status_message": "<string>",
"time": "<string>",
"cost": 123,
"tasks_count": 123,
"tasks_error": 123,
"tasks": [
"<string>"
],
"tasks.id": "<string>",
"tasks.status_code": 123,
"tasks.status_message": "<string>",
"tasks.time": "<string>",
"tasks.cost": 123,
"tasks.result_count": 123,
"tasks.path": [
"<string>"
],
"tasks.data": {},
"tasks.result": [
"<string>"
],
"tasks.result.total": {},
"tasks.result.total.location": [
"<string>"
],
"tasks.result.total.location.type": "<string>",
"tasks.result.total.location.key": "<string>",
"tasks.result.total.location.mentions": 123,
"tasks.result.total.location.ai_search_volume": 123,
"tasks.result.total.location.impressions": 123,
"tasks.result.total.language": [
"<string>"
],
"tasks.result.total.language.type": "<string>",
"tasks.result.total.language.key": "<string>",
"tasks.result.total.language.mentions": 123,
"tasks.result.total.language.ai_search_volume": 123,
"tasks.result.total.language.impressions": 123,
"tasks.result.total.platform": [
"<string>"
],
"tasks.result.total.platform.type": "<string>",
"tasks.result.total.platform.key": "<string>",
"tasks.result.total.platform.mentions": 123,
"tasks.result.total.platform.ai_search_volume": 123,
"tasks.result.total.platform.impressions": 123,
"tasks.result.total.sources_domain": [
"<string>"
],
"tasks.result.total.sources_domain.type": "<string>",
"tasks.result.total.sources_domain.key": "<string>",
"tasks.result.total.sources_domain.mentions": 123,
"tasks.result.total.sources_domain.ai_search_volume": 123,
"tasks.result.total.sources_domain.impressions": 123,
"tasks.result.total.search_results_domain": [
"<string>"
],
"tasks.result.total.search_results_domain.type": "<string>",
"tasks.result.total.search_results_domain.key": "<string>",
"tasks.result.total.search_results_domain.mentions": 123,
"tasks.result.total.search_results_domain.ai_search_volume": 123,
"tasks.result.total.search_results_domain.impressions": 123,
"tasks.result.total.brand_entities_title": [
"<string>"
],
"tasks.result.total.brand_entities_title.type": "<string>",
"tasks.result.total.brand_entities_title.key": "<string>",
"tasks.result.total.brand_entities_title.mentions": 123,
"tasks.result.total.brand_entities_title.ai_search_volume": 123,
"tasks.result.total.brand_entities_title.impressions": 123,
"tasks.result.total.brand_entities_category": [
"<string>"
],
"tasks.result.total.brand_entities_category.type": "<string>",
"tasks.result.total.brand_entities_category.key": "<string>",
"tasks.result.total.brand_entities_category.mentions": 123,
"tasks.result.total.brand_entities_category.ai_search_volume": 123,
"tasks.result.total.brand_entities_category.impressions": 123,
"tasks.result.items": [
"<string>"
],
"tasks.result.items.key": "<string>",
"tasks.result.items.location": [
"<string>"
],
"tasks.result.items.location.type": "<string>",
"tasks.result.items.location.key": "<string>",
"tasks.result.items.location.mentions": 123,
"tasks.result.items.location.ai_search_volume": 123,
"tasks.result.items.location.impressions": 123,
"tasks.result.items.language": [
"<string>"
],
"tasks.result.items.language.type": "<string>",
"tasks.result.items.language.key": "<string>",
"tasks.result.items.language.mentions": 123,
"tasks.result.items.language.ai_search_volume": 123,
"tasks.result.items.language.impressions": 123,
"tasks.result.items.platform": [
"<string>"
],
"tasks.result.items.platform.type": "<string>",
"tasks.result.items.platform.key": "<string>",
"tasks.result.items.platform.mentions": 123,
"tasks.result.items.platform.ai_search_volume": 123,
"tasks.result.items.platform.impressions": 123,
"tasks.result.items.sources_domain": [
"<string>"
],
"tasks.result.items.sources_domain.type": "<string>",
"tasks.result.items.sources_domain.key": "<string>",
"tasks.result.items.sources_domain.mentions": 123,
"tasks.result.items.sources_domain.ai_search_volume": 123,
"tasks.result.items.sources_domain.impressions": 123,
"tasks.result.items.search_results_domain": [
"<string>"
],
"tasks.result.items.search_results_domain.type": "<string>",
"tasks.result.items.search_results_domain.key": "<string>",
"tasks.result.items.search_results_domain.mentions": 123,
"tasks.result.items.search_results_domain.ai_search_volume": 123,
"tasks.result.items.search_results_domain.impressions": 123,
"tasks.result.items.brand_entities_title": [
"<string>"
],
"tasks.result.items.brand_entities_title.type": "<string>",
"tasks.result.items.brand_entities_title.key": "<string>",
"tasks.result.items.brand_entities_title.mentions": 123,
"tasks.result.items.brand_entities_title.ai_search_volume": 123,
"tasks.result.items.brand_entities_title.impressions": 123,
"tasks.result.items.brand_entities_category": [
"<string>"
],
"tasks.result.items.brand_entities_category.type": "<string>",
"tasks.result.items.brand_entities_category.key": "<string>",
"tasks.result.items.brand_entities_category.mentions": 123,
"tasks.result.items.brand_entities_category.ai_search_volume": 123,
"tasks.result.items.brand_entities_category.impressions": 123
}LLM 提及
实时 LLM 提及交叉聚合指标
一次调用里跨多个目标比较提及指标，按 aggregation_key 分组。
POST
https://api.aisa.one/apis/v1
/
dataforseo
/
ai_optimization
/
llm_mentions
/
cross_aggregated_metrics
/
live
实时 LLM 提及交叉聚合指标
curl --request POST \
--url https://api.aisa.one/apis/v1/dataforseo/ai_optimization/llm_mentions/cross_aggregated_metrics/live \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
[
{
"targets": [
{
"aggregation_key": "<string>",
"target": [
{
"domain": "<string>",
"keyword": "<string>",
"search_filter": "<string>",
"search_scope": [
"<string>"
],
"include_subdomains": true,
"match_type": "<string>"
}
]
}
],
"location_name": "<string>",
"location_code": 123,
"language_name": "<string>",
"language_code": "<string>",
"platform": "<string>",
"initial_dataset_filters": [
"<unknown>"
],
"internal_list_limit": 123,
"tag": "<string>"
}
]
'import requests
url = "https://api.aisa.one/apis/v1/dataforseo/ai_optimization/llm_mentions/cross_aggregated_metrics/live"
payload = [
{
"targets": [
{
"aggregation_key": "<string>",
"target": [
{
"domain": "<string>",
"keyword": "<string>",
"search_filter": "<string>",
"search_scope": ["<string>"],
"include_subdomains": True,
"match_type": "<string>"
}
]
}
],
"location_name": "<string>",
"location_code": 123,
"language_name": "<string>",
"language_code": "<string>",
"platform": "<string>",
"initial_dataset_filters": ["<unknown>"],
"internal_list_limit": 123,
"tag": "<string>"
}
]
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify([
{
targets: [
{
aggregation_key: '<string>',
target: [
{
domain: '<string>',
keyword: '<string>',
search_filter: '<string>',
search_scope: ['<string>'],
include_subdomains: true,
match_type: '<string>'
}
]
}
],
location_name: '<string>',
location_code: 123,
language_name: '<string>',
language_code: '<string>',
platform: '<string>',
initial_dataset_filters: ['<unknown>'],
internal_list_limit: 123,
tag: '<string>'
}
])
};
fetch('https://api.aisa.one/apis/v1/dataforseo/ai_optimization/llm_mentions/cross_aggregated_metrics/live', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.aisa.one/apis/v1/dataforseo/ai_optimization/llm_mentions/cross_aggregated_metrics/live",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
[
'targets' => [
[
'aggregation_key' => '<string>',
'target' => [
[
'domain' => '<string>',
'keyword' => '<string>',
'search_filter' => '<string>',
'search_scope' => [
'<string>'
],
'include_subdomains' => true,
'match_type' => '<string>'
]
]
]
],
'location_name' => '<string>',
'location_code' => 123,
'language_name' => '<string>',
'language_code' => '<string>',
'platform' => '<string>',
'initial_dataset_filters' => [
'<unknown>'
],
'internal_list_limit' => 123,
'tag' => '<string>'
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.aisa.one/apis/v1/dataforseo/ai_optimization/llm_mentions/cross_aggregated_metrics/live"
payload := strings.NewReader("[\n {\n \"targets\": [\n {\n \"aggregation_key\": \"<string>\",\n \"target\": [\n {\n \"domain\": \"<string>\",\n \"keyword\": \"<string>\",\n \"search_filter\": \"<string>\",\n \"search_scope\": [\n \"<string>\"\n ],\n \"include_subdomains\": true,\n \"match_type\": \"<string>\"\n }\n ]\n }\n ],\n \"location_name\": \"<string>\",\n \"location_code\": 123,\n \"language_name\": \"<string>\",\n \"language_code\": \"<string>\",\n \"platform\": \"<string>\",\n \"initial_dataset_filters\": [\n \"<unknown>\"\n ],\n \"internal_list_limit\": 123,\n \"tag\": \"<string>\"\n }\n]")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.aisa.one/apis/v1/dataforseo/ai_optimization/llm_mentions/cross_aggregated_metrics/live")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("[\n {\n \"targets\": [\n {\n \"aggregation_key\": \"<string>\",\n \"target\": [\n {\n \"domain\": \"<string>\",\n \"keyword\": \"<string>\",\n \"search_filter\": \"<string>\",\n \"search_scope\": [\n \"<string>\"\n ],\n \"include_subdomains\": true,\n \"match_type\": \"<string>\"\n }\n ]\n }\n ],\n \"location_name\": \"<string>\",\n \"location_code\": 123,\n \"language_name\": \"<string>\",\n \"language_code\": \"<string>\",\n \"platform\": \"<string>\",\n \"initial_dataset_filters\": [\n \"<unknown>\"\n ],\n \"internal_list_limit\": 123,\n \"tag\": \"<string>\"\n }\n]")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.aisa.one/apis/v1/dataforseo/ai_optimization/llm_mentions/cross_aggregated_metrics/live")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "[\n {\n \"targets\": [\n {\n \"aggregation_key\": \"<string>\",\n \"target\": [\n {\n \"domain\": \"<string>\",\n \"keyword\": \"<string>\",\n \"search_filter\": \"<string>\",\n \"search_scope\": [\n \"<string>\"\n ],\n \"include_subdomains\": true,\n \"match_type\": \"<string>\"\n }\n ]\n }\n ],\n \"location_name\": \"<string>\",\n \"location_code\": 123,\n \"language_name\": \"<string>\",\n \"language_code\": \"<string>\",\n \"platform\": \"<string>\",\n \"initial_dataset_filters\": [\n \"<unknown>\"\n ],\n \"internal_list_limit\": 123,\n \"tag\": \"<string>\"\n }\n]"
response = http.request(request)
puts response.read_body{
"version": "<string>",
"status_code": 123,
"status_message": "<string>",
"time": "<string>",
"cost": 123,
"tasks_count": 123,
"tasks_error": 123,
"tasks": [
"<string>"
],
"tasks.id": "<string>",
"tasks.status_code": 123,
"tasks.status_message": "<string>",
"tasks.time": "<string>",
"tasks.cost": 123,
"tasks.result_count": 123,
"tasks.path": [
"<string>"
],
"tasks.data": {},
"tasks.result": [
"<string>"
],
"tasks.result.total": {},
"tasks.result.total.location": [
"<string>"
],
"tasks.result.total.location.type": "<string>",
"tasks.result.total.location.key": "<string>",
"tasks.result.total.location.mentions": 123,
"tasks.result.total.location.ai_search_volume": 123,
"tasks.result.total.location.impressions": 123,
"tasks.result.total.language": [
"<string>"
],
"tasks.result.total.language.type": "<string>",
"tasks.result.total.language.key": "<string>",
"tasks.result.total.language.mentions": 123,
"tasks.result.total.language.ai_search_volume": 123,
"tasks.result.total.language.impressions": 123,
"tasks.result.total.platform": [
"<string>"
],
"tasks.result.total.platform.type": "<string>",
"tasks.result.total.platform.key": "<string>",
"tasks.result.total.platform.mentions": 123,
"tasks.result.total.platform.ai_search_volume": 123,
"tasks.result.total.platform.impressions": 123,
"tasks.result.total.sources_domain": [
"<string>"
],
"tasks.result.total.sources_domain.type": "<string>",
"tasks.result.total.sources_domain.key": "<string>",
"tasks.result.total.sources_domain.mentions": 123,
"tasks.result.total.sources_domain.ai_search_volume": 123,
"tasks.result.total.sources_domain.impressions": 123,
"tasks.result.total.search_results_domain": [
"<string>"
],
"tasks.result.total.search_results_domain.type": "<string>",
"tasks.result.total.search_results_domain.key": "<string>",
"tasks.result.total.search_results_domain.mentions": 123,
"tasks.result.total.search_results_domain.ai_search_volume": 123,
"tasks.result.total.search_results_domain.impressions": 123,
"tasks.result.total.brand_entities_title": [
"<string>"
],
"tasks.result.total.brand_entities_title.type": "<string>",
"tasks.result.total.brand_entities_title.key": "<string>",
"tasks.result.total.brand_entities_title.mentions": 123,
"tasks.result.total.brand_entities_title.ai_search_volume": 123,
"tasks.result.total.brand_entities_title.impressions": 123,
"tasks.result.total.brand_entities_category": [
"<string>"
],
"tasks.result.total.brand_entities_category.type": "<string>",
"tasks.result.total.brand_entities_category.key": "<string>",
"tasks.result.total.brand_entities_category.mentions": 123,
"tasks.result.total.brand_entities_category.ai_search_volume": 123,
"tasks.result.total.brand_entities_category.impressions": 123,
"tasks.result.items": [
"<string>"
],
"tasks.result.items.key": "<string>",
"tasks.result.items.location": [
"<string>"
],
"tasks.result.items.location.type": "<string>",
"tasks.result.items.location.key": "<string>",
"tasks.result.items.location.mentions": 123,
"tasks.result.items.location.ai_search_volume": 123,
"tasks.result.items.location.impressions": 123,
"tasks.result.items.language": [
"<string>"
],
"tasks.result.items.language.type": "<string>",
"tasks.result.items.language.key": "<string>",
"tasks.result.items.language.mentions": 123,
"tasks.result.items.language.ai_search_volume": 123,
"tasks.result.items.language.impressions": 123,
"tasks.result.items.platform": [
"<string>"
],
"tasks.result.items.platform.type": "<string>",
"tasks.result.items.platform.key": "<string>",
"tasks.result.items.platform.mentions": 123,
"tasks.result.items.platform.ai_search_volume": 123,
"tasks.result.items.platform.impressions": 123,
"tasks.result.items.sources_domain": [
"<string>"
],
"tasks.result.items.sources_domain.type": "<string>",
"tasks.result.items.sources_domain.key": "<string>",
"tasks.result.items.sources_domain.mentions": 123,
"tasks.result.items.sources_domain.ai_search_volume": 123,
"tasks.result.items.sources_domain.impressions": 123,
"tasks.result.items.search_results_domain": [
"<string>"
],
"tasks.result.items.search_results_domain.type": "<string>",
"tasks.result.items.search_results_domain.key": "<string>",
"tasks.result.items.search_results_domain.mentions": 123,
"tasks.result.items.search_results_domain.ai_search_volume": 123,
"tasks.result.items.search_results_domain.impressions": 123,
"tasks.result.items.brand_entities_title": [
"<string>"
],
"tasks.result.items.brand_entities_title.type": "<string>",
"tasks.result.items.brand_entities_title.key": "<string>",
"tasks.result.items.brand_entities_title.mentions": 123,
"tasks.result.items.brand_entities_title.ai_search_volume": 123,
"tasks.result.items.brand_entities_title.impressions": 123,
"tasks.result.items.brand_entities_category": [
"<string>"
],
"tasks.result.items.brand_entities_category.type": "<string>",
"tasks.result.items.brand_entities_category.key": "<string>",
"tasks.result.items.brand_entities_category.mentions": 123,
"tasks.result.items.brand_entities_category.ai_search_volume": 123,
"tasks.result.items.brand_entities_category.impressions": 123
}一次调用里跨多个目标比较提及指标，按
aggregation_key 分组。它收的是 targets（目标数组的数组），而不是兄弟接口的单个 target——两种结构不同，混用会被判未知字段。🔴 实测上游 $0.101，约为我们收费的八倍——本 provider 里最贵的一档。⚠️ target 是对象数组，每项形如 {"domain": "..."} 或 {"keyword": "..."}；传裸字符串会被判类型错，传字符串数组会报「Each target item must be an object」。过滤字段见 get_dataforseo_ai_llm_mentions_available_filters。 响应包在信封里：数据在 tasks[0].result，成败在 tasks[0].status_code——请求被拒时 HTTP 仍是 200。 对每个目标各调一次 post_dataforseo_ai_llm_mentions_aggregated_metrics_live 单价相同，所以只有当「比较」本身是目的时才用这个。
示例
curl -X POST "https://api.aisa.one/apis/v1/dataforseo/ai_optimization/llm_mentions/cross_aggregated_metrics/live" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '[{"targets": "...", "aggregation_key": "...", "target": "..."}]'
授权
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
请求体
application/json
包含带聚合键的目标实体的对象数组，必填字段。可以指定最多 10 组、但不少于 2 组目标参数，每组均包含其 aggregation_key；包含多个实体的 targets 数组示例：[{"aggregation_key":"bmw","target":[{"domain":"en.wikipedia.org","search_filter":"exclude"},{"keyword":"m5","match_type":"partial_match","search_scope":["answer"]}]},{"aggregation_key":"mercedes","target":[{"domain":"www.mercedes-benz.com","search_filter":"exclude"},{"keyword":"GLC","match_type":"word_match [blocked]"}]}]
Show child attributes
Show child attributes
搜索位置的完整名称，可选字段。如果使用此字段，则无需指定 location_code。如果未指定此字段，默认使用值为 2840 的 location_code；您可以单独向 https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages 发出请求，以获取搜索引擎可用位置及其 location_name 的列表。注意：chat_gpt 数据仅适用于 United States
搜索位置代码，可选字段。如果使用此字段，则无需指定 location_name。可通过向 https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages 单独发送请求，获取搜索引擎的可用位置及其 location_code。默认值：2840。注意：chat_gpt 数据仅适用于 2840
搜索语言的完整名称，可选字段；如果使用此字段，则无需指定 language_code；如果未指定此字段，将默认使用值为 en 的 language_code；你可以单独请求 https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages，以获取搜索引擎可用语言及其 language_name 的列表。注意：chat_gpt 数据仅支持英语
搜索语言代码，可选字段。如果使用此字段，则无需指定 language_name；可通过向 https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages 单独发送请求，获取搜索引擎的可用语言及其 language_code_by。默认值：en。注意：chat_gpt 数据仅适用于 en onlyn
目标平台。可选字段。可能的值：chat_gpt、google。默认值：google。注意：返回的数据取决于所选平台。注意 #2：chat_gpt 数据仅适用于美国和英语
聚合前应用的筛选表达式数组，可选字段。您可以使用此数组对聚合前的原始提及数据库应用筛选表达式，以限制参与结果计算的行；可以同时添加多个筛选条件（最多 8 个），条件之间应设置逻辑运算符 and、or。支持以下运算符：=, , in, not_in, like, not_like, ilike, not_ilike, match, not_match。可以将 % 运算符与 like 和 not_like 搭配使用，以匹配包含零个或多个字符的任意字符串。示例：["ai_search_volume",">","1000"]。可用筛选条件的完整列表请参见此处。有关初始数据集筛选条件的更多信息，请参阅此帮助中心文章。
内部数组中的最大元素数；可选字段。你可以使用此字段限制以下数组中的元素数量：sources_domain、search_results_domain。最小值：1；最大值：10；默认值：5。
用户定义的任务标识符。可选字段。字符数限制为 255。您可以使用此参数标识任务并将其与结果匹配；您将在响应的 data 对象中找到指定的 tag 值
响应
成功响应
API 的当前版本
通用状态码；您可以在此处查看完整的响应码列表。注意：我们强烈建议设计必要的系统来处理相关异常或错误情况
常规信息消息；可在此处查看常规信息消息的完整列表
执行时间（秒）
任务总成本（美元）
tasks 数组中的任务数量
返回错误的 tasks 数组中的任务数量
任务数组
任务标识符，系统中采用 UUID 格式的唯一任务标识符
DataForSEO 生成的任务状态码；范围为：10000-60000；完整响应代码列表可在此处查看
任务的信息性消息，你可以在此处查看通用信息性消息的完整列表
执行时间（秒）
任务成本（美元）
结果数组中的元素数量
URL 路径
包含您在 POST 请求中指定的相同参数
结果数组
汇总提及指标摘要，包含在所有已发现域名中汇总的整体 LLM 提及指标，并按多个维度分组。
基于位置的分组对象数组，包含按地理位置细分的提及指标
元素类型 = 'group_element'
分组标识符，即分组维度的具体标识符
LLM 提及总次数，即目标关键词或域名与此特定分组键相关联时被提及的次数
关键词当前的 AI 搜索量比率；在此处了解有关此指标的更多信息
关键词当前的 AI 展示率
按语言分组的对象数组，包含按内容语言细分的提及指标
元素类型 = 'group_element'
分组标识符，即分组维度的具体标识符
LLM 提及总次数，即目标关键词或域名与此特定分组键相关联时被提及的次数
关键词当前的 AI 搜索量比率；在此处了解有关此指标的更多信息
关键词当前的 AI 展示率
按平台分组的数组，包含按 AI 平台细分的提及指标分组元素
元素类型 = 'group_element'
分组标识符，即分组维度的具体标识符
LLM 提及总次数，即目标关键词或域名与此特定分组键相关联时被提及的次数
关键词当前的 AI 搜索量比率；在此处了解有关此指标的更多信息
关键词当前的 AI 展示率
找到与目标相关的主要来源域名；对象数组，包含在 LLM 响应中被引用为来源的主要域名数据。
元素类型 = 'group_element'
分组标识符，即分组维度的特定标识符；在此情况下，该字段显示找到的域名
LLM 提及总次数，即目标关键词或域名与特定域名相关联时被提及的次数
关键词当前的 AI 搜索量比率；在此处了解有关此指标的更多信息
关键词当前的 AI 展示率
找到与目标相关的热门搜索结果域名。对象数组，包含与 LLM 查询相关的搜索结果中出现的热门域名数据
元素类型 = 'group_element'
分组标识符，即分组维度的特定标识符；在此情况下，该字段显示找到的域名
LLM 提及总次数，即目标关键词或域名与特定域名相关联时被提及的次数
关键词当前的 AI 搜索量比率；在此处了解有关此指标的更多信息
关键词当前的 AI 展示率
与目标相关的品牌实体数据；对象数组，包含与 LLM 查询相关的搜索结果中出现的品牌实体标题数据
元素类型 = 'group_element'
分组标识符；分组维度的具体标识符；在此情况下，该字段显示找到的品牌实体标题
LLM 提及总次数，即目标关键词或域名与特定域名相关联时被提及的次数
关键词当前的 AI 搜索量比率；在此处了解有关此指标的更多信息
关键词当前的 AI 展示率
与目标相关的品牌实体数据；对象数组，包含与 LLM 查询相关的搜索结果中出现的品牌实体类别数据。
元素类型 = 'group_element'
分组标识符，即分组维度的特定标识符；在本例中，该字段显示找到的品牌实体类别
LLM 提及总次数，即目标关键词或域名与特定域名相关联时被提及的次数
关键词当前的 AI 搜索量比率；在此处了解有关此指标的更多信息
关键词当前的 AI 展示率
包含相关提及数据
在 POST 数组中接收的聚合键
基于位置的分组对象数组，包含按地理位置细分的提及指标
元素类型 = 'group_element'
分组标识符，即分组维度的具体标识符
LLM 提及总次数，即目标关键词或域名与此特定分组键相关联时被提及的次数
关键词当前的 AI 搜索量比率；在此处了解有关此指标的更多信息
关键词当前的 AI 展示率
按语言分组的对象数组，包含按内容语言细分的提及指标
元素类型 = 'group_element'
分组标识符，即分组维度的具体标识符
LLM 提及总次数，即目标关键词或域名与此特定分组键相关联时被提及的次数
关键词当前的 AI 搜索量比率；在此处了解有关此指标的更多信息
关键词当前的 AI 展示率
按平台分组的数组，包含按 AI 平台细分的提及指标分组元素
元素类型 = 'group_element'
分组标识符，即分组维度的具体标识符
LLM 提及总次数，即目标关键词或域名与此特定分组键相关联时被提及的次数
关键词当前的 AI 搜索量比率；在此处了解有关此指标的更多信息
关键词当前的 AI 展示率
找到与目标相关的主要来源域名；对象数组，包含在 LLM 响应中被引用为来源的主要域名数据。
元素类型 = 'group_element'
分组标识符，即分组维度的特定标识符；在此情况下，该字段显示找到的域名
LLM 提及总次数，即目标关键词或域名与特定域名相关联时被提及的次数
关键词当前的 AI 搜索量比率；在此处了解有关此指标的更多信息
关键词当前的 AI 展示率
找到与目标相关的热门搜索结果域名。对象数组，包含与 LLM 查询相关的搜索结果中出现的热门域名数据
元素类型 = 'group_element'
分组标识符，即分组维度的特定标识符；在此情况下，该字段显示找到的域名
LLM 提及总次数，即目标关键词或域名与特定域名相关联时被提及的次数
关键词当前的 AI 搜索量比率；在此处了解有关此指标的更多信息
关键词当前的 AI 展示率
与目标相关的品牌实体数据；对象数组，包含与 LLM 查询相关的搜索结果中出现的品牌实体标题数据
元素类型 = 'group_element'
分组标识符；分组维度的具体标识符；在此情况下，该字段显示找到的品牌实体标题
LLM 提及总次数，即目标关键词或域名与特定域名相关联时被提及的次数
关键词当前的 AI 搜索量比率；在此处了解有关此指标的更多信息
关键词当前的 AI 展示率
与目标相关的品牌实体数据；对象数组，包含与 LLM 查询相关的搜索结果中出现的品牌实体类别数据。
元素类型 = 'group_element'
分组标识符，即分组维度的特定标识符；在本例中，该字段显示找到的品牌实体类别
LLM 提及总次数，即目标关键词或域名与特定域名相关联时被提及的次数
关键词当前的 AI 搜索量比率；在此处了解有关此指标的更多信息
关键词当前的 AI 展示率