Looking for the overview — what this API returns, what it costs, and a call you can run without a key? See the Yahoo Search API page →
Search & SEO

Yahoo Search API & Scraper

The Yahoo Search API returns Yahoo (search.yahoo.com and 36 Yahoo country sites) as JSON in five actions.

5 actionsLive JSON1,000 free credits$0.67–$1.50 / 1,000 creditsMCP-ready
Get a free keyOpen in playground

🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.

search gives the results page: organic results with title, link, displayed URL, site name, date, snippet and sitelinks; the ads above and below them with advertiser, landing URL, sitelinks and callouts; People also ask with Yahoo's written answers; local results with rating, reviews, price level, address, phone, hours, website and coordinates; the knowledge graph card; inline videos (YouTube, TikTok) and images; top stories; related and trending searches — seven results a page, up to 35 in one call, with time and top-level-domain filters. news searches Yahoo News with newest-first sorting and time windows; images and videos return 60 results a page with Yahoo's size, colour, type, layout, people, licence, length, resolution, source and SafeSearch filters; suggest returns the search-box suggestions of the chosen country. One ReefAPI key, the standard { ok, data, meta, error } envelope, no Yahoo account.

Reference

What each action returns

Measured on 2026-11-06 with live calls. Every action returns the standard envelope; rows below are inside data.

ActionRowsFilters and paging
searchorganic_results[], ads[], people_also_ask[], local_results{location, places[]}, knowledge_graph, inline_videos[], inline_images[], top_stories[], related_searches[], trending_searches[], paginationcountry, page (7 per page), count up to 35, time (day, week, month), tld
newsresults[] with title, url, domain, source, via, published, snippet, thumbnailcountry, page (10 per page, up to 50), sort relevance or date, time (day, week, month)
imagesresults[] 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
videosresults[] with title, url, platform, duration, views, published, description, thumbnail; related_searches[]country, page (60 per page, up to 10), duration, time, resolution, source, safesearch
suggestsuggestions[] in Yahoo's ordercountry

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.

Live example

Real request and response JSON

Captured from the indexed primary action, search, on .

