SERP
Yahoo SERP
Yahoo search results — organic rankings and search data from Yahoo.
POST
$0.01/call/v1/serp/yahooUsage
const res = await fetch('https://api.yepapi.com/v1/serp/yahoo', {
method: 'POST',
headers: {
'x-api-key': 'YOUR_API_KEY',
'Content-Type': 'application/json',
},
body: JSON.stringify({ query: 'best laptops for developers', depth: 10 }),
});
const { data } = await res.json();
console.log(data);curl -X POST https://api.yepapi.com/v1/serp/yahoo \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query": "best laptops for developers", "depth": 10}'Request Body
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
query | string | Yes | Search query to look up on Yahoo | — |
depth | number | No | Number of results to return | 10 |
location_code | number | No | Target country code (e.g., 2840 for US). See Location Codes. | 2840 |
language | string | No | ISO language code (e.g., en, es) | "en" |
Response
{
"ok": true,
"data": {
"query": "best laptops 2026",
"totalResults": 0,
"results": [
{
"position": 1,
"type": "organic",
"title": "The Best Laptops We've Tested (April 2026) | PCMag",
"url": "https://www.pcmag.com/picks/the-best-laptops",
"description": "Apr 1, 2026 · Read on to see all our picks, compare their specs, and get down-to-earth buying advice for nailing down the best laptop for you.",
"domain": "www.pcmag.com"
},
{
"position": 2,
"type": "organic",
"title": "Best Laptops 2026 - Forbes Vetted",
"url": "https://www.forbes.com/sites/forbes-personal-shopper/article/best-laptop/",
"description": "Apr 1, 2026 · We tested 18 models across a variety of brands to find the best laptops of 2026.",
"domain": "www.forbes.com"
},
{
"position": 3,
"type": "organic",
"title": "13 Of The Best Laptops You Can Buy In 2026 - SlashGear",
"url": "https://www.slashgear.com/2116777/best-laptops-buy-in-2026/",
"description": "Mar 10, 2026 · We've chosen laptops for 13 unique categories, including the best budget-friendly laptop, best gaming laptop, best Chromebook, and even best repairable laptop.",
"domain": "www.slashgear.com"
}
]
}
}Response Fields
| Field | Type | Description |
|---|---|---|
ok | boolean | Whether the request succeeded |
data.query | string | The search query that was executed on Yahoo |
data.totalResults | number | Total number of results found (may be 0 when Yahoo does not expose a count) |
data.results | object[] | Array of search result items |
data.results[].position | number | Position in search results (1-indexed) |
data.results[].type | string | Result type (e.g., organic, paid, topStories, video, peopleAlsoAsk, shopping, relatedSearches) |
data.results[].title | string | Title of the search result |
data.results[].url | string | URL of the search result page |
data.results[].description | string | Snippet or description shown in Yahoo results |
data.results[].domain | string | Domain of the result URL |
Under the Hood
Under the hood, this queries our SERP engine. We normalize the response format and flatten nested structures for consistency.