网页搜索 · Search API

了解 Dataify 的 Search API 参数。

`unique_id`（必填）：

该参数定义了使用什么工具。

参数	名称	作用
unique_id	API	用于指定使用的工具，可选值：search_web、search_news、search_shopping、search_scholar、extract、map

`query`（必填）：

该参数定义了需要搜索的关键词或查询内容。

参数	名称	作用
query	搜索词	用于指定需要搜索的关键词或查询内容，长度为 1～256 个字符。

`source`（选填）：

该参数用于设置采集结果所属的类型。

参数	名称	作用
source	结果类型	用于设置搜索结果的类型。可选值：web（网页搜索）、news（新闻搜索）、shopping（购物搜索）、scholar（学术搜索）。默认值为 web。

`max_results`（选填）：

该参数用于设置搜索结果的最大数量。

参数	名称	作用
max_results	结果数量	用于设置返回搜索结果的最大数量，取值范围为 1～100。默认值为 10。

`time_range`（选填）：

该参数用于限制搜索结果的时间范围。

参数	名称	作用
time_range	结果时间范围	用于筛选指定时间范围内的搜索结果。可选值：hour（过去 1 小时内）、day（过去 24 小时内）、week（过去 1 周内）、month（过去 1 个月内）、year（过去 1 年内）。未选择时表示不限时间。shopping 和 scholar 类型不支持该参数。

`country`（选填）：

该参数用于设置搜索结果对应的国家或地区。

参数	名称	作用
country	结果来源国家	用于设置搜索结果对应的国家或地区，使用两位小写国家代码。默认值为 us。scholar 类型不支持该参数。

国家参数值对应表

