100 free credits. No credit card required.Start building
Logo
Yahoo Search logoYahoo Search API

Get Yahoo Search results with one API

Search the web with Yahoo Search and get each result's position, title, link, domain and snippet as structured JSON with one SocialCrawl API key. Reads are priced in credits.

Yahoo Search logo
/v1/yahoo

1 active endpoint. Web search.

  • GET /v1/yahoo/search

What Yahoo Search endpoints does SocialCrawl ship?

One read endpoint for Yahoo Search's organic results, one results page at a time, sized by Yahoo.

Web search

1 credit
/v1/yahoo/search

Yahoo's organic results for a query, one results page at a time, sized by Yahoo, each with its position, title, link, the date Yahoo shows and domain. Filter by country and safe search. Standard tier (1 credit).

query, country, safe_search, cursor

Yahoo Search API1 endpoint supported
View docs
Search

Returns Yahoo Search's organic results for a query, page by page, each with its position, title, link, domain, snippet and the date Yahoo shows.

Use it to compare Yahoo's results with other engines or to track a site's rank on Yahoo by country.

1 credit

GET/v1/yahoo/search?query=heat+pump+efficiency

query · The search, up to 2,000 characters, for example heat pump efficiency.

$ curl https://www.socialcrawl.dev/v1/yahoo/search?query=heat+pump+efficiency \
    -H "x-api-key: sc_YOUR_API_KEY"
idle
// Running this live needs your own API key. Hit "Try it" to see an example response

How the Yahoo Search API works

Yahoo Search is a normal SocialCrawl data surface. You call GET /v1/yahoo/search with an API key, spend credits on live misses, and get a single JSON envelope back.

Authenticate every call

Send your key in the x-api-key header. No Yahoo account is needed. The same key works across SocialCrawl platforms.

GET with query params

Search takes query, country, safe_search, cursor. Formats are validated before any charge.

Pay in credits, not seats

Every Yahoo search page costs 1 credit. Cache hits cost 0.

Read one JSON envelope

Every response is the same shape: success, data, credits_used, credits_remaining, request_id, cached. Search pages carry a next_cursor while there is more.

The usual integration chain

Most products search once for the terms they track, then page through as deep as they need.

01Search
GET /v1/yahoo/search?query=…

the first results page with positions and links

See what ranks for the query, and where a site sits.

02Page through the results
GET /v1/yahoo/search?query=…&cursor=…

the next page from next_cursor

Reach deeper positions for the same query.

request
GET /v1/yahoo/search?query=heat%20pump%20efficiency
Host: www.socialcrawl.dev
x-api-key: sc_your_api_key_here
response envelope
{
  "success": true,
  "data": {
    "items": [
      {
        "position": 1,
        "title": "…",
        "url": "https://…",
        "domain": "…",
        "snippet": "…"
      }
    ],
    "next_cursor": "2"
  },
  "credits_used": 1,
  "credits_remaining": 9999,
  "request_id": "req_…",
  "cached": false
}

What lands in data

The rows match GET /v1/bing/search and /v1/duckduckgo/search, so one parser reads every engine.

SearchResultsearch

items[] with position, title, url, displayed_url, domain, site_name, snippet, date; next_cursor, total_results, related_searches

Inside the gateway

Same request lifecycle as every other /v1 platform endpoint. Yahoo Search is not a sidecar.

  1. 01

    Edge receives the call

    Next.js catch-all routes into the Hono social API. We mint a request_id, authenticate the key, then enforce rate limit (600/min) and concurrency (50 in flight per key).

  2. 02

    Validate, then debit

    Registry lookup finds the yahoo route. Required params and format checks run first. Invalid input returns 400 with no charge. Valid calls debit the tier cost atomically before the read starts.

  3. 03

    Cache or fetch

    A deterministic cache key is built from platform + resource + params. Hit: return immediately, credits_used = 0. Miss: the public results page is read live, with a retry when a read hangs and a circuit breaker if the source is unhealthy.

  4. 04

    Normalize and return

    The results are mapped to the shared web search rows, validated, then wrapped in the success envelope and logged for billing audit.

