Skip to content

New AI assistant answers: ChatGPT, Gemini, Copilot and AI Mode by API

SerpKite
Get API key

POST /v1/search · engine=yahoo

Yahoo Search API

Yahoo's web results as JSON through /v1/search. Add engine: "yahoo" and get organic results with destination URLs, snippets and related searches, in the same shape as Google.

Get a free API key Try in playground
1 credit per page of results 2,500 free credits, no card Failed calls are free

Overview

What the Yahoo Search API does

Yahoo's web results come largely from Bing's index, presented through Yahoo's own results page; Yahoo News is its own news search. Use it as an extra Bing-backed source, or for Yahoo News coverage of a topic.

/v1/search with engine: "yahoo" returns Yahoo's organic results with title, link (the destination, not a Yahoo redirect), domain, displayed_link, snippet and published_at when Yahoo shows a date, plus related_searches.

What you get

results[] array
Organic results: position, title, link (the destination URL), domain, displayed_link, snippet, and date / published_at when the engine shows one.
related_searches[] array
Related queries, when the engine shows them.
meta object
request_id, credits_used, cached, latency_ms, parse_quality, engine (the provider that answered) and route (each provider attempt with outcome and ms).

Request

curl https://api.serpkite.com/v1/search \
  -H "Authorization: Bearer $SERPKITE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"q":"espresso machine","engine":"yahoo"}'

Response (live response, trimmed)

200 OK · Yahoo web search · live response, trimmed 
{
  "request": {
    "country": "us",
    "endpoint": "search",
    "engine": "yahoo",
    "language": "en",
    "num": 10,
    "page": 1,
    "q": "espresso machine"
  },
  "results": [
    {
      "displayed_link": "https://www.amazon.com › Espresso-Machines-Coffee-Tea",
      "domain": "amazon.com",
      "link": "https://www.amazon.com/Espresso-Machines-Coffee-Tea-Kitchen/b?node=289748",
      "position": 1,
      "snippet": "Discover Espresso Machines on Amazon.com at a great price. Our Small Appliances category offers a great selection of Espresso Machines and more. Free Shipping on Prime eligible orders.",
      "title": "Amazon.com: Espresso Machines: Home & Kitchen: Super ..."
    },
    {
      "date": "6 days ago",
      "displayed_link": "https://www.forbes.com › article › best-espresso-machine",
      "domain": "forbes.com",
      "link": "https://www.forbes.com/sites/forbes-personal-shopper/article/best-espresso-machine/",
      "position": 2,
      "published_at": "2026-10-17",
      "snippet": "For devotees of handcrafted café beverages, investing in an espresso machine can save both time and money (particularly in the long run). To find the best espresso machines, our staff—along ...",
      "title": "Best Espresso Machines 2026 | Tested - Forbes Vetted"
    }
  ],
  "related_searches": [
    {
      "query": "ninja espresso machine"
    },
    {
      "query": "philips espresso machine"
    }
  ],
  "meta": {
    "request_id": "req_01J8ZK4M6Q2V7",
    "credits_used": 1,
    "cached": false,
    "engine": "yahoo",
    "route": [
      {
        "provider": "yahoo",
        "outcome": "ok",
        "ms": 2426
      }
    ],
    "latency_ms": 2437,
    "parse_quality": "ok"
  }
}

Every response also carries X-Credits-Used, X-Credits-Remaining, X-Cache and X-Tokens-Estimate headers. Run this query in the playground

One key, many engines

Yahoo through SerpKite

  • Same key, same envelope and the same SDK call as Google: only engine changes.
  • meta.engine names the provider that answered and meta.route lists every attempt. A result is never relabelled.
  • engine: "auto" keeps Google first and falls back to Yahoo and the other engines only when Google fails. How fallback works
  • Failed, blocked and empty attempts are free; you pay only for the provider that answered.

Everything Yahoo serves on SerpKite

See all engines on the multi-engine search page or in the providers reference.

engine=auto answered by Yahoo (illustrative)

meta.route 
{
  "request": {
    "endpoint": "search",
    "engine": "auto",
    "q": "espresso machine"
  },
  "meta": {
    "engine": "yahoo",
    "route": [
      {
        "provider": "google",
        "outcome": "blocked",
        "ms": 2140
      },
      {
        "provider": "yahoo",
        "outcome": "ok",
        "ms": 640
      }
    ]
  }
}

Reference

Parameters

The parameters /v1/search accepts, in the JSON body or the query string.

Yahoo Search API parameters
Name Type Default Description
q required string – The search query. Required. Up to 2,048 characters.
engine string | string[] google "yahoo" for this page. "auto" tries Google first and falls back to other engines; a list such as ["google", "yahoo"] limits the route to those engines.
country string us Country to search from, as a two-letter ISO code (us, gb, de, in…). Defaults to the country a location ends in.
language string en Interface language, as a language code with an optional region (en, de, pt-BR, zh-TW…).
num integer 10 Results per call, 1–100. Up to 10 returns one page of 10 (1 credit); above 10 on search and news fetches whole pages as a depth bundle, and 100 costs 7 credits instead of 10. On images a page holds up to 100 images and num (default all) is how many of them come back.
page integer 1 Results page, 1–10. Each page is billed separately.
include_domains string[] – Only results from these sources, up to 20: a domain (example.com, subdomains match), a path prefix (github.com/org) or a TLD (.gov). Compiled to site: operators and enforced on the results. Search, news, images, videos.
exclude_domains string[] – Drop results from these sources, up to 20, same formats as include_domains. Search, news, images, videos.
format string json Response format. markdown is LLM-ready prose; compact is JSON with only the fields agents need. Values: json, compact, markdown.
fields string – Comma-separated projection, e.g. results.title,results.link,knowledge_graph. Cuts tokens.
max_age integer – Accept a cached result up to this many seconds old. Cache hits cost 50% of the credits.

Full reference, error codes and headers are in the /v1/search reference. Queue up to 100 requests at half price with POST /v1/batches.

Use cases

What people build with the Yahoo Search API

01

Media monitoring

Track how a brand or topic appears on Yahoo's results and news pages.

02

One more fallback

engine=auto can fall back to Yahoo when Google and other engines are unavailable.

03

Cross-engine checks

Compare Yahoo's ranking with Google's and Bing's for the same query.

Pricing

Yahoo Search API pricing

Cost per call

1 credit

per page of results

  • From $0.60 per 1,000 calls at volume.
  • Credits never expire. No subscription.
  • Failed, empty and blocked calls are refunded.
  • 2,500 free credits = 2,500 calls, then 1,000 credits a month.

For reference: Serper lists Google searches at $1.00 per 1k on its entry tier and $0.30 at its best tier, and its credits expire after 6 months. SerpKite credits cost $1.00 to $0.60 per 1k.

See all pricing
Yahoo Search API cost per pack
Pack Price Per 1k credits Per 1k calls Calls per pack
Starter $10 $1.00 $1.00 10,000
Growth $50 $0.80 $0.80 62,500
Pro $300 $0.60 $0.60 500,000

FAQ

Yahoo Search API: common questions

Keep exploring

Related APIs and integrations

Yahoo News API Yahoo News search: articles with source, date and image. Google Search API Organic results, knowledge graph, answer box, PAA and related searches.

Use it from

Start building

Start with the Yahoo Search API

2,500 free credits, then 1,000 every month. No credit card.

Get a free API key Try in playground