value	name
ad	安道尔
ae	阿拉伯联合酋长国
af	阿富汗
ag	安提瓜和巴布达
ai	安圭拉
al	阿尔巴尼亚
am	亚美尼亚
an	库拉索
ao	安哥拉
aq	南极洲
ar	阿根廷
as	美属萨摩亚
at	奥地利
au	澳大利亚
aw	阿鲁巴
az	阿塞拜疆
ba	波斯尼亚和黑塞哥维那
bb	巴巴多斯
bd	孟加拉国
be	比利时
bf	布基纳法索
bg	保加利亚
bh	巴林
bi	布隆迪
bj	贝宁
bm	百慕大
bn	文莱
bo	玻利维亚
br	巴西
bs	巴哈马
bt	不丹
bv	布韦岛
bw	博茨瓦纳
by	白俄罗斯
bz	伯利兹
ca	加拿大
cc	科科斯（基林）群岛
cd	刚果（金）
cf	中非共和国
cg	刚果（布）
ch	瑞士
ci	科特迪瓦
ck	库克群岛
cl	智利
cm	喀麦隆
cn	中国
co	哥伦比亚
cr	哥斯达黎加
cu	古巴
cv	佛得角
cx	圣诞岛
cy	塞浦路斯
cz	捷克
de	德国
dj	吉布提
dk	丹麦
dm	多米尼克
do	多米尼加共和国
dz	阿尔及利亚
ec	厄瓜多尔
ee	爱沙尼亚
eg	埃及
eh	西撒哈拉
er	厄立特里亚
es	西班牙
et	埃塞俄比亚
fi	芬兰
fj	斐济
fk	福克兰群岛
fm	密克罗尼西亚
fo	法罗群岛
fr	法国
ga	加蓬
gb	英国
gd	格林纳达
ge	格鲁吉亚
gf	法属圭亚那
gh	加纳
gi	直布罗陀
gl	格陵兰
gm	冈比亚
gn	几内亚
gp	瓜德罗普
gq	赤道几内亚
gr	希腊
gs	南乔治亚和南桑威奇群岛
gt	危地马拉
gu	关岛
gw	几内亚比绍
gy	圭亚那
hk	中国香港特别行政区
hm	赫德岛和麦克唐纳群岛
hn	洪都拉斯
hr	克罗地亚
ht	海地
hu	匈牙利
id	印度尼西亚
ie	爱尔兰
il	以色列
in	印度
io	英属印度洋领地
iq	伊拉克
ir	伊朗
is	冰岛
it	意大利
jm	牙买加
jo	约旦
jp	日本
ke	肯尼亚
kg	吉尔吉斯斯坦
kh	柬埔寨
ki	基里巴斯
km	科摩罗
kn	圣基茨和尼维斯
kp	朝鲜
kr	韩国
kw	科威特
ky	开曼群岛
kz	哈萨克斯坦
la	老挝
lb	黎巴嫩
lc	圣卢西亚
li	列支敦士登
lk	斯里兰卡
lr	利比里亚
ls	莱索托
lt	立陶宛
lu	卢森堡
lv	拉脱维亚
ly	利比亚
ma	摩洛哥
mc	摩纳哥
md	摩尔多瓦
mg	马达加斯加
mh	马绍尔群岛
mk	北马其顿
ml	马里
mm	缅甸
mn	蒙古
mo	中国澳门特别行政区
mp	北马里亚纳群岛
mq	马提尼克
mr	毛里塔尼亚
ms	蒙特塞拉特
mt	马耳他
mu	毛里求斯
mv	马尔代夫
mw	马拉维
mx	墨西哥
my	马来西亚
mz	莫桑比克
na	纳米比亚
nc	新喀里多尼亚
ne	尼日尔
nf	诺福克岛
ng	尼日利亚
ni	尼加拉瓜
nl	荷兰
no	挪威
np	尼泊尔
nr	瑙鲁
nu	纽埃
nz	新西兰
om	阿曼
pa	巴拿马
pe	秘鲁
pf	法属波利尼西亚
pg	巴布亚新几内亚
ph	菲律宾
pk	巴基斯坦
pl	波兰
pm	圣皮埃尔和密克隆群岛
pn	皮特凯恩群岛
pr	波多黎各
ps	巴勒斯坦领土
pt	葡萄牙
pw	帕劳
py	巴拉圭
qa	卡塔尔
re	留尼汪
ro	罗马尼亚
rs	塞尔维亚
ru	俄罗斯
rw	卢旺达
sa	沙特阿拉伯
sb	所罗门群岛
sc	塞舌尔
sd	苏丹
se	瑞典
sg	新加坡
sh	圣赫勒拿
si	斯洛文尼亚
sj	斯瓦尔巴和扬马延
sk	斯洛伐克
sl	塞拉利昂
sm	圣马力诺
sn	塞内加尔
so	索马里
sr	苏里南
st	圣多美和普林西比
sv	萨尔瓦多
sy	叙利亚
sz	斯威士兰
tc	特克斯和凯科斯群岛
td	乍得
tf	法属南部领地
tg	多哥
th	泰国
tj	塔吉克斯坦
tk	托克劳
tl	东帝汶
tm	土库曼斯坦
tn	突尼斯
to	汤加
tr	土耳其
tt	特立尼达和多巴哥
tv	图瓦卢
tw	台湾
tz	坦桑尼亚
ua	乌克兰
ug	乌干达
um	美国本土外小岛屿
us	美国
uy	乌拉圭
uz	乌兹别克斯坦
va	梵蒂冈
vc	圣文森特和格林纳丁斯
ve	委内瑞拉
vg	英属维尔京群岛
vi	美属维尔京群岛
vn	越南
vu	瓦努阿图
wf	瓦利斯和富图纳
ws	萨摩亚
ye	也门
yt	马约特
za	南非
zm	赞比亚
zw	津巴布韦

`language`（选填）：

该参数用于设置搜索结果的界面语言代码。

参数	名称	作用
language	结果页面语言	用于设置搜索结果页面的语言，使用对应的语言代码。默认值为 en。

语言参数值对应表