Captured request
{
  "method": "POST",
  "url": "https://api.reefapi.com/yahoo-search/v1/search",
  "headers": {
    "x-api-key": "$REEF_KEY",
    "content-type": "application/json"
  },
  "body": {
    "query": "coinbase alternatives"
  }
}
Captured response
{
  "ok": true,
  "meta": {
    "api": "yahoo-search",
    "endpoint": "search",
    "mode": "live",
    "latency_ms": 1326.7,
    "record_count": 7,
    "bytes": 407581,
    "cache_hit": false,
    "upstream_requests": 1,
    "result_pages": 1,
    "ads_count": 0,
    "charged_credits": 2,
    "version": "0.1.0",
    "request_id": "d091447c141b4dcb",
    "queue_ms": 1.6,
    "fetched_at": "2026-11-06T16:39:45.261Z"
  },
  "data": {
    "query": "coinbase alternatives",
    "country": "us",
    "page": 1,
    "organic_results": [
      {
        "position": 1,
        "title": "10 Best Coinbase Alternatives in 2026: Lower Fees, More Coins ...",
        "url": "https://coinbureau.com/analysis/best-coinbase-alternatives",
        "displayed_url": "https://coinbureau.com › analysis › best-coinbase-alternatives",
        "domain": "coinbureau.com",
        "site_name": "The Coin Bureau",
        "favicon": "https://s.yimg.com/pv/static/search_favicon/images/32x32_7981404b7dabf8cc.png",
        "snippet": "Discover the best Coinbase alternatives with expert analysis from Coin Bureau. Compare fees and features of top exchanges to find your ideal platform.",
        "date": "Feb 1, 2026",
        "sitelinks": [],
        "extensions": []
      },
      {
        "position": 2,
        "title": "7 Best Coinbase Alternatives in November 2026 - 99Bitcoins",
        "url": "https://99bitcoins.com/bitcoin-exchanges/best-coinbase-alternatives/",
        "displayed_url": "https://99bitcoins.com › best-coinbase-alternatives",
        "domain": "99bitcoins.com",
        "site_name": "99Bitcoins",
        "favicon": "https://s.yimg.com/pv/static/search_favicon/images/32x32_e3097a1041708734.png",
        "snippet": "Looking for an alternative to Coinbase? This guide reveals the best Coinbase alternatives for fees, markets, trading tools, and support.",
        "date": "Oct 21, 2026",
        "sitelinks": [],
        "extensions": []
      },
      {
        "position": 3,
        "title": "Top 10 Coinbase competitors: Best exchange alternatives in 2025",
        "url": "https://www.kraken.com/learn/coinbase-competitors",
        "displayed_url": "https://www.kraken.com › learn › coinbase-competitors",
        "domain": "www.kraken.com",
        "site_name": "Kraken",
        "favicon": "https://s.yimg.com/pv/static/search_favicon/images/40x40_335843e7c8bd3f2f.png",
        "snippet": "Coinbase isn’t the only option for traders. Explore Coinbase competitors that let you invest in crypto, access more assets and help you build your portfolio.",
        "date": "Oct 28, 2025",
        "sitelinks": [],
        "extensions": []
      }
    ],
    "ads": [],
    "people_also_ask": [
      {
        "question": "What are Coinbase wallet alternatives?",
        "answer": "There are several notable alternatives to Coinbase Wallet that cater to different user needs.\nPopular Alternatives\nProton Wallet: Focuses on security and user privacy.\nCake Wallet: Known for its user-friendly interface and support for multiple cryptocurrencies.\nUnstoppable Wallet: Offers a decentralized approach, allowing users to control their private keys.\nFeatures to Consider\nSecurity: Look for wallets with strong encryption and backup options.\nUser Experience: A simple interface can enhance usability, especially for beginners.\nSupported Cryptocurrencies: Ensure the wallet supports the coin",
        "answer_type": "ai_summary"
      },
      {
        "question": "What are alternatives to Coinbase for cryptocurrency trading?",
        "answer": "There are several alternatives to Coinbase for trading cryptocurrencies, each offering unique features and benefits. Popular options include Binance, Kraken, and Bitget, which provide lower fees and access to a wider range of cryptocurrencies.\nAlternatives to Coinbase\nHere are some notable platforms similar to Coinbase.\nBinance — Known for its extensive selection of cryptocurrencies and low trading fees.\nKraken — Offers a user-friendly interface and strong security features.\nBitget — Focuses on derivatives trading with competitive fees.\nKuCoin — Provides a wide variety of altcoins and trading ",
        "answer_type": "ai_summary"
      },
      {
        "question": "What are honest alternatives to Coinbase?",
        "answer": "Yes, there are several reputable alternatives to Coinbase in the cryptocurrency space. These platforms are known for their transparency, security, and user-friendly features:\n1. Binance\nOffers a wide range of cryptocurrencies and trading options.\nKnown for low trading fees and advanced trading tools.\n2. Kraken\nHighly regarded for its security measures and regulatory compliance.\nProvides a variety of fiat and crypto trading pairs.\n3. Gemini\nFounded by the Winklevoss twins, it emphasizes regulatory compliance and security.\nOffers a user-friendly interface and a secure wallet.\n4. eToro\nKnown for ",
        "answer_type": "ai_summary"
      }
    ],
    "local_results": null,
    "knowledge_graph": null,
    "inline_videos": [
      {
        "position": 1,
        "title": "BEST Coinbase Alternatives: 5 TOP Exchanges ✅",
        "url": "https://www.youtube.com/watch?v=9Gj0YUFLEpU",
        "thumbnail": "https://up.yimg.com/ib/th/id/OVP.uWBW7Wgg0yw8vIt8pyIjXQEsDh?pid=Api&w=296&h=156&c=7&p=0&rs=1&qlt=95",
        "duration": "24:24",
        "source": "YouTube",
        "date": "6 years ago",
        "views": "231.4K Views"
      },
      {
        "position": 2,
        "title": "Coinbase Alternatives in 2026: How to Compare Crypto Platforms #cryptoeducation #cryptoplatform",
        "url": "https://www.youtube.com/watch?v=YhM1jNxgPzE",
        "thumbnail": "https://up.yimg.com/ib/th/id/OVP.b1FWC5_Fa8gHcBCVhrbXDQHgFo?pid=Api&w=296&h=156&c=7&p=0&rs=1&qlt=95",
        "duration": "1:02",
        "source": "YouTube",
        "date": "3 months ago",
        "views": "1 Views"
      },
      {
        "position": 3,
        "title": "Best Coinbase Alternatives to Trade Crypto With",
        "url": "https://www.youtube.com/watch?v=RWT9_Ik00wI",
        "thumbnail": "https://up.yimg.com/ib/th/id/OVP.VdLRiSetHR-2Ldhsyi8WAQHgFo?pid=Api&w=296&h=156&c=7&p=0&rs=1&qlt=95",
        "duration": "7:27",
        "source": "YouTube",
        "date": "2 years ago",
        "views": "2.5K Views"
      }
    ],
    "inline_images": [],
    "top_stories": [],
    "related_searches": [],
    "trending_searches": [],
    "total_results": null,
    "pagination": {
      "current": 1,
      "has_next": true,
      "next_page": 2
    },
    "filters": {
      "time": "any",
      "tld": null
    }
  }
}
Actions

