> ## 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 AliExpress product

> Returns one AliExpress item by `product_id` or `url`, priced in `currency` and shipped to `country`, as JSON: `productId`, `url`, `title`, `price` (the default SKU), `priceMin` / `priceMax` across SKUs, `priceFormatted`, `originalPrice` / `originalPriceMax`, `discount` and `discountPercent`, `currency`, `rating`, `reviewCount`, `soldText` and `orders`, `inStock`, `store` (name, ids, link, country, open since, positive feedback, ratings), `shipping` (each option: method, fee, free, ships from / to, delivery days and dates, deliverable), `skuProperties` (e.g. colour, size, ships from, with images), `variants` (every SKU with its attributes, price, original price, availability, stock and image), `specifications`, `images`, `categoryId` and `descriptionUrl` (the seller's HTML description). One unit per call.



## OpenAPI

````yaml /api-reference/openapi.json post /goods/aliexpress-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:
  /goods/aliexpress-product:
    post:
      tags:
        - Plugins
      summary: Scrape one AliExpress product
      description: >-
        Returns one AliExpress item by `product_id` or `url`, priced in
        `currency` and shipped to `country`, as JSON: `productId`, `url`,
        `title`, `price` (the default SKU), `priceMin` / `priceMax` across SKUs,
        `priceFormatted`, `originalPrice` / `originalPriceMax`, `discount` and
        `discountPercent`, `currency`, `rating`, `reviewCount`, `soldText` and
        `orders`, `inStock`, `store` (name, ids, link, country, open since,
        positive feedback, ratings), `shipping` (each option: method, fee, free,
        ships from / to, delivery days and dates, deliverable), `skuProperties`
        (e.g. colour, size, ships from, with images), `variants` (every SKU with
        its attributes, price, original price, availability, stock and image),
        `specifications`, `images`, `categoryId` and `descriptionUrl` (the
        seller's HTML description). One unit per call.
      operationId: aliexpress_product_goods_aliexpress_product_post
      parameters:
        - name: product_id
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: >-
              AliExpress item id, e.g. '1005010503016514' (the number in
              /item/<id>.html; `productId` from /goods/aliexpress-search).
            title: Product Id
          description: >-
            AliExpress item id, e.g. '1005010503016514' (the number in
            /item/<id>.html; `productId` from /goods/aliexpress-search).
        - name: url
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: >-
              Instead of `product_id`: an AliExpress item link, e.g.
              https://www.aliexpress.com/item/1005010503016514.html (any
              storefront: .com, .us, de., fr. ...).
            title: Url
          description: >-
            Instead of `product_id`: an AliExpress item link, e.g.
            https://www.aliexpress.com/item/1005010503016514.html (any
            storefront: .com, .us, de., fr. ...).
        - name: country
          in: query
          required: false
          schema:
            type: string
            description: >-
              Ship-to country (ISO-2, e.g. 'US', 'DE', 'GB'). Shipping options,
              delivery times and whether the item is sold at all depend on it.
            default: US
            title: Country
          description: >-
            Ship-to country (ISO-2, e.g. 'US', 'DE', 'GB'). Shipping options,
            delivery times and whether the item is sold at all depend on it.
        - name: currency
          in: query
          required: false
          schema:
            type: string
            description: >-
              Price currency, e.g. 'USD', 'EUR', 'GBP'. One of: USD, EUR, GBP,
              CAD, AUD, NZD, CHF, SEK, NOK, DKK, PLN, CZK, HUF, RON, BGN, TRY,
              ILS, AED, SAR, JPY, KRW, SGD, MYR, THB, IDR, PHP, VND, INR, BRL,
              MXN, CLP, COP, PEN, ZAR, UAH, KZT.
            default: USD
            title: Currency
          description: >-
            Price currency, e.g. 'USD', 'EUR', 'GBP'. One of: USD, EUR, GBP,
            CAD, AUD, NZD, CHF, SEK, NOK, DKK, PLN, CZK, HUF, RON, BGN, TRY,
            ILS, AED, SAR, JPY, KRW, SGD, MYR, THB, IDR, PHP, VND, INR, BRL,
            MXN, CLP, COP, PEN, ZAR, UAH, KZT.
      responses:
        '200':
          description: JSON with the product.
          content:
            application/json:
              schema: {}
        '400':
          description: Missing or invalid product_id/url/country/currency.
        '404':
          description: >-
            No such AliExpress item, or AliExpress does not sell it to
            `country`.
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
        '502':
          description: >-
            Blocked by AliExpress on every attempt, an unusable answer, or no
            answer 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.