# Yahoo search: `POST /v1/yahoo/search`

Cost: 2 credits (2 per page (an empty page and failed requests are free)). Docs: https://scrapercompany.com/docs/reference/yahoo-search

One page of Yahoo organic results, 7 a page.

Each result has its position, title, destination `link`, the displayed
address, the site name, the snippet and the date Yahoo shows for it.
Ads are left out. `related_searches` carries Yahoo's own suggestions.
`region` picks the Yahoo country site (`uk`, `de`, `fr` …); `time` keeps
pages from the past day, week or month. A query with no results answers an empty list
and is not billed; a failed call is 503 with
`Retry-After` and is not billed.

Request body (JSON):

- `q` (string; required; min length 1, max length 500): Search query.
- `region` (string | null; optional; one of us, uk, gb, ca, ie, in, sg, ph, my, id, de, at, ch, fr, es, it, nl, se, dk, no, fi, pl, br, mx, ar, cl, co, pe, ve, hk, tw, vn, ru, tr, gr): Yahoo country site (two-letter code, default 'us'): results in that country's language and index.
- `time` (string | null; optional; one of d, w, m): Only pages from the past day (d), week (w) or month (m).
- `page` (integer; optional; default 1; min 1, max 100): Result page (7 results a page).

Base URL: `https://api.scrapercompany.com`. Auth: send your key in the `x-api-key` header. A failed request (4xx or 5xx) or an empty result costs 0 credits.

- [Full API reference as one Markdown file](https://scrapercompany.com/llms-full.txt)
- [OpenAPI spec](https://scrapercompany.com/openapi.json)