value	name
ach	阿乔利语
af	南非荷兰语
ak	阿肯语
am	阿姆哈拉语
ar	阿拉伯语
az	阿塞拜疆语
be	白俄罗斯语
bem	本巴语
bg	保加利亚语
bh	博杰普尔语
bn	孟加拉语
br	布列塔尼语
bs	波斯尼亚语
ca	加泰罗尼亚语
chr	切罗基语
ckb	中库尔德语
co	科西嘉语
crs	塞舌尔克里奥尔语
cs	捷克语
cy	威尔士语
da	丹麦语
de	德语
ee	埃维语
el	希腊语
en	英语
eo	世界语
es	西班牙语
es-419	拉丁美洲西班牙语
et	爱沙尼亚语
eu	巴斯克语
fa	波斯语
fi	芬兰语
fo	法罗语
fr	法语
fy	西弗里西亚语
ga	爱尔兰语
gaa	加族语
gd	苏格兰盖尔语
gl	加利西亚语
gn	瓜拉尼语
gu	古吉拉特语
ha	豪萨语
haw	夏威夷语
hi	印地语
hr	克罗地亚语
ht	海地克里奥尔语
hu	匈牙利语
hy	亚美尼亚语
ia	国际语
id	印度尼西亚语
ig	伊博语
is	冰岛语
it	意大利语
iw	希伯来语
ja	日语
jw	爪哇语
ka	格鲁吉亚语
kg	刚果语
kk	哈萨克语
km	高棉语
kn	卡纳达语
ko	韩语
kri	kri
ku	库尔德语
ky	吉尔吉斯语
la	拉丁语
lg	卢干达语
ln	林加拉语
lo	老挝语
loz	洛齐语
lt	立陶宛语
lua	卢巴-卢拉语
lv	拉脱维亚语
mfe	毛里求斯克里奥尔语
mg	马拉加斯语
mi	毛利语
mk	马其顿语
ml	马拉雅拉姆语
mn	蒙古语
mo	罗马尼亚语
mr	马拉地语
ms	马来语
mt	马耳他语
ne	尼泊尔语
nl	荷兰语
nn	挪威尼诺斯克语
no	挪威语
nso	北索托语
ny	齐切瓦语
nyn	尼昂科勒语
oc	奥克语
om	奥罗莫语
or	奥里亚语
pa	旁遮普语
pcm	尼日利亚皮钦语
pl	波兰语
ps	普什图语
pt	葡萄牙语
pt-br	巴西葡萄牙语
pt-pt	欧洲葡萄牙语
qu	克丘亚语
rm	罗曼什语
rn	隆迪语
ro	罗马尼亚语
ru	俄语
rw	卢旺达语
sd	信德语
sh	塞尔维亚语（拉丁文）
si	僧伽罗语
sk	斯洛伐克语
sl	斯洛文尼亚语
sn	绍纳语
so	索马里语
sq	阿尔巴尼亚语
sr	塞尔维亚语
sr-ME	塞尔维亚语（黑山）
st	南索托语
su	巽他语
sv	瑞典语
sw	斯瓦希里语
ta	泰米尔语
te	泰卢固语
tg	塔吉克语
th	泰语
ti	提格利尼亚语
tk	土库曼语
tl	菲律宾语
tn	茨瓦纳语
to	汤加语
tr	土耳其语
tt	鞑靼语
tum	通布卡语
tw	阿肯语
ug	维吾尔语
uk	乌克兰语
ur	乌尔都语
uz	乌兹别克语
vi	越南语
wo	沃洛夫语
xh	科萨语
xx-bork	瑞典厨师语
xx-elmer	艾尔默·福德语
xx-hacker	黑客语
xx-klingon	克林贡语
xx-pirate	海盗语
yi	意第绪语
yo	约鲁巴语
zh-cn	中文（中国）
zh-tw	中文（台湾）
zu	祖鲁语

`extract_content`（选填）：

该参数用于控制是否对搜索结果中包含 URL 的信息进一步提取网页正文。

参数	名称	作用
extract_content	是否内容提取	用于设置是否对搜索结果中包含 URL 的每条信息进一步采集详情正文。可选值：false（不提取）、true（提取）。默认值为 false。

`extract_options`（选填）：

该参数用于配置搜索结果详情正文的提取方式。仅当 extract_content 设置为 true 时，才可传入该参数。

参数	名称	上级参数	作用
extract_options	内容提取设置	extract_content	用于配置详情正文的提取参数。参数类型为 object，仅当 extract_content 为 true 时有效。

`formats`（选填）：

该参数用于设置提取的网页正文输出格式。

