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

# Scrape one eBay listing's full detail

> Fetches one eBay listing (by `item_id` + `marketplace`, or `url`) on any supported eBay site and returns it as JSON: `itemId`, `title`, `status` (active / ended), `price` + `currency`, `originalPrice` (list or was price), `listingFormat` (buy_it_now, auction, auction_with_buy_it_now) with `buyItNowPrice`, `currentBid`, `bidCount`, `reserveMet` and `endsAt`, `listingPrice` / `listingCurrency` when the seller lists in another currency, `condition` (with `conditionCode` and the seller's `conditionNotes`), `availability`, `quantityAvailable`, `quantitySold`, `watchers`, `seller` (username, store name, feedback score, positive percentage, business or private), `shippingRates` (cost per destination country), `shipping`, `itemLocation`, `delivery`, `importFees`, `returns`, `brand`, `mpn`, `gtin`, `itemSpecifics`, `categories`, `paymentMethods`, `variationOptions` and `variations` (each with its own price and stock), `images` and the seller's `description` as text.

Labels and texts follow the site's language (ebay.de answers in German). Shipping, delivery dates and, on EU sites, VAT-inclusive prices are quoted for the country the request comes from: pass `proxy_country` to fix it. Companion to `/marketplace/ebay-search`.



## OpenAPI

````yaml /api-reference/openapi.json post /marketplace/ebay-product
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:
  /marketplace/ebay-product:
    post:
      tags:
        - Plugins
      summary: Scrape one eBay listing's full detail
      description: >-
        Fetches one eBay listing (by `item_id` + `marketplace`, or `url`) on any
        supported eBay site and returns it as JSON: `itemId`, `title`, `status`
        (active / ended), `price` + `currency`, `originalPrice` (list or was
        price), `listingFormat` (buy_it_now, auction, auction_with_buy_it_now)
        with `buyItNowPrice`, `currentBid`, `bidCount`, `reserveMet` and
        `endsAt`, `listingPrice` / `listingCurrency` when the seller lists in
        another currency, `condition` (with `conditionCode` and the seller's
        `conditionNotes`), `availability`, `quantityAvailable`, `quantitySold`,
        `watchers`, `seller` (username, store name, feedback score, positive
        percentage, business or private), `shippingRates` (cost per destination
        country), `shipping`, `itemLocation`, `delivery`, `importFees`,
        `returns`, `brand`, `mpn`, `gtin`, `itemSpecifics`, `categories`,
        `paymentMethods`, `variationOptions` and `variations` (each with its own
        price and stock), `images` and the seller's `description` as text.


        Labels and texts follow the site's language (ebay.de answers in German).
        Shipping, delivery dates and, on EU sites, VAT-inclusive prices are
        quoted for the country the request comes from: pass `proxy_country` to
        fix it. Companion to `/marketplace/ebay-search`.
      operationId: ebay_product_marketplace_ebay_product_post
      parameters:
        - name: item_id
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: >-
              eBay item number, e.g. '335761219642' (the number in
              ebay.com/itm/335761219642).
            title: Item Id
          description: >-
            eBay item number, e.g. '335761219642' (the number in
            ebay.com/itm/335761219642).
        - name: url
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: >-
              Instead of `item_id`: a listing link on any supported eBay site,
              e.g. https://www.ebay.de/itm/860089403886. The site is taken from
              the link.
            title: Url
          description: >-
            Instead of `item_id`: a listing link on any supported eBay site,
            e.g. https://www.ebay.de/itm/860089403886. The site is taken from
            the link.
        - name: marketplace
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: >-
              eBay site to open `item_id` on (prices, currency and language
              follow it). One of: ebay.com, ebay.co.uk, ebay.de, ebay.fr,
              ebay.it, ebay.es, ebay.nl, ebay.pl, ebay.at, ebay.ch, ebay.be,
              ebay.ie, ebay.ca, ebay.com.au, ebay.in, ebay.com.sg, ebay.com.my,
              ebay.com.hk. Default ebay.com.
            title: Marketplace
          description: >-
            eBay site to open `item_id` on (prices, currency and language follow
            it). One of: ebay.com, ebay.co.uk, ebay.de, ebay.fr, ebay.it,
            ebay.es, ebay.nl, ebay.pl, ebay.at, ebay.ch, ebay.be, ebay.ie,
            ebay.ca, ebay.com.au, ebay.in, ebay.com.sg, ebay.com.my,
            ebay.com.hk. Default ebay.com.
        - name: include_description
          in: query
          required: false
          schema:
            type: boolean
            description: >-
              Also fetch the seller's description text (a second, light
              request). Set false for a faster call without `description`.
            default: true
            title: Include Description
          description: >-
            Also fetch the seller's description text (a second, light request).
            Set false for a faster call without `description`.
        - name: proxy_country
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: >-
              Proxy country the request is sent from (ISO-2, e.g. 'US', 'DE').
              eBay quotes shipping, delivery dates and, on EU sites,
              VAT-inclusive prices for the visitor's country, so set it to get
              them for one country.
            title: Proxy Country
          description: >-
            Proxy country the request is sent from (ISO-2, e.g. 'US', 'DE').
            eBay quotes shipping, delivery dates and, on EU sites, VAT-inclusive
            prices for the visitor's country, so set it to get them for one
            country.
      responses:
        '200':
          description: JSON with the full listing record under `product`.
          content:
            application/json:
              schema: {}
        '400':
          description: Invalid or missing item_id/url/marketplace.
        '404':
          description: No such eBay listing.
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
        '502':
          description: >-
            Blocked by eBay on every attempt, no listing data returned, or the
            call did not finish in time.
      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.