跳转到主要内容
POST
域名概览

域名概览

用一行数据看清一个域名在某个市场的 Google 搜索盘面。自然搜索和付费搜索各自给出有排名的关键词数、预估月流量、这些流量换成广告要花多少钱、第 1 到 100 名各排名区间的关键词数,以及自上次更新以来新增、上升、下降和掉出排名的数量。可以用来估算竞品体量、按月跟踪自己的可见度,或者按搜索表现筛选潜在客户。
通过 target 提供域名。选择支持的国家,以及该国家可用的语言;默认美国(2840)和英语(en)。每次请求计 5 积分,返回一行。

标准结果字段

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

任务完成响应

授权

Authorization
string
header
必填

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

请求体

application/json

通过 target 提供域名。选择支持的国家,以及该国家可用的语言;默认美国(2840)和英语(en)。每次请求计 5 积分,返回一行。

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

响应

任务已受理

code
integer

HTTP 业务状态码。

data
object