Try it
Run a live Yahoo SERP request
One real call against the API, no signup and no key. Rendered as a results page, and as the raw JSON your code receives.
Endpoints & Pricing
Four Yahoo Endpoints, One API Key
Web search for the full result page, news for structured articles, images for the deepest filter set on the platform, or dedicated video search. Set engine=yahoo on any of them. Pay only for what you use.
Web SERP
- Organic results with snippets
- People Also Ask & related searches
- Local pack & knowledge panel
- Breadcrumbs, publish dates, sitelinks
- Optional AI summary (
include_aio=true) - Freshness & safe-search filters
News
- Up to 50 articles per request
- Title, URL, source, snippet, image
- Publication time as Yahoo prints it
- Sort by relevance or by date
- Freshness: past day, week, month
- 112 country codes accepted
Images
- Seven filter families, combinable
- Size, type, colour, aspect ratio
- People: face, portrait, non-portrait
- Licence: CC, public domain, reuse
- Full-size URL, thumbnail, dimensions
- Source domain & publisher page URL
Videos
- Dedicated video result set
- Duration filter: short, medium, long
- Resolution filter up to 1080p
- Thumbnail, duration, publisher, views
- Publisher URLs, never a redirect
- Country & freshness targeting
Pixel Position & Geometry on every Yahoo SERP element
Add pixel_position=true to any Yahoo Deep Search (/api/search) call and every item — organic results, ads, People Also Ask, videos, local pack, related searches — comes back with both an integer pixel_position (y-coordinate) and a full pixel_box with x, y, width, and height. Same per-call price, opt-in flag. Paid tiers only; values describe a standard desktop rendering, and an item deep in the response can come back null — branch on the field's presence and fall back to position. Useful on Yahoo in particular, where an ad block or a local pack can push the first organic result far down a tall page.
{
"organic": [
{ "position": 1, "pixel_position": 612, "pixel_box": { "x": 48, "y": 612, "w": 1310, "h": 231 } }
],
"peopleAlsoAsk": [
{ "pixel_position": 726, "pixel_box": { "x": 48, "y": 726, "w": 1310, "h": 142 } }
]
}
Quick Start
Integrate in Under 5 Minutes
One engine=yahoo parameter is the whole difference. Replace YOUR_API_KEY with the key from your dashboard.
# Yahoo web search, US results, strict safe search curl "https://apiserpent.com/api/search?q=best+travel+credit+cards&engine=yahoo&country=us&num=20&safe=strict" \ -H "X-API-Key: YOUR_API_KEY"
{
"success": true,
"query": "best travel credit cards",
"type": "web",
"engine": "yahoo",
"country": "us",
"results": {
"organic": [
{
"position": 1,
"title": "Best Travel Credit Cards of 2026",
"url": "https://example.com/travel-cards",
"snippet": "We compared 40 rewards cards on annual fee, transfer partners...",
"displayedUrl": "example.com"
}
],
"richSnippets": [
{
"position": 1,
"breadcrumb": "example.com › credit-cards › travel",
"publishDate": "2026-07-27",
"rating": null,
"reviews": null,
"sitelinks": [],
"faq": []
}
],
"peopleAlsoAsk": [
{
"question": "Which travel card has no foreign transaction fee?",
"answer": "Most premium travel cards waive it entirely...",
"sourceUrl": null,
"sourceTitle": null,
"sourceDisplay": null
}
],
"relatedSearches": [
{ "query": "best travel credit cards no annual fee" },
{ "query": "travel credit card comparison 2026" }
],
"localPack": [],
"knowledgePanel": null,
"featuredSnippet": null,
"videos": []
},
"meta": {
"totalOrganic": 20,
"pagesRequested": 2,
"pagesScraped": 2,
"elapsed": "1487ms"
}
}
Note the empty localPack, the null knowledgePanel and the null PAA citation fields. Every key is present on every response whether or not Yahoo rendered that block, so you can index into the shape without a guard, and a missing citation is Yahoo's page rather than a hole in the data — see the note on People Also Ask below.
Data Fields
What Each Yahoo Endpoint Gives You
Every endpoint returns structured JSON with the fields SEO tools, rank trackers and market research actually consume — no HTML parsing on your side.
Web Search Fields
- organic[].position
- organic[].title
- organic[].url
- organic[].snippet
- organic[].displayedUrl
- peopleAlsoAsk[].question
- richSnippets[].breadcrumb
- richSnippets[].publishDate
- relatedSearches[].query
Entity & Local Fields
- localPack[].name
- localPack[].rating
- localPack[].reviews
- localPack[].category
- localPack[].address
- localPack[].hours
- knowledgePanel.title
- knowledgePanel.facts[]
- knowledgePanel.links[]
News & Image Fields
- articles[].title
- articles[].source
- articles[].publishedTime
- articles[].snippet
- articles[].image
- images[].original
- images[].thumbnail
- images[].width, .height
- images[].pageUrl
Request Parameters
- q (search query)
- engine=yahoo
- num (results count, up to 100)
- pages (1–10 on /api/search)
- country (e.g., us, gb, de)
- language (e.g., en, es, de)
- freshness (d, w, m)
- safe (off, moderate, strict)
- format (full, simple)
Measured, not promised
What a Yahoo result page actually carries
Feature-block lists are usually marketing. These are counts, taken across 240 Yahoo result pages. Build against the rate, not the brochure.
| Block | Field | Pages carrying it | What you get when it appears |
|---|---|---|---|
| Related searches | relatedSearches | 100% | About 8 suggested queries, on every page in the sample |
| Per-result enhancements | richSnippets | 100% | Across 1,689 organic results: a breadcrumb trail on 79.7% and a publish date on 56.4%; star ratings, FAQ accordions and sitelinks are rare |
| People Also Ask | peopleAlsoAsk | 52% | About 4 questions with expandable answers |
| Video carousel | videos | 18% | Exactly 3 cards with title, duration, publisher, date, views and thumbnail |
| Local pack | localPack | 10% | 2–3 businesses with rating, review count, category, address and open state |
| Knowledge panel | knowledgePanel | 7% | Company, health or generic entity card with a fact table and official links |
| Featured snippet | featuredSnippet | 2% | Dictionary definitions with pronunciation, part of speech and senses |
| Ads | ads | 2% | Paid placements with title, display URL and description |
| AI summary | aiOverview | 2% | Opt-in with include_aio=true on paid Deep Search; summary plus the pages it cites |
Sample: 240 Yahoo result pages across a mixed keyword set, counted September 2026. Percentages describe how often Yahoo itself renders each block, and they move as Yahoo changes its page. Two consequences worth designing for: a Yahoo featured snippet is a dictionary card, so do not expect a paragraph answer box the way Google serves one; and a rank tracker built only on organic positions is leaving the breadcrumb and publish-date signals on every result untouched.
Rich Features
More Than Blue Links
Six blocks Yahoo renders beyond the organic list. Each is a named JSON field, present on every response even when Yahoo showed nothing.
People Also Ask
Questions and expandable answers — direct search-intent data. Yahoo is midway through swapping widgets: the newer one carries no publisher citation, so sourceUrl is null on those items.
Per-result rich snippets
Breadcrumb trail, publish date, star rating, review count, sitelinks and FAQ accordions, each keyed back to the organic position it belongs to.
Local pack
Two or three businesses with name, rating, review count, category, address and an open-or-closed state — Yahoo shows a live state rather than an hours table.
Knowledge panel
Entity cards in three shapes — company, health condition and generic — each flattened into one title, subtitle, description, fact table and link list.
Video carousel
Three cards per page with title, duration, publisher, upload date, view count and thumbnail. Every URL points at the publisher, never at a search redirect.
Related searches
The one block that appeared on every page in our sample — roughly eight queries per SERP, which makes Yahoo a cheap and reliable keyword-expansion source.
Filters
Every filter Yahoo accepts, spelled out
Yahoo's image search takes the deepest filter set of any engine on this platform. Send a value outside a list and it is ignored rather than rejected — you lose the filter, not the call.
Web search — /api/search
country112 ISO-2 codes; applied to the Yahoo request, not just echoed backlanguage2-letter ISO code (en, es, de, fr, ja, …)safeoff, moderate, strict — strict really removes adult results on Yahoo, so a deliberately adult query can come back with nothingfreshnesspast day, past week, past monthnum / pagesup to 100 results, or 1–10 pagesinclude_aioadds the AI summary block (paid Deep Search)pixel_positionadds y-coordinate and box geometry (paid Deep Search)formatfull for every block, simple for position/title/urlImage search — /api/images
sizesmall, medium, large, wallpapertypephoto, clipart, lineart, animatedcolorred, orange, yellow, green, teal, blue, purple, pink, white, black, gray, brown — plus color and bwaspectsquare, wide, tallpeopleface, portrait, nonportraittimeday, week, month, yearlicensecc, public, share, sharecommercial, modify, modifycommercialnumcaps the returned list, up to 100Video search — /api/videos
durationshort, medium, longresolution360p, 480p, 720p, hd, 1080pfreshnesspast day, past week, past monthtimeday, week, month — the alias of freshnesssafeoff, moderate, strictcountry / languagesame codes as web searchNews search — /api/news
sortrelevance or date — date is a real Yahoo News sort, not a re-order of what we already holdfreshnesspast day, past week, past monthsafeoff, moderate, strictnumup to 50 articles per requestcountry / languagesame codes as web searchformatfull or simpleWhy Yahoo SERP data
A second ranking surface, priced like a first one
Yahoo orders and decorates results its own way, so the same keyword produces a genuinely different page: a cheap cross-check for rank tracking, and a distinct source for content research.
There is no official Yahoo search API
Yahoo's own developer product, BOSS, was shut down on 31 March 2016 and was never replaced — the JSON Search, Placefinder, Placespotter and Hosted Search APIs all ended on the same day. The public results page is the only remaining source of Yahoo ranking data, which is what this endpoint turns into JSON. See how to pull Yahoo results without a paid plan for the free-tier route.
A different order for the same query
Yahoo ranks and lays out its page independently of Google, so a keyword that sits third in one can sit ninth in the other, and the surrounding blocks differ too. Teams that track a single engine never see that spread, and it is widest on the queries where Yahoo behaves least like Google — a stock ticker, a local business, a single dictionary word. Pair this endpoint with Google on the same keyword list and the gap is a measurement, not a guess.
Country and language are real levers
The country parameter accepts 112 ISO-2 codes and language a 2-letter code; both are carried into the Yahoo request rather than applied to the results afterwards. Yahoo's localization is strong in several markets where a US-shaped SERP tells you nothing useful.
Short pages, whole answers
A Yahoo result page carries about seven organic results where most engines show ten, so depth here means reading more of Yahoo's pages. Ask for num=100 and you get one call and one JSON body, with the response stating how many results actually arrived rather than leaving you to count. The Python walkthrough shows the loop.
FAQ
Yahoo SERP API Questions
include_aio=true. Every one of those keys is present on every response: a block Yahoo did not show comes back as null or an empty array rather than being missing, so your parser never has to test whether a key exists.
country parameter accepts 112 ISO-2 codes, including us, gb, ca, au, in, de, fr, es, it, br and mx, and language takes a 2-letter ISO code such as en, es, de or fr. Both are applied to the Yahoo request itself rather than only echoed back in the response, which is why Yahoo is a useful second reading for regional rank tracking. Call GET /api/countries for the full list.
/api/search, num accepts up to 100 and pages up to 10. Yahoo's own result page is short: it carries roughly seven organic results where most engines show ten, so a large num reads more of Yahoo's pages than the same request would elsewhere and takes correspondingly longer. Every response reports what it actually delivered, so a short answer is visible rather than silent. The News endpoint is capped at 50 articles per request.
include_aio=true and the response carries an aiOverview field with the AI-written summary Yahoo shows at the top of the page, plus the pages it cites. It is not a common block: across 240 Yahoo result pages sampled in 2026, about 2% carried one. The flag is available to paid accounts only, and Quick Search does not accept it.
partialResults block with what you requested, what arrived and a plain-English note. The rule is the same across every endpoint: empty is refunded, short is charged.
Start using the Yahoo SERP API
free API calls apply to Web, News, Image and Video endpoints alike. Yahoo web search from $0.03/1K SERP API calls and news from $0.01/1K queries.
Try for Free
