Get Yahoo search results — ads, answers and local results included — as JSON
The Yahoo Search API returns Yahoo (search.yahoo.com and 36 Yahoo country sites) as JSON in five actions.
- endpoints
- 5
- credits per call
- 1–2
2 credits per call≈ $2/1,000 calls1,000 free credits, no card
- next_page
- 2
- has_next
- true
5 active endpoints, on 1 and 2 credit tiers.
- POST/yahoo-search/v1/search2 credits
- POST/yahoo-search/v1/news1 credit
- POST/yahoo-search/v1/images2 credits
- POST/yahoo-search/v1/videos2 credits
- POST/yahoo-search/v1/suggest1 credit
Run the call yourself, on the real endpoint
Change a parameter and press Try it. The response on the right is what your code will receive.
Yahoo Search API
3 of 5 endpoints, ready to run
The Yahoo results page as JSON: organic results with site name, displayed URL, date and sitelinks; the ads above and below them with the advertiser's landing page; People also ask with Yahoo's written answer; local results, knowledge graph, inline videos and images, top stories, related and trending searches.
// Press "Try it" and this pane shows exactly what the // live site returned this second — including an empty // result, if that is the truth. No key, no account.
What Yahoo Search endpoints does ReefAPI ship?
5 live read endpoints. Read-only data API: no writes, no account actions, no dashboard access on the target site.
Every parameter, every allowed value →
Missing a Yahoo Search endpoint, or need a source we don't have yet?Contact us real people · same-day reply.How the Yahoo Search API works
Yahoo Search is a normal ReefAPI surface — the same four rules that hold for every other engine on the key.
No OAuth app, no request signing, no per-site account. One key covers all 632 engines.
Every route is a POST with a JSON body. Parameters are validated against the published schema before anything is charged.
Credits, not seats. Failed and blocked calls are never charged, and nothing is cached: every call reads the source live.
One envelope everywhere. meta carries latency_ms, record_count and the endpoint that answered.
Track a keyword on Yahoo, ads included
Yahoo's results page is more than ten blue links: ads, People also ask answers, local packs and media carousels sit between them. One call returns all of it, each block in its own field.
{"query": "crm software for small business", "count": 21}organic_results[] with continuous positions over three Yahoo pages; ads[] with block (top or bottom), advertiser and the landing URL; people_also_ask[] with each answer.
{"query": "autoversicherung vergleich", "country": "de"}The same keyword on de.search.yahoo.com: the German site's own results and ads.
{"query": "crm software", "sort": "date", "time": "week"}What was published this week, newest first, with publisher and the outlet it ran via.
Rows keyed on the destination URL — Yahoo's redirect links are unwrapped, ads included — with ads always kept apart from organic results.
curl -X POST https://api.reefapi.com/yahoo-search/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"coinbase alternatives"}'{
"ok": true,
"data": { … },
"meta": {
"api": "yahoo-search",
"endpoint": "search",
"mode": "live",
"latency_ms": …,
"record_count": …
},
"error": null
}What each action returns
Measured on 2026-11-06 with live calls. Every action returns the standard envelope; rows below are inside data.
| Action | Rows | Filters and paging |
|---|---|---|
| search | organic_results[], ads[], people_also_ask[], local_results{location, places[]}, knowledge_graph, inline_videos[], inline_images[], top_stories[], related_searches[], trending_searches[], pagination | country, page (7 per page), count up to 35, time (day, week, month), tld |
| news | results[] with title, url, domain, source, via, published, snippet, thumbnail | country, page (10 per page, up to 50), sort relevance or date, time (day, week, month) |
| images | results[] with title, original, width, height, source_url, source, thumbnail; related_searches[] | country, page (60 per page, up to 10), size, color, type, layout, people, time, license, safesearch |
| videos | results[] with title, url, platform, duration, views, published, description, thumbnail; related_searches[] | country, page (60 per page, up to 10), duration, time, resolution, source, safesearch |
| suggest | suggestions[] in Yahoo's order | country |
Titles, snippets and answers come back as plain text: Yahoo's highlight tags and HTML entities are removed. Every link is the destination URL, not Yahoo's redirect. Yahoo's own parameter names (p, vc, btf, vs, imgsz, imgc, durs, vsite …) are accepted too.
What Yahoo actually returns, measured
Measured on 2026-11-06 with live calls — 60 queries in 37 Yahoo markets and more than 15 languages on search, plus every vertical and filter — through the same gateway path customers use, and checked against a second, independent reading of the same pages.
On a commercial query such as car insurance quotes: the organic results, ten ads above and below them, and four People also ask questions with Yahoo's answers. pizza near me brooklyn ny adds fifteen local places with rating, review count and source, price level, address, phone, opening status, website, menu link and coordinates; albert einstein adds a knowledge graph card (born, died, family, a description attributed to Wikipedia), inline images and a TikTok and YouTube video carousel.
country picks the Yahoo site that answers — uk, de, fr, es, it, ca, in, tw, hk, br, mx and 25 more. Results, ads, news and autocomplete are that site's own. In some markets Yahoo shows few or no ads on a given keyword; ads[] is then empty rather than filled from another market.
Checked against an unfiltered call in the same minute: tld=.gov returned 7 of 7 results on .gov, time=day only fresh pages, news sort=date articles in age order, images size=small only small images, videos duration=short 60 of 60 under five minutes. Yahoo's language and file-type parameters changed nothing when measured, so they are not offered.
Yahoo prints seven organic results per page and ignores requests for more. page steps through Yahoo's pages; count (up to 35) fetches the following pages in the same call and returns one continuous list. Yahoo occasionally repeats a URL across neighbouring pages; repeats are removed.
Yahoo Shopping's product search now hands over to Yahoo's AI assistant, so there is no product results page to return. The AI summary at the top of some results pages is written in after the page loads and is not part of the page; the People also ask answers are.
A query Yahoo answers with "We did not find results" returns NOT_FOUND only after a second check agrees; a page that could not be read is retried, never reported as no results. With safesearch=strict, a query whose results are all adult returns NOT_FOUND saying so.
What people build with Yahoo Search
The jobs this data is most often used for.
endpoints
credits per call
Rank tracking on Yahoo: position of your domain per keyword and country site, page by page.
Ad intelligence: who advertises on a keyword on Yahoo, with ad copy, sitelinks and landing pages.
Local research: the places Yahoo lists for a query, with ratings, phone numbers, hours and coordinates.
Content research: the questions Yahoo shows under People also ask, with its answers, and the related searches.
What Yahoo Search data costs
The cheapest call here is 1 credit, so $15/mo (Pro) buys 10,000 of them — $1.50 per 1,000 credits. Credits roll over and never expire, and failed or blocked calls are not charged.
- 1,000 free credits on signup, no card
- One key, all 632 APIs, one credit pool
- Failed and blocked calls are never charged
- Credits roll over and never expire
Call it in two lines
Sign up, get 1,000 credits and one key that works on every engine. Then this is the whole protocol.
curl -X POST https://api.reefapi.com/yahoo-search/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"coinbase alternatives"}'import os
import requests
REEF_KEY = os.environ["REEF_KEY"]
r = requests.post(
"https://api.reefapi.com/yahoo-search/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"query": "coinbase alternatives"
},
timeout=90,
)
print(r.json()["data"])Have a question? We got answers.
The questions people actually ask before wiring up Yahoo Search.
Is this an official Yahoo API?▾
No. Yahoo has no public search API. ReefAPI is an independent service that returns what Yahoo's public results pages show, as JSON, with no Yahoo account.
Is this the same as Yahoo! JAPAN search?▾
No. Yahoo! JAPAN (search.yahoo.co.jp) is a separate company and has its own engine, yahoo-japan-search. This engine is search.yahoo.com and Yahoo's other country sites.
Are these Bing results?▾
Yahoo's web results are powered by Bing's index, but the page is Yahoo's: its order, its ads, its People also ask answers, its local and knowledge blocks. This API returns what a Yahoo user sees.
Which countries are supported?▾
us (search.yahoo.com), uk, ca, ie, in, sg, ph, my, id, vn, tw, hk, za, fr, be, ch, de, at, es, it, nl, se, no, dk, fi, gr, ro, pl, tr, il, br, mx, ar, co, cl, pe and ve. Yahoo's Australian site now forwards to search.yahoo.com, so it is not listed. Poland's site has no autocomplete, so suggest answers MARKET_UNAVAILABLE there.
Why do local results say "Results near" a city I did not ask for?▾
For queries without a place name Yahoo picks a location itself. local_results.location returns the location Yahoo used, so you can tell. Put the place in the query (pizza near me brooklyn ny) to get that place.
How many results can I get?▾
Seven per Yahoo page, which is Yahoo's own page size. Use page to step through, or count up to 35 to get several pages in one call with continuous positions.
How fast is it?▾
In the measured runs a search call took about 1.1 s at the median and news, images and videos about 1 s; autocomplete about 0.6 s.
What is the Yahoo Search API?▾
Yahoo Search API is a ReefAPI endpoint group for yahoo search results as json: organic results, ads with landing pages, people also ask with yahoo's answers, local results, knowledge graph, inline videos and images, top stories and related searches, plus yahoo news, images, videos and autocomplete, for search.yahoo.com and 36 country sites. It returns live JSON through POST requests under /yahoo-search/v1.
Is the Yahoo Search API free to try?▾
Yes. ReefAPI starts with 1,000 free credits, no card required. Yahoo Search calls use the same shared credit balance as every other ReefAPI engine.
Do I need a Yahoo Search login or account?▾
No login to Yahoo Search is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.
How fresh is the Yahoo Search data?▾
The page example is captured from a live search call, and production requests fetch live data through ReefAPI rather than a static sample.
How many credits does the Yahoo Search API use?▾
Yahoo Search actions currently cost 1-2 credits per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.
Can I call Yahoo Search from an AI assistant or MCP client?▾
Yes. Connect ReefAPI once through MCP and your assistant can call yahoo-search actions with the same key, credit pool and JSON envelope used by normal REST requests.
Is the Yahoo Search API a Yahoo Search scraper?▾
It is the managed alternative to a DIY Yahoo Search scraper. Instead of building and maintaining your own scraper — proxies, headless browsers, captcha and constant breakage — you call one ReefAPI endpoint and get the same yahoo search results as json: organic results, ads with landing pages, people also ask with yahoo's answers, local results, knowledge graph, inline videos and images, top stories and related searches, plus yahoo news, images, videos and autocomplete, for search.yahoo.com and 36 country sites back as clean JSON.
11 Search & SEO APIs on the same key
One key, one credit pool, one response envelope. If you are pulling Yahoo Search, you are one call away from the rest of the category — no second contract, no second integration.
Need something this API does not do?
Name the endpoint, the field, or a source we do not carry yet. We ship new APIs every week and you would be first to get the key. Real people read every message and reply the same day.
Try it on your own data before you pay anything
The call above is the real endpoint, not a recording. A free key gives you 1,000 credits, the other 631 APIs, and the same envelope everywhere.
Endpoints, parameters and credit costs on this page are read from the live catalog and cannot drift from what the API accepts. Field notes were captured on 2026-11-06.