> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scrapeunblocker.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Search Yahoo

> Searches Yahoo for `keyword` in a real browser and returns the results page as JSON: `topAds`, `bottomAds`, `organic` (each with `position`, `title`, `url`, `displayedUrl`, `domain`, `description`) and `relatedSearches`. Same parameters and response shape as `/serpApi`. `proxy_country` picks Yahoo's regional site and the exit IP, which decides the ads; `language`, when set, restricts results to that language.



## OpenAPI

````yaml /api-reference/openapi.json post /search/yahoo
openapi: 3.1.0
info:
  title: ScrapeUnblocker API
  description: >-
    Public API for the ScrapeUnblocker proxy/anti-bot service. Authenticate
    every request with the `x-scrapeunblocker-key` header. Documented here:
    page-source extraction, Google SERP scraping, image fetch, and the dedicated
    plugin endpoints (search engines, marketplaces, reviews, travel, social and
    more). All other paths exist for internal operations and are intentionally
    hidden from this spec.
  version: 3.0.0
servers:
  - url: https://api.scrapeunblocker.com
    description: Production
security: []
paths:
  /search/yahoo:
    post:
      tags:
        - Plugins
      summary: Search Yahoo
      description: >-
        Searches Yahoo for `keyword` in a real browser and returns the results
        page as JSON: `topAds`, `bottomAds`, `organic` (each with `position`,
        `title`, `url`, `displayedUrl`, `domain`, `description`) and
        `relatedSearches`. Same parameters and response shape as `/serpApi`.
        `proxy_country` picks Yahoo's regional site and the exit IP, which
        decides the ads; `language`, when set, restricts results to that
        language.
      operationId: yahoo_search_search_yahoo_post
      parameters:
        - name: keyword
          in: query
          required: true
          schema:
            type: string
            description: Search terms.
            title: Keyword
          description: Search terms.
        - name: pages_to_check
          in: query
          required: false
          schema:
            type: integer
            maximum: 10
            minimum: 1
            description: How many result pages to collect (1-10, ~10 results each).
            default: 1
            title: Pages To Check
          description: How many result pages to collect (1-10, ~10 results each).
        - name: proxy_country
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: >-
              Country to search from (ISO-2). Sets the result market and the
              exit IP, which decides the ads. Defaults to US.
            title: Proxy Country
          description: >-
            Country to search from (ISO-2). Sets the result market and the exit
            IP, which decides the ads. Defaults to US.
        - name: language
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: Interface language (ISO-639-1, e.g. en, de). Defaults to en.
            title: Language
          description: Interface language (ISO-639-1, e.g. en, de). Defaults to en.
      responses:
        '200':
          description: >-
            JSON with `topAds`, `bottomAds`, `organic`, `relatedSearches` and
            totals, in the same shape as `/serpApi`.
          content:
            application/json:
              schema: {}
        '400':
          description: Invalid parameters.
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
        '502':
          description: Blocked by the search engine or no results page returned.
        '504':
          description: Search timed out.
      security:
        - ScrapeUnblockerKey: []
components:
  schemas:
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    ScrapeUnblockerKey:
      type: apiKey
      in: header
      name: x-scrapeunblocker-key
      description: Your ScrapeUnblocker API key. Apply on every request.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.