跳转到主要内容
POST
流量估算

流量估算

一次调用估算一批网站的搜索流量。最多传入 1000 个域名,每个域名返回来自自然搜索的预估月访问量和有排名的关键词数,以及付费搜索对应的两项数据。可以用来按体量给潜在客户或合作方排序、补充 CRM 数据,或者一次性对比整个品类的竞争对手。
通过 targets 提供最多 1000 个域名。选择支持的国家,以及该国家可用的语言;默认美国(2840)和英语(en)。每个域名返回一行。每次请求计 3 积分,每个域名再加 0.1 积分。

标准结果字段

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

任务完成响应

授权

Authorization
string
header
必填

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

请求体

application/json

通过 targets 提供最多 1000 个域名。选择支持的国家,以及该国家可用的语言;默认美国(2840)和英语(en)。每个域名返回一行。每次请求计 3 积分,每个域名再加 0.1 积分。

targets
string[]
必填

要估算流量的域名,例如 example.com,至少提供 1 项,最多提供 1000 项。

Required array length: 1 - 1000 elements
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