域名概览
curl --request POST \
--url https://api.socq.ai/v1/seo/domain-overview \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"target": "<string>",
"callback_url": "<string>",
"language_code": "en",
"location_code": 2840
}
'import requests
url = "https://api.socq.ai/v1/seo/domain-overview"
payload = {
"target": "<string>",
"callback_url": "<string>",
"language_code": "en",
"location_code": 2840
}
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({
target: '<string>',
callback_url: '<string>',
language_code: 'en',
location_code: 2840
})
};
fetch('https://api.socq.ai/v1/seo/domain-overview', 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.socq.ai/v1/seo/domain-overview",
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([
'target' => '<string>',
'callback_url' => '<string>',
'language_code' => 'en',
'location_code' => 2840
]),
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.socq.ai/v1/seo/domain-overview"
payload := strings.NewReader("{\n \"target\": \"<string>\",\n \"callback_url\": \"<string>\",\n \"language_code\": \"en\",\n \"location_code\": 2840\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.socq.ai/v1/seo/domain-overview")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"target\": \"<string>\",\n \"callback_url\": \"<string>\",\n \"language_code\": \"en\",\n \"location_code\": 2840\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.socq.ai/v1/seo/domain-overview")
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 \"target\": \"<string>\",\n \"callback_url\": \"<string>\",\n \"language_code\": \"en\",\n \"location_code\": 2840\n}"
response = http.request(request)
puts response.read_body{
"code": 200,
"data": {
"task_id": "<string>",
"status": "<string>",
"created_time": "<string>"
}
}{
"code": 422,
"error": {
"message": "<string>",
"type": "<string>",
"details": {}
}
}SEO
域名概览
获取域名在 Google 自然搜索和付费搜索中的整体数据。
POST
/
v1
/
seo
/
domain-overview
域名概览
curl --request POST \
--url https://api.socq.ai/v1/seo/domain-overview \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"target": "<string>",
"callback_url": "<string>",
"language_code": "en",
"location_code": 2840
}
'import requests
url = "https://api.socq.ai/v1/seo/domain-overview"
payload = {
"target": "<string>",
"callback_url": "<string>",
"language_code": "en",
"location_code": 2840
}
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({
target: '<string>',
callback_url: '<string>',
language_code: 'en',
location_code: 2840
})
};
fetch('https://api.socq.ai/v1/seo/domain-overview', 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.socq.ai/v1/seo/domain-overview",
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([
'target' => '<string>',
'callback_url' => '<string>',
'language_code' => 'en',
'location_code' => 2840
]),
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.socq.ai/v1/seo/domain-overview"
payload := strings.NewReader("{\n \"target\": \"<string>\",\n \"callback_url\": \"<string>\",\n \"language_code\": \"en\",\n \"location_code\": 2840\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.socq.ai/v1/seo/domain-overview")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"target\": \"<string>\",\n \"callback_url\": \"<string>\",\n \"language_code\": \"en\",\n \"location_code\": 2840\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.socq.ai/v1/seo/domain-overview")
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 \"target\": \"<string>\",\n \"callback_url\": \"<string>\",\n \"language_code\": \"en\",\n \"location_code\": 2840\n}"
response = http.request(request)
puts response.read_body{
"code": 200,
"data": {
"task_id": "<string>",
"status": "<string>",
"created_time": "<string>"
}
}{
"code": 422,
"error": {
"message": "<string>",
"type": "<string>",
"details": {}
}
}域名概览
用一行数据看清一个域名在某个市场的 Google 搜索盘面。自然搜索和付费搜索各自给出有排名的关键词数、预估月流量、这些流量换成广告要花多少钱、第 1 到 100 名各排名区间的关键词数,以及自上次更新以来新增、上升、下降和掉出排名的数量。可以用来估算竞品体量、按月跟踪自己的可见度,或者按搜索表现筛选潜在客户。{
"target": "notion.so",
"location_code": 2840,
"language_code": "en"
}
标准结果字段
任务结果使用下方稳定的 SocQ 字段。系统会统一来源特有的字段名和格式,但不会推断或补充来源未提供的数据。如需缩小返回字段集合,MCP 查询使用fields,Typed 工具使用 _result_fields,CLI 使用 --result-fields。声明字段的值为 null 时仍会保留。
| 字段 | 类型 | 可空 | 说明 |
|---|---|---|---|
id | string | 是 | 被分析的域名,作为标识。 |
platform | string | 否 | 结果所属的平台,例如 instagram 或 linkedin。 |
resource | string | 否 | 该结果对应的 SocQ 资源,例如 videos 或 comments。 |
type | string | 否 | 结果项的类别,例如 video、post 或 comment。 |
url | string | 是 | 该域名的首页地址。 |
published_at | string | 是 | 源内容的发布时间(如可获得),使用 ISO 8601 格式。 |
collected_at | string | 否 | SocQ 采集或处理该结果的时间,使用 ISO 8601 格式。 |
domain | string | 是 | 被分析的域名。 |
location_code | integer | 是 | 搜索市场的地区代码。 |
language_code | string | 是 | 搜索市场的语言代码。 |
organic | object | 是 | 该域名在所选市场的自然搜索汇总。 |
organic.keywords_count | integer | 是 | 该域名在自然结果中有排名的关键词数量。 |
organic.estimated_traffic | number | 是 | 来自自然结果的预估月访问量。 |
organic.estimated_traffic_cost | number | 是 | 以 Google Ads 购买这部分自然流量的预估月成本,单位美元。 |
organic.positions | object | 是 | 各排名区间内的关键词数量。 |
organic.positions.pos_1 | integer | 是 | 排在第 1 名的关键词数量。 |
organic.positions.pos_2_3 | integer | 是 | 排在第 2–3 名的关键词数量。 |
organic.positions.pos_4_10 | integer | 是 | 排在第 4–10 名的关键词数量。 |
organic.positions.pos_11_20 | integer | 是 | 排在第 11–20 名的关键词数量。 |
organic.positions.pos_21_30 | integer | 是 | 排在第 21–30 名的关键词数量。 |
organic.positions.pos_31_40 | integer | 是 | 排在第 31–40 名的关键词数量。 |
organic.positions.pos_41_50 | integer | 是 | 排在第 41–50 名的关键词数量。 |
organic.positions.pos_51_60 | integer | 是 | 排在第 51–60 名的关键词数量。 |
organic.positions.pos_61_70 | integer | 是 | 排在第 61–70 名的关键词数量。 |
organic.positions.pos_71_80 | integer | 是 | 排在第 71–80 名的关键词数量。 |
organic.positions.pos_81_90 | integer | 是 | 排在第 81–90 名的关键词数量。 |
organic.positions.pos_91_100 | integer | 是 | 排在第 91–100 名的关键词数量。 |
organic.new_count | integer | 是 | 自上次更新以来新进入排名的关键词数量。 |
organic.up_count | integer | 是 | 自上次更新以来排名上升的关键词数量。 |
organic.down_count | integer | 是 | 自上次更新以来排名下降的关键词数量。 |
organic.lost_count | integer | 是 | 自上次更新以来掉出排名的关键词数量。 |
paid | object | 是 | 该域名在所选市场的付费搜索汇总。 |
paid.keywords_count | integer | 是 | 该域名在付费结果中有排名的关键词数量。 |
paid.estimated_traffic | number | 是 | 来自付费结果的预估月访问量。 |
paid.estimated_traffic_cost | number | 是 | 以 Google Ads 购买这部分付费流量的预估月成本,单位美元。 |
paid.positions | object | 是 | 各排名区间内的关键词数量。 |
paid.positions.pos_1 | integer | 是 | 排在第 1 名的关键词数量。 |
paid.positions.pos_2_3 | integer | 是 | 排在第 2–3 名的关键词数量。 |
paid.positions.pos_4_10 | integer | 是 | 排在第 4–10 名的关键词数量。 |
paid.positions.pos_11_20 | integer | 是 | 排在第 11–20 名的关键词数量。 |
paid.positions.pos_21_30 | integer | 是 | 排在第 21–30 名的关键词数量。 |
paid.positions.pos_31_40 | integer | 是 | 排在第 31–40 名的关键词数量。 |
paid.positions.pos_41_50 | integer | 是 | 排在第 41–50 名的关键词数量。 |
paid.positions.pos_51_60 | integer | 是 | 排在第 51–60 名的关键词数量。 |
paid.positions.pos_61_70 | integer | 是 | 排在第 61–70 名的关键词数量。 |
paid.positions.pos_71_80 | integer | 是 | 排在第 71–80 名的关键词数量。 |
paid.positions.pos_81_90 | integer | 是 | 排在第 81–90 名的关键词数量。 |
paid.positions.pos_91_100 | integer | 是 | 排在第 91–100 名的关键词数量。 |
paid.new_count | integer | 是 | 自上次更新以来新进入排名的关键词数量。 |
paid.up_count | integer | 是 | 自上次更新以来排名上升的关键词数量。 |
paid.down_count | integer | 是 | 自上次更新以来排名下降的关键词数量。 |
paid.lost_count | integer | 是 | 自上次更新以来掉出排名的关键词数量。 |
任务完成响应
{
"code": 200,
"data": {
"task_id": "example-seo-domain-overview",
"status": "succeeded",
"public_id": "seo/domain-overview",
"result_count": 1,
"credits_amount": 5,
"results": {
"limit": 50,
"next_cursor": null,
"has_more": false,
"schema_id": "domain-overview",
"schema_version": "1.0",
"items": [
{
"id": "notion.so",
"platform": "seo",
"resource": "domain-overview",
"type": "domain-overview",
"url": "https://notion.so",
"published_at": null,
"collected_at": "2026-11-17T14:43:24.700503Z",
"domain": "notion.so",
"location_code": 2840,
"language_code": "en",
"organic": {
"keywords_count": 399,
"estimated_traffic": 13302.66677077845,
"estimated_traffic_cost": 53088.47256860725,
"positions": {
"pos_1": 13,
"pos_2_3": 24,
"pos_4_10": 73,
"pos_11_20": 57,
"pos_21_30": 69,
"pos_31_40": 83,
"pos_41_50": 47,
"pos_51_60": 15,
"pos_61_70": 7,
"pos_71_80": 4,
"pos_81_90": 6,
"pos_91_100": 1
},
"new_count": 233,
"up_count": 51,
"down_count": 83,
"lost_count": 637
},
"paid": {
"keywords_count": 0,
"estimated_traffic": 0.0,
"estimated_traffic_cost": 0.0,
"positions": {
"pos_1": 0,
"pos_2_3": 0,
"pos_4_10": 0,
"pos_11_20": 0,
"pos_21_30": 0,
"pos_31_40": 0,
"pos_41_50": 0,
"pos_51_60": 0,
"pos_61_70": 0,
"pos_71_80": 0,
"pos_81_90": 0,
"pos_91_100": 0
},
"new_count": 0,
"up_count": 0,
"down_count": 0,
"lost_count": 0
}
}
]
}
}
}
请求体
application/json
通过 target 提供域名。选择支持的国家,以及该国家可用的语言;默认美国(2840)和英语(en)。每次请求计 5 积分,返回一行。
语言代码或语言筛选条件。
可用选项:
Albanian, Arabic, Armenian, Azeri, Bengali, Bosnian, Bulgarian, Chinese (Simplified), Chinese (Traditional), Croatian, Czech, Danish, Dutch, English, Estonian, Finnish, French, German, Greek, Hebrew, Hindi, Hungarian, Indonesian, Italian, Japanese, Korean, Latvian, Lithuanian, Macedonian, Malay, Norwegian (Bokmål), Polish, Portuguese, Romanian, Russian, Serbian, Slovak, Slovenian, Spanish, Swedish, Tagalog, Thai, Turkish, Ukrainian, Urdu, Vietnamese Minimum string length:
1国家代码,填写本接口支持的国家;与 location_name 二选一。
可用选项:
2008, 2012, 2024, 2031, 2032, 2036, 2040, 2048, 2050, 2051, 2056, 2068, 2070, 2076, 2100, 2104, 2116, 2120, 2124, 2144, 2152, 2158, 2170, 2188, 2191, 2196, 2203, 2208, 2218, 2222, 2233, 2246, 2250, 2276, 2288, 2300, 2320, 2344, 2348, 2356, 2360, 2372, 2376, 2380, 2384, 2392, 2398, 2400, 2404, 2410, 2428, 2440, 2458, 2470, 2484, 2492, 2498, 2504, 2528, 2554, 2558, 2566, 2578, 2586, 2591, 2600, 2604, 2608, 2616, 2620, 2642, 2682, 2686, 2688, 2702, 2703, 2704, 2705, 2710, 2724, 2752, 2756, 2764, 2784, 2788, 2792, 2804, 2807, 2818, 2826, 2840, 2854, 2858, 2862 必填范围:
x >= 1国家名称,填写本接口支持的国家;与 location_code 二选一。
可用选项:
Albania, Algeria, Angola, Argentina, Armenia, Australia, Austria, Azerbaijan, Bahrain, Bangladesh, Belgium, Bolivia, Bosnia and Herzegovina, Brazil, Bulgaria, Burkina Faso, Cambodia, Cameroon, Canada, Chile, Colombia, Costa Rica, Cote d'Ivoire, Croatia, Cyprus, Czechia, Denmark, Ecuador, Egypt, El Salvador, Estonia, Finland, France, Germany, Ghana, Greece, Guatemala, Hong Kong, Hungary, India, Indonesia, Ireland, Israel, Italy, Japan, Jordan, Kazakhstan, Kenya, Latvia, Lithuania, Malaysia, Malta, Mexico, Moldova, Monaco, Morocco, Myanmar (Burma), Netherlands, New Zealand, Nicaragua, Nigeria, North Macedonia, Norway, Pakistan, Panama, Paraguay, Peru, Philippines, Poland, Portugal, Romania, Saudi Arabia, Senegal, Serbia, Singapore, Slovakia, Slovenia, South Africa, South Korea, Spain, Sri Lanka, Sweden, Switzerland, Taiwan, Thailand, Tunisia, Turkiye, Ukraine, United Arab Emirates, United Kingdom, United States, Uruguay, Venezuela, Vietnam Minimum string length:
1