What the Yahoo Search API does

ActionDescriptionConcrete use caseKey params
searchThe Yahoo web results page (search.yahoo.com or a country site) as a person sees it: organic results with title, URL, displayed URL, site name, date, snippet, sitelinks and extra paragraphs; the paid ads above and below them with advertiser, landing URL, sitelinks and callouts; People also ask with Yahoo's written answer; local results (rating, reviews, price, type, address, phone, hours, website, menu, coordinates); a knowledge graph card; inline videos (incl. TikTok) and images; top stories; related and trending searches. 7 results a page (Yahoo's own size); `count` up to 35 fetches the following pages too.SEO teams call search to get the Yahoo web results page (search.yahoo.com or a country site) as a person sees it.query, country, page, count, time, ...
newsYahoo News search (news.search.yahoo.com or a country site): 10 articles a page with headline, URL, publisher, the outlet it ran via, age, snippet and thumbnail. Time window and newest-first.Content strategists call news to get yahoo News search (news.search.yahoo.com or a country site).query, country, page, time, sort
imagesYahoo image search: 60 images a page with the full-size image URL and its width/height, the page it is on, the site and the thumbnail; related searches. Size, colour, type, layout, people, time, usage-rights and SafeSearch filters.Rank trackers call images to get yahoo image search.query, country, page, size, color, ...
videosYahoo video search across YouTube, TikTok, Dailymotion, Vimeo, news sites and more: 60 videos a page with watch URL, title, platform, duration, views, age, description and thumbnail. Length, time, resolution, source and SafeSearch filters.AI answer-monitoring tools call videos to get yahoo video search across YouTube, TikTok, Dailymotion, Vimeo, news sites and more.query, country, page, duration, time, ...
suggestYahoo search-box suggestions (autocomplete) for what has been typed so far, from the chosen country's own suggestion service.SEO teams call suggest to get yahoo search-box suggestions (autocomplete) for what has been typed so far, from the chosen c….query, country
Code samples

Call search from your stack

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"}'
MCP one-liner
Ask your MCP-connected assistant: call reefapi.yahoo-search.search with {"query":"coinbase alternatives"}.
Use cases

Who uses this API and why

  • 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.
  • Media monitoring: Yahoo News for a brand over the past day or week, newest first, with publisher and outlet.
FAQ

Questions developers ask before integrating

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.

docs / yahoo-search

Yahoo Search

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.

base /yahoo-search/v15 endpoints
post/yahoo-search/v1/news1 credit

Yahoo News search (news.search.yahoo.com or a country site): 10 articles a page with headline, URL, publisher, the outlet it ran via, age, snippet and thumbnail. Time window and newest-first.

