> ## 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 an Amazon seller profile

> Returns an Amazon third-party seller's public profile as JSON: `name`, `logo`, `storefrontUrl`, the headline `rating`, `ratingCount` and `positivePercent` Amazon shows (the last 12 months, or lifetime for a seller with few recent ratings; `ratingPeriod` says which), and `feedbackSummary` for `30d`, `90d`, `12m` and `lifetime` - each with the average `rating`, `ratingCount`, `positivePercent` / `neutralPercent` / `negativePercent` (4-5, 3 and 1-2 stars), the matching counts and the 5..1-star histogram. Also `about` (the seller's own description), `businessName`, `businessAddress` (+ `businessAddressLines`), `businessDetails` (every row of Amazon's "Detailed Seller Information", e.g. business type, trade register and VAT number where the marketplace shows them), `contactUrl` and `recentFeedback` (each with `rating`, `text`, `author`, `date`, `struckThrough` and `amazonMessage` when Amazon took responsibility for the order).

Identify the seller with `seller_id` (plus `marketplace`), e.g. the `sellerId` of an offer from `/marketplace/amazon-offers`, or with any Amazon `url` naming the seller. Ratings are per marketplace. Amazon's own retail sellers show no ratings; those fields are null.



## OpenAPI

````yaml /api-reference/openapi.json post /marketplace/amazon-seller
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/amazon-seller:
    post:
      tags:
        - Plugins
      summary: Scrape an Amazon seller profile
      description: >-
        Returns an Amazon third-party seller's public profile as JSON: `name`,
        `logo`, `storefrontUrl`, the headline `rating`, `ratingCount` and
        `positivePercent` Amazon shows (the last 12 months, or lifetime for a
        seller with few recent ratings; `ratingPeriod` says which), and
        `feedbackSummary` for `30d`, `90d`, `12m` and `lifetime` - each with the
        average `rating`, `ratingCount`, `positivePercent` / `neutralPercent` /
        `negativePercent` (4-5, 3 and 1-2 stars), the matching counts and the
        5..1-star histogram. Also `about` (the seller's own description),
        `businessName`, `businessAddress` (+ `businessAddressLines`),
        `businessDetails` (every row of Amazon's "Detailed Seller Information",
        e.g. business type, trade register and VAT number where the marketplace
        shows them), `contactUrl` and `recentFeedback` (each with `rating`,
        `text`, `author`, `date`, `struckThrough` and `amazonMessage` when
        Amazon took responsibility for the order).


        Identify the seller with `seller_id` (plus `marketplace`), e.g. the
        `sellerId` of an offer from `/marketplace/amazon-offers`, or with any
        Amazon `url` naming the seller. Ratings are per marketplace. Amazon's
        own retail sellers show no ratings; those fields are null.
      operationId: amazon_seller_marketplace_amazon_seller_post
      parameters:
        - name: seller_id
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: >-
              Amazon seller (merchant) id, e.g. 'A3PEV2IAOYFKM6' - the
              `sellerId` of an offer from /marketplace/amazon-offers. Give
              either `seller_id` (with `marketplace`) or a `url`.
            title: Seller Id
          description: >-
            Amazon seller (merchant) id, e.g. 'A3PEV2IAOYFKM6' - the `sellerId`
            of an offer from /marketplace/amazon-offers. Give either `seller_id`
            (with `marketplace`) or a `url`.
        - name: url
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: >-
              Any Amazon url that names the seller: the profile
              ('https://www.amazon.de/sp?seller=A1J6G6R957S11K'), a storefront
              ('/s?me=...') or a sold-by link. The seller id and marketplace are
              read from it.
            title: Url
          description: >-
            Any Amazon url that names the seller: the profile
            ('https://www.amazon.de/sp?seller=A1J6G6R957S11K'), a storefront
            ('/s?me=...') or a sold-by link. The seller id and marketplace are
            read from it.
        - name: marketplace
          in: query
          required: false
          schema:
            type: string
            description: >-
              Regional Amazon site the seller sells on. Ratings and feedback are
              per marketplace. One of: amazon.com, amazon.co.uk, amazon.de,
              amazon.fr, amazon.it, amazon.es, amazon.nl, amazon.se, amazon.pl,
              amazon.com.be, amazon.com.tr, amazon.ca, amazon.com.mx,
              amazon.com.br, amazon.co.jp, amazon.in, amazon.ae, amazon.sa,
              amazon.sg, amazon.com.au.
            default: amazon.com
            title: Marketplace
          description: >-
            Regional Amazon site the seller sells on. Ratings and feedback are
            per marketplace. One of: amazon.com, amazon.co.uk, amazon.de,
            amazon.fr, amazon.it, amazon.es, amazon.nl, amazon.se, amazon.pl,
            amazon.com.be, amazon.com.tr, amazon.ca, amazon.com.mx,
            amazon.com.br, amazon.co.jp, amazon.in, amazon.ae, amazon.sa,
            amazon.sg, amazon.com.au.
        - 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').
              Optional: a seller profile is the same from every country, so by
              default any country is used.
            title: Proxy Country
          description: >-
            Proxy country the request is sent from (ISO-2, e.g. 'US', 'DE').
            Optional: a seller profile is the same from every country, so by
            default any country is used.
      responses:
        '200':
          description: Seller profile parsed.
          content:
            application/json:
              schema: {}
        '400':
          description: No/invalid seller id or url, or unsupported marketplace.
        '404':
          description: Amazon has no seller profile with this id on this marketplace.
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
        '502':
          description: >-
            Blocked by Amazon, no profile page 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.