搜索竞争对手
curl --request POST \
--url https://api.socq.ai/v1/seo/competitor-domains \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"target": "<string>",
"callback_url": "<string>",
"language_code": "en",
"location_code": 2840,
"results_limit": 100
}
'import requests
url = "https://api.socq.ai/v1/seo/competitor-domains"
payload = {
"target": "<string>",
"callback_url": "<string>",
"language_code": "en",
"location_code": 2840,
"results_limit": 100
}
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,
results_limit: 100
})
};
fetch('https://api.socq.ai/v1/seo/competitor-domains', 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/competitor-domains",
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,
'results_limit' => 100
]),
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/competitor-domains"
payload := strings.NewReader("{\n \"target\": \"<string>\",\n \"callback_url\": \"<string>\",\n \"language_code\": \"en\",\n \"location_code\": 2840,\n \"results_limit\": 100\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/competitor-domains")
.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 \"results_limit\": 100\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.socq.ai/v1/seo/competitor-domains")
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 \"results_limit\": 100\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
/
competitor-domains
搜索竞争对手
curl --request POST \
--url https://api.socq.ai/v1/seo/competitor-domains \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"target": "<string>",
"callback_url": "<string>",
"language_code": "en",
"location_code": 2840,
"results_limit": 100
}
'import requests
url = "https://api.socq.ai/v1/seo/competitor-domains"
payload = {
"target": "<string>",
"callback_url": "<string>",
"language_code": "en",
"location_code": 2840,
"results_limit": 100
}
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,
results_limit: 100
})
};
fetch('https://api.socq.ai/v1/seo/competitor-domains', 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/competitor-domains",
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,
'results_limit' => 100
]),
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/competitor-domains"
payload := strings.NewReader("{\n \"target\": \"<string>\",\n \"callback_url\": \"<string>\",\n \"language_code\": \"en\",\n \"location_code\": 2840,\n \"results_limit\": 100\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/competitor-domains")
.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 \"results_limit\": 100\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.socq.ai/v1/seo/competitor-domains")
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 \"results_limit\": 100\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 上真正的对手是谁。每个竞争域名显示与目标共同拥有排名的关键词数、在这些关键词上的平均排名和从中获得的流量,以及它完整的自然搜索和付费搜索数据。名单里常会出现意料之外的对手,所以特别适合做内容缺口分析、定位梳理和市场版图研究。{
"target": "notion.so",
"location_code": 2840,
"language_code": "en",
"results_limit": 100
}
标准结果字段
任务结果使用下方稳定的 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 | 是 | 在搜索结果中与目标竞争的域名。 |
shared_keywords_count | integer | 是 | 两个域名都有排名的关键词数量。 |
avg_position | number | 是 | 该域名在共同关键词上的平均排名。 |
shared_keywords_traffic | number | 是 | 该域名从共同关键词获得的预估月访问量。 |
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-competitor-domains",
"status": "succeeded",
"public_id": "seo/competitor-domains",
"result_count": 1,
"credits_amount": 3,
"results": {
"limit": 50,
"next_cursor": null,
"has_more": false,
"schema_id": "competitor-domain",
"schema_version": "1.0",
"items": [
{
"id": "youtube.com",
"platform": "seo",
"resource": "competitor-domains",
"type": "competitor-domain",
"url": "https://youtube.com",
"published_at": null,
"collected_at": "2026-11-17T14:43:26.285288Z",
"domain": "youtube.com",
"shared_keywords_count": 380,
"avg_position": 11.478947368421053,
"shared_keywords_traffic": 12498.604813288752,
"organic": {
"keywords_count": 138006473,
"estimated_traffic": 495758054.7955549,
"estimated_traffic_cost": 703070590.7183849,
"positions": {
"pos_1": 4628738,
"pos_2_3": 8167515,
"pos_4_10": 48997587,
"pos_11_20": 42162585,
"pos_21_30": 17162419,
"pos_31_40": 8090076,
"pos_41_50": 4338443,
"pos_51_60": 2336598,
"pos_61_70": 1226081,
"pos_71_80": 566127,
"pos_81_90": 241874,
"pos_91_100": 88430
},
"new_count": 99533270,
"up_count": 14641729,
"down_count": 17490892,
"lost_count": 94509210
},
"paid": {
"keywords_count": 5,
"estimated_traffic": 283.70113706588745,
"estimated_traffic_cost": 2423.7411708831787,
"positions": {
"pos_1": 3,
"pos_2_3": 2,
"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": 5,
"up_count": 0,
"down_count": 0,
"lost_count": 7
}
}
]
}
}
}
请求体
application/json
通过 target 提供域名。选择支持的国家,以及该国家可用的语言;默认美国(2840)和英语(en)。results_limit 默认 100,可填 1–1000 之间的整数。每个竞争对手计 0.1 积分,每次请求最低 3 积分。
语言代码或语言筛选条件。
可用选项:
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
