Yahoo Search
Retrieve Yahoo search results and suggestions based on a query. Useful for keyword research, SEO analysis, privacy-focused search insights, and understanding user intent.
If you already know that you want to use Yahoo Search, this page is the one you should read. It shows the required input, the filters you can apply, how pagination works, and what localization controls are available.
At a Glance
| Field | Value |
|---|---|
| Name | Yahoo Search |
| Scraper | yahoo_search |
| Engine | yahoo_search |
| Website | Yahoo |
| Website URL | Yahoo.com |
| Output Format | json |
| Version | 1.0.0 |
| Parameter Count | 10 |
| Parameter Groups | Pagination (1), Search Query (1), Localization (3), Advanced Filters (3), Request Controls (2) |
Required Parameters
If you are sending your first request with this engine, start here. Requiredness is based on properties.<field>.must, not the top-level required array.
| Field | Type | Group | Description |
|---|---|---|---|
q | string | Search Query | The keyword or phrase you want this search engine to look up. |
Available Parameters
The sections below follow the same parameter groups as the backend, but the field descriptions have been rewritten into shorter, user-facing wording so they are easier to scan.
Pagination
| Field | Type | Required | Description |
|---|---|---|---|
b | string | No | Result offset used for Yahoo-style pagination. |
Search Query
| Field | Type | Required | Description |
|---|---|---|---|
q | string | Yes | The keyword or phrase you want this search engine to look up. |
Localization
| Field | Type | Required | Description |
|---|---|---|---|
vc | string | No | Yahoo country code used to localize results. |
vl | string | No | Yahoo language filter. |
yahoo_domain | string | No | Yahoo domain to query, such as the default global domain or a regional one. |
Additional Constraints
vc：Options: 94 options. Examples:al,dz,ar,am,auvl：Options: 32 options. Examples:lang_ar,lang_bg,lang_zh_chs,lang_zh_cht,lang_hryahoo_domain：Options: 40 options. Examples:espanol,be,fr,br,ca
Advanced Filters
| Field | Type | Required | Description |
|---|---|---|---|
vf | string | No | Yahoo file-type filter, such as PDF, DOC, or TXT. |
vm | string | No | Yahoo safe-search level. |
vs | string | No | Limit Yahoo results to specific top-level domains, such as .com or .org. |
Additional Constraints
vf：Options: 6 options. Examples:html,pdf,xls,ppt,docvm：Options: 3 options. Examples:r,i,p
Request Controls
| Field | Type | Required | Description |
|---|---|---|---|
device | string | No | Device type used when requesting results, such as desktop or tablet. |
no_cache | boolean | No | Skip cached results and force a fresh fetch. |
Additional Constraints
device：Options: 2 options. Examples:desktop,tabletno_cache：Default:false