> ## 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 Images

> Runs Yahoo Images for `q` in a real browser and returns the image results as JSON, in the same shape as `/images/google-search`. Every result carries `imageUrl` (the origin image, not a thumbnail), `sourceDomain`, `sourcePageUrl`, `title`, `sourceName`, `thumbnailUrl`, `width`, `height` and `yahooImagesUrl` (Yahoo's image viewer link). `pages` fetches up to 10 result pages of ~60 each; every page fetched is billed as one request.



## OpenAPI

````yaml /api-reference/openapi.json post /images/yahoo-search
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:
  /images/yahoo-search:
    post:
      tags:
        - Plugins
      summary: Search Yahoo Images
      description: >-
        Runs Yahoo Images for `q` in a real browser and returns the image
        results as JSON, in the same shape as `/images/google-search`. Every
        result carries `imageUrl` (the origin image, not a thumbnail),
        `sourceDomain`, `sourcePageUrl`, `title`, `sourceName`, `thumbnailUrl`,
        `width`, `height` and `yahooImagesUrl` (Yahoo's image viewer link).
        `pages` fetches up to 10 result pages of ~60 each; every page fetched is
        billed as one request.
      operationId: yahoo_images_images_yahoo_search_post
      parameters:
        - name: q
          in: query
          required: true
          schema:
            type: string
            description: Image search term, e.g. 'eiffel tower'.
            title: Q
          description: Image search term, e.g. 'eiffel tower'.
        - name: pages
          in: query
          required: false
          schema:
            type: integer
            maximum: 10
            minimum: 1
            description: >-
              How many Yahoo Images result pages to fetch (1-10, ~60 results
              each). Each page fetched is billed as one request.
            default: 1
            title: Pages
          description: >-
            How many Yahoo Images result pages to fetch (1-10, ~60 results
            each). Each page fetched is billed as one request.
        - name: max_results
          in: query
          required: false
          schema:
            anyOf:
              - type: integer
                maximum: 600
                minimum: 1
              - type: 'null'
            description: >-
              Optional cap on the number of results returned (default: all
              results of the fetched pages).
            title: Max Results
          description: >-
            Optional cap on the number of results returned (default: all results
            of the fetched pages).
        - name: proxy_country
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: >-
              Country to search from (ISO-2); picks Yahoo's regional site.
              Defaults to US.
            title: Proxy Country
          description: >-
            Country to search from (ISO-2); picks Yahoo's regional site.
            Defaults to US.
      responses:
        '200':
          description: JSON with a `results` array plus the query and counts.
          content:
            application/json:
              schema: {}
        '400':
          description: Invalid parameters.
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
        '502':
          description: Blocked by Yahoo or no image results 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.