ParameterAllowed / rangeDescription
queryrequired—What you would type into Yahoo's search box. Operators Yahoo itself understands ("exact phrase", site:, -word) are passed through unchanged.
country = usoptionalus · 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 · veWhich Yahoo country site answers (search.yahoo.com, uk.search.yahoo.com, de.search.yahoo.com, …). Results, ads, news and suggestions are that site's own.
page = 1optional1–50Result page, 10 results a page (Yahoo's own page size).
time = anyoptionalany · day · week · monthOnly articles from this period.
sort = relevanceoptionalrelevance · dateOrder of articles.
Try in playground →
post/yahoo-search/v1/images2 credits

Yahoo image search: 60 images a page with the full-size image URL and its width/height, the page it is on, the site and the thumbnail; related searches. Size, colour, type, layout, people, time, usage-rights and SafeSearch filters.

ParameterAllowed / rangeDescription
queryrequired—What you would type into Yahoo's search box. Operators Yahoo itself understands ("exact phrase", site:, -word) are passed through unchanged.
country = usoptionalus · 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 · veWhich Yahoo country site answers (search.yahoo.com, uk.search.yahoo.com, de.search.yahoo.com, …). Results, ads, news and suggestions are that site's own.
page = 1optional1–10Result page, 60 results a page (Yahoo's own page size).
size = anyoptionalany · small · medium · large · extra_largeImage size.
color = anyoptionalany · color · black_and_white · red · orange · yellow · green · teal · blue · purple · pink · brown · black · gray · whiteColour.
type = anyoptionalany · photo · clipart · line_drawing · gif · transparentImage type.
layout = anyoptionalany · square · wide · tallAspect ratio.
people = anyoptionalany · faces · head_and_shoulders · no_peoplePeople in the image.
time = anyoptionalany · day · week · month · yearFound within this period.
license = anyoptionalany · creative_commons · public_domain · free_to_share_and_use · free_to_share_and_use_commercially · free_to_modify_share_and_use · free_to_modify_share_and_use_commerciallyUsage rights.
safesearch = moderateoptionalstrict · moderate · offYahoo SafeSearch. strict hides adult results (a query that only has adult results then answers NOT_FOUND saying so), off shows them.
Try in playground →
post/yahoo-search/v1/videos2 credits

Yahoo video search across YouTube, TikTok, Dailymotion, Vimeo, news sites and more: 60 videos a page with watch URL, title, platform, duration, views, age, description and thumbnail. Length, time, resolution, source and SafeSearch filters.

ParameterAllowed / rangeDescription
queryrequired—What you would type into Yahoo's search box. Operators Yahoo itself understands ("exact phrase", site:, -word) are passed through unchanged.
country = usoptionalus · 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 · veWhich Yahoo country site answers (search.yahoo.com, uk.search.yahoo.com, de.search.yahoo.com, …). Results, ads, news and suggestions are that site's own.
page = 1optional1–10Result page, 60 results a page (Yahoo's own page size).
duration = anyoptionalany · short · medium · longVideo length.
time = anyoptionalany · day · week · month · yearUploaded within this period.
resolution = anyoptionalany · 360p · 480p · 720p · 1080pMinimum resolution.
source = anyoptionalany · youtube · dailymotion · vimeo · mtv · cbs · fox · cnn · msnOnly videos from this site.
safesearch = moderateoptionalstrict · moderate · offYahoo SafeSearch. strict hides adult results (a query that only has adult results then answers NOT_FOUND saying so), off shows them.
Try in playground →
post/yahoo-search/v1/suggest1 credit

Yahoo search-box suggestions (autocomplete) for what has been typed so far, from the chosen country's own suggestion service.

ParameterAllowed / rangeDescription
queryrequired—What has been typed so far.
country = usoptionalus · 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 · veWhich Yahoo country site answers (search.yahoo.com, uk.search.yahoo.com, de.search.yahoo.com, …). Results, ads, news and suggestions are that site's own.
Try in playground →
Built for volume
5M+ requests a day

Measured at 60 requests a second across the fleet, with no central bottleneck. Volume pricing is on request, and per-key limits are raised for high-volume accounts.

Missing a source?
We build it

Tell us a site we do not cover yet and it becomes an engine. A customer asked for bestprice.gr on a Sunday and it was in the catalog the next day.

Support
2 minute median reply

Median time from a question in the live chat to the first answer, measured across every answered conversation. Setup help included, no support tier to buy.

One key, one balance
Every API included

No per-site plans and no separate subscriptions. One key and one credit pool across the whole catalog, so adding a source costs nothing up front.

Planning something large? Tell us the volume and the sources and we will come back with what it costs and what we would have to build.