Billing rules that matter in production

  • search: 1 credit a page
  • Cache hit: 0 credits
  • Empty / hard fail: auto-refund
  • Bad params: 400, never charged
  • No credits: 402, never charged
  • Next page by cursor
  • Organic results only
  • landings.platformBrief.platforms.yahoo.api.billingRules.7
  • landings.platformBrief.platforms.yahoo.api.billingRules.8

How SocialCrawl gets Yahoo Search data

Yahoo Search results pages are public. We normalize them into the SocialCrawl schema so your code does not learn a second vendor SDK.

What Yahoo Search is for this API

Yahoo Search results, in the regional edition you pick by country.

How SocialCrawl reaches it

Public data is read on request and normalized server-side, within each source's published usage rules.

What leaves our edge

The shared web search rows: position, title, link, address, domain, snippet and date, the same as Bing and DuckDuckGo.

What we do not ship live

No ads, no account data and no search history.

field map sketch
position, title, link→ items[].position, title, urlposition, title, link
address shown, domain→ items[].displayed_url, domainaddress shown, domain
snippet, date shown→ items[].snippet, datesnippet, date shown

What this API is used for

The jobs this API is most often used for.

1active Yahoo Search endpoints in the registry
1credit per Yahoo search page

Rank tracking on Yahoo and comparing engines

Callers search the terms they track on a schedule and record where each site sits. Yahoo results in the same rows as Bing and DuckDuckGo, from the same key as the rest of the catalog.

Live misses read the public results page on request. Repeat calls hit cache and cost 0 credits.

Use case examples

Common ways teams put this data to work, and the stack each one tends to run.

Rank tracking

Python, scheduled jobs

search the tracked terms each day and record a site's position on Yahoo.

Engine comparison

Node, dashboards

run the same query on Yahoo, Bing and DuckDuckGo and compare who ranks where.

AI agents

TypeScript, tool calls

give an agent Yahoo results as a search tool, with links it can read next.

How to call the Yahoo Search API

Every Yahoo search page is 1 credit. Cache hits are free.

curl "https://www.socialcrawl.dev/v1/yahoo/search?query=heat%20pump%20efficiency" \
  -H "x-api-key: sc_your_api_key_here"
Yahoo Search logoYahoo Search on SocialCrawl

Same key as the rest of the catalog

Endpoints

What data does the Yahoo Search API return?

Every endpoint returns structured JSON in a unified envelope. Computed fields such as engagement rate and content category are included only where the endpoint supports them and the required source inputs are present.

FAQ

Have a question? We got answers

Find answers to frequently asked questions about SocialCrawl's API, pricing, and capabilities.

Contact us
What does the SocialCrawl Yahoo Search API cover?
It covers 1 endpoint: Search. It returns Yahoo's organic web results in the same unified JSON as the other 94 platforms.
What does each result include?
Its position, title, link, the address as Yahoo shows it, the domain, the snippet and the date when Yahoo prints one. The rows match the Bing and DuckDuckGo search endpoints.
How many results come back per call?
One results page at a time, sized by Yahoo. Pass the returned cursor for the next page.
Does it include ads?
No. Only the organic results are returned.
How much does it cost?
Each results page costs 1 credit, cache hits are free, and bad parameters return 400 without a charge. You start with 100 free credits.
Is scraping Yahoo Search data legal?
SocialCrawl returns publicly available Yahoo Search data and does not access private or login-gated content. Whether scraping fits your project depends on your use case and jurisdiction. You are responsible for complying with Yahoo Search's terms of service and applicable data-protection laws such as GDPR and CCPA. This is general information, not legal advice.
Yahoo Search scraping API vs the official Yahoo Search API: what's the difference?
With SocialCrawl there is no app review or approval queue. Sign up and call Yahoo Search endpoints immediately with a single x-api-key. Responses share one unified schema with every other SocialCrawl platform, and credit-based pricing replaces per-platform quotas. Official APIs are still the right choice for posting and other write actions: SocialCrawl is read-only data.

Ask AI about SocialCrawl

Read the Yahoo Search API reference in the docs

🤖 AI agent or LLM? Read this page as markdown