跳转到主要内容
POST
搜索竞争对手

搜索竞争对手

看清你在 Google 上真正的对手是谁。每个竞争域名显示与目标共同拥有排名的关键词数、在这些关键词上的平均排名和从中获得的流量,以及它完整的自然搜索和付费搜索数据。名单里常会出现意料之外的对手,所以特别适合做内容缺口分析、定位梳理和市场版图研究。
通过 target 提供域名。选择支持的国家,以及该国家可用的语言;默认美国(2840)和英语(en)。results_limit 默认 100,可填 1–1000 之间的整数。每个竞争对手计 0.1 积分,每次请求最低 3 积分。

标准结果字段

任务结果使用下方稳定的 SocQ 字段。系统会统一来源特有的字段名和格式,但不会推断或补充来源未提供的数据。如需缩小返回字段集合,MCP 查询使用 fields,Typed 工具使用 _result_fields,CLI 使用 --result-fields。声明字段的值为 null 时仍会保留。 以下示例展示任务完成后的响应格式,具体数据以实际查询结果为准。

任务完成响应

授权

Authorization
string
header
必填

使用 Authorization: Bearer <token> 请求头进行身份验证。

请求体

application/json

通过 target 提供域名。选择支持的国家,以及该国家可用的语言;默认美国(2840)和英语(en)。results_limit 默认 100,可填 1–1000 之间的整数。每个竞争对手计 0.1 积分,每次请求最低 3 积分。

target
string
必填

域名或子域名,例如 example.com。

Minimum string length: 1
callback_url
string<uri>

可选的任务完成回调 URL。

language
enum<string>

语言代码或语言筛选条件。

可用选项:
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
language_code
enum<string>
默认值:en

语言代码,需为所选国家可用的语言;默认 en。

可用选项:
ar,
az,
bg,
bn,
bs,
cs,
da,
de,
el,
en,
es,
et,
fi,
fr,
he,
hi,
hr,
hu,
hy,
id,
it,
ja,
ko,
lt,
lv,
mk,
ms,
nb,
nl,
pl,
pt,
ro,
ru,
sk,
sl,
sq,
sr,
sv,
th,
tl,
tr,
uk,
ur,
vi,
zh-CN,
zh-TW
Required string length: 2 - 10
location_code
enum<integer>
默认值:2840

国家代码,填写本接口支持的国家;与 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_name
enum<string>

国家名称,填写本接口支持的国家;与 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
results_limit
integer
默认值:100

最多保存的结果数,实际结果可能少于该值。

必填范围: 1 <= x <= 1000

响应

任务已受理

code
integer

HTTP 业务状态码。

data
object