# Yahoo Search (/docs/yahoo) Search the web with Yahoo Search and get organic results with their position, title, link, domain and snippet Yahoo Search is a web search engine. This endpoint returns its organic results for a query in the same rows as [Bing](/docs/bing.md) and [DuckDuckGo](/docs/duckduckgo.md): `position`, `title`, `url`, `displayed_url`, `domain`, `site_name`, `snippet` and `date`, so one parser reads every engine. Base URL: `/v1/yahoo/...` Yahoo Search exposes 1 routes here. ## Quickstart ### Search Pass your search terms as `query`. ```bash title="cURL" curl "https://www.socialcrawl.dev/v1/yahoo/search?query=heat%20pump%20efficiency" \ -H "x-api-key: YOUR_API_KEY" ``` ```json title="Response (trimmed)" { "success": true, "data": { "items": [ { "position": 1, "title": "…", "url": "https://…", "domain": "…", "snippet": "…" } ], "next_cursor": "2" } } ``` ### Read the next page Pass the returned `next_cursor` as `cursor`. ```bash title="cURL" curl "https://www.socialcrawl.dev/v1/yahoo/search?query=heat%20pump%20efficiency&cursor=2" \ -H "x-api-key: YOUR_API_KEY" ``` ## Questions people ask ### How do I get the next page? Pass the `next_cursor` of a page back as `cursor`. Yahoo decides how many results a page holds, so the cursor names where the next page starts. ### Can I get regional results? Yes. `country` takes a two-letter code such as `us` or `uk` for that country's Yahoo results. `safe_search` takes `strict`, `moderate` or `off`. ### What is `date`? The date Yahoo prints for the result, exactly as it prints it, or null when it prints none. It is never reformatted. ### Does it return ads? No. Only the organic results. ## All endpoints **How far back and how deep** Each list returns one page at a time. Send `cursor` for the next page, or `max_items` or `max_pages` to collect several pages in one call. A page size appears only where it has been verified. [How paging works](/docs/pagination.md). | Path | Rows per page | Date window | One call collects | | --- | --- | --- | --- | | `/v1/yahoo/search` | varies | none | up to 5,000 rows or 50 pages | **Country and region** `country` and `region` do different jobs on different endpoints. Each line below says what the parameter does there. [How they differ](/docs/data-availability.md#country-and-region). - `country` on `/v1/yahoo/search`: Two-letter country for regional results, for example us or uk. ## Next steps - [Bing](/docs/bing.md): The same rows from Bing, with rank checks. - [Pagination](/docs/pagination.md): How cursors work across every list endpoint.