参数	名称	上级参数	作用
formats	结果格式	extract_content	用于设置网页正文的输出格式。可选值：markdown（Markdown）、raw_html（原生 HTML）、clean_html（清洗后 HTML）、links（链接列表）。默认值为 markdown。

`include_tags`（选填）：

该参数用于指定采集时需要保留的 HTML 标签或 CSS Selector 内容。

参数	名称	上级参数	作用
include_tags	保留标签	extract_content	用于指定采集时仅保留指定 HTML 标签或 CSS Selector 对应的内容。最多 50 条，每条最长 2048 个 UTF-8 字节。例如：["data-testid=qsp-price1","data-testid=qsp-price2"]。

`exclude_tags`（选填）：

该参数用于指定采集时需要排除的 HTML 标签或 CSS Selector 内容。

参数	名称	上级参数	作用
exclude_tags	排除标签	extract_content	用于指定采集时需要去除的 HTML 标签或 CSS Selector 对应的内容。最多 50 条，每条最长 2048 个 UTF-8 字节。例如：["data-testid=qsp-price1","data-testid=qsp-price2"]。

`only_main_content`（选填）：

该参数用于控制是否仅保留网页主体内容。

参数	名称	上级参数	作用
only_main_content	是否只保留主体	extract_content	用于设置是否去除导航、页脚及模板内容。true 表示仅保留清洗后的正文；false 表示保留更多清洗后的内容。默认值为 true。

`advanced_mode`（选填）：

该参数用于设置网页采集策略。

参数	名称	上级参数	作用
advanced_mode	采集策略	extract_content	用于设置网页采集方式。false 表示采用无渲染 HTTP 方式采集；true 表示启用自动解锁策略，依次尝试无渲染采集、浏览器渲染采集、浏览器渲染结合网页解锁器采集，前一级采集失败后才进入下一级。不同采集方式的费用不同，具体以费用说明为准。默认值为 true。

`timeout_ms`（选填）：

该参数用于设置单条正文页面采集的最长处理时间。

参数	名称	上级参数	作用
timeout_ms	页面请求限制	extract_content	用于限制单条正文页面获取、渲染和提取的最长时长，单位为毫秒。取值范围为 1000～120000。默认值为 60000。

`wait_for_ms`（选填）：

该参数用于设置采集正文页面时的加载等待时长。

参数	名称	上级参数	作用
wait_for_ms	页面加载限制	extract_content	用于设置采集正文页面时系统加载等待的时长，单位为毫秒。取值范围为 0～30000。默认值为 0。当与 timeout_ms 同时传入时，wait_for_ms 不得超过 timeout_ms 的一半。

`max_age_ms`（选填）：

该参数用于设置采集正文页面时允许使用的缓存最大时效。

参数名称上级参数作用
max_age_ms 页面缓存限制 extract_content 用于设置采集正文页面时可接受的缓存最大时效，单位为毫秒。取值范围为 0～172800000（2 天）；设置为 0 表示强制回源。默认值未在原始参数表中注明。

参数	名称	上级参数	作用
max_age_ms	页面缓存限制	extract_content	用于设置采集正文页面时可接受的缓存最大时效，单位为毫秒。取值范围为 0～172800000（2 天）；设置为 0 表示强制回源。默认值未在原始参数表中注明。

代码示例

cURL（Windows）

网页搜索 · Search API

unique_id（必填）：#

query（必填）：#

source（选填）：#

max_results（选填）：#

time_range（选填）：#

country（选填）：#

国家参数值对应表#

language（选填）：#

语言参数值对应表#

extract_content（选填）：#

extract_options（选填）：#

formats（选填）：#

include_tags（选填）：#

exclude_tags（选填）：#

only_main_content（选填）：#

advanced_mode（选填）：#

timeout_ms（选填）：#

wait_for_ms（选填）：#

max_age_ms（选填）：#

参数名称上级参数作用max_age_ms页面缓存限制extract_content用于设置采集正文页面时可接受的缓存最大时效，单位为毫秒。取值范围为 0～172800000（2 天）；设置为 0 表示强制回源。默认值未在原始参数表中注明。#

代码示例#