# Yahoo Web Search

Retrieve Yahoo web search results for a query. Returns organic results with position, title, link, displayed link and snippet, plus people also ask, a videos carousel, an AI answer when Yahoo serves one, related searches, ads and pagination. Results are paginated with the b parameter (offset, step 7); has_more comes from the pager of the same page.

- **Documentation:** [https://scrappa.co/docs/yahoo-search-api/yahoo_search](https://scrappa.co/docs/yahoo-search-api/yahoo_search)
- **API group:** Yahoo Search API
- **Endpoint:** `GET https://scrappa.co/api/yahoo/search`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `p` | string | Yes | The search query (e.g., "climate change") |
| `b` | integer | No | 1-based result offset, step 7. Omit or pass 1 for the first page; pass 8 for page 2, 15 for page 3. |
| `pz` | integer | No | Results per page (fixed 7) |
| `vm` | string | No | Safe search: r = strict, i = moderate, p = off |
| `vc` | string | No | Country/region (2-letter cc, e.g. "us") |
| `vl` | string | No | Language (e.g., "en-US") |
| `fr2` | string | No | Tracking surface id (e.g., "piv-web") |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/yahoo/search?p=climate+change"
```

## Example response

```json
{
    "search_parameters": {
        "p": "climate change",
        "b": 1,
        "pz": 7
    },
    "organic_results": [
        {
            "position": 1,
            "title": "Climate change - Wikipedia",
            "link": "https://en.wikipedia.org/wiki/Climate_change",
            "displayed_link": "https://en.wikipedia.org \u203a wiki \u203a Climate_change",
            "snippet": "Present-day climate change includes both global warming \u2014the ongoing increase in global average temperature \u2014and its wider effects on Earth's climate system."
        }
    ],
    "people_also_ask": [
        {
            "question": "What are the steps of climate change?",
            "answer": "Climate change occurs through a series of interconnected processes that alter the Earth's climate system."
        }
    ],
    "videos_carousel": [
        {
            "title": "How the World Reacted as Global Warming Warnings Grew | Heat (full documentary) | FRONTLINE (PBS)",
            "link": "https://www.youtube.com/watch?v=DSEkygwmh3A",
            "thumbnail": "https://up.yimg.com/ib/th/id/OVF.j2JRq7Ih0XwnvxQTPU5PKw?pid=Api&w=296&h=156&c=7&p=0&rs=1&qlt=95"
        }
    ],
    "ai_answer": null,
    "related_searches": [
        {
            "query": "climate change definition"
        }
    ],
    "ads": [],
    "pagination": {
        "offset": 1,
        "has_more": true,
        "next_offset": 8
    },
    "response_time_ms": 1290
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 400 | Missing required query parameter |  |
| 422 | Invalid b, pz, vm, vc, vl or fr2 parameter |  |
| 502 | Yahoo returned an unexpected response shape |  |
| 503 | Yahoo Search is temporarily unavailable |  |
| 503 | Yahoo is rate limiting requests |  |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)