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

# /aliexpress/products

> Get a single AliExpress product by id or product URL. Returns title, images, sale and original price, rating, review count, sold summary, available quantity, category ids, description URL, the seller store (name, country, opening date, positive feedback rate and count, seller level and score, service ratings), the shipping option for the requested locale (price, provider, delivery window), every SKU variant with its readable properties, price, stock, availability and image, and the full specification list.

**Price:** 5 credits

**⚠️ Common errors:** 412: Product not found or no longer listed on AliExpress



## OpenAPI

````yaml /openapi/e-commerce-marketplaces.json post /api/aliexpress/products
openapi: 3.1.0
info:
  title: Any Site API
  description: >+
    Any Site API provides programmatic access to data from LinkedIn, Instagram,
    Twitter, and other platforms.


    ## Authentication


    All API endpoints require an `access-token` header with a valid API token.
    Tokens can be created in the [dashboard](https://app.anysite.io/).


    ## Pricing


    Each endpoint has a credit cost listed in its description. Credits are
    deducted from your token balance per request.

  version: 0.0.1
servers: []
security:
  - AccessToken: []
paths:
  /api/aliexpress/products:
    post:
      tags:
        - /aliexpress
      summary: /aliexpress/products
      description: >-
        Get a single AliExpress product by id or product URL. Returns title,
        images, sale and original price, rating, review count, sold summary,
        available quantity, category ids, description URL, the seller store
        (name, country, opening date, positive feedback rate and count, seller
        level and score, service ratings), the shipping option for the requested
        locale (price, provider, delivery window), every SKU variant with its
        readable properties, price, stock, availability and image, and the full
        specification list.


        **Price:** 5 credits


        **⚠️ Common errors:** 412: Product not found or no longer listed on
        AliExpress
      operationId: __api_aliexpress_products_post
      parameters:
        - name: access-token
          in: header
          required: true
          schema:
            anyOf:
              - type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AliexpressProductsPayload'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/AliexpressProduct'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    AliexpressProductsPayload:
      properties:
        timeout:
          type: integer
          maximum: 1500
          minimum: 20
          default: 300
        language:
          $ref: '#/components/schemas/AliexpressLanguage'
          default: en_US
        currency:
          $ref: '#/components/schemas/AliexpressCurrency'
          default: USD
        product:
          type: string
          minLength: 1
      type: object
      required:
        - product
    AliexpressProduct:
      properties:
        '@type':
          type: string
          default: AliexpressProduct
        id:
          type: string
        product_url:
          type: string
        product_title:
          anyOf:
            - type: string
            - type: 'null'
        image:
          anyOf:
            - type: string
            - type: 'null'
        images:
          items:
            type: string
          type: array
          default: []
        price:
          anyOf:
            - type: number
            - type: 'null'
        price_text:
          anyOf:
            - type: string
            - type: 'null'
        original_price:
          anyOf:
            - type: number
            - type: 'null'
        original_price_text:
          anyOf:
            - type: string
            - type: 'null'
        currency:
          anyOf:
            - type: string
            - type: 'null'
        rating:
          anyOf:
            - type: number
            - type: 'null'
        review_count:
          anyOf:
            - type: integer
            - type: 'null'
        sold_text:
          anyOf:
            - type: string
            - type: 'null'
        available_quantity:
          anyOf:
            - type: integer
            - type: 'null'
        max_purchase_quantity:
          anyOf:
            - type: integer
            - type: 'null'
        category_ids:
          items:
            type: string
          type: array
          default: []
        description_url:
          anyOf:
            - type: string
            - type: 'null'
        store:
          anyOf:
            - $ref: '#/components/schemas/AliexpressProductStore'
            - type: 'null'
        shipping:
          anyOf:
            - $ref: '#/components/schemas/AliexpressProductShipping'
            - type: 'null'
        skus:
          items:
            $ref: '#/components/schemas/AliexpressProductSku'
          type: array
          default: []
        specifications:
          items:
            $ref: '#/components/schemas/AliexpressProductSpecification'
          type: array
          default: []
      type: object
      required:
        - id
        - product_url
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
      type: object
    AliexpressLanguage:
      type: string
      enum:
        - ar_MA
        - de_DE
        - en_US
        - es_ES
        - fr_FR
        - in_ID
        - it_IT
        - iw_IL
        - ja_JP
        - ko_KR
        - nl_NL
        - pl_PL
        - pt_BR
        - ru_RU
        - th_TH
        - tr_TR
        - vi_VN
    AliexpressCurrency:
      type: string
      enum:
        - USD
        - EUR
        - GBP
        - CAD
        - AUD
        - RUB
        - BRL
        - CLP
        - JPY
        - KRW
        - CHF
        - SEK
        - PLN
        - ILS
        - NOK
        - DKK
        - NZD
        - MXN
        - COP
        - TRY
        - THB
        - SGD
        - MYR
        - PHP
        - IDR
        - INR
        - VND
        - HKD
        - TWD
        - AED
        - SAR
        - CZK
        - HUF
        - RON
        - BGN
        - UAH
        - KZT
        - ARS
        - EGP
        - ZAR
        - CNY
        - PEN
    AliexpressProductStore:
      properties:
        '@type':
          type: string
          default: AliexpressProductStore
        id:
          anyOf:
            - type: string
            - type: 'null'
        seller_id:
          anyOf:
            - type: string
            - type: 'null'
        name:
          anyOf:
            - type: string
            - type: 'null'
        url:
          anyOf:
            - type: string
            - type: 'null'
        image:
          anyOf:
            - type: string
            - type: 'null'
        country:
          anyOf:
            - type: string
            - type: 'null'
        opened_at:
          anyOf:
            - type: string
            - type: 'null'
        opened_years:
          anyOf:
            - type: integer
            - type: 'null'
        positive_rate:
          anyOf:
            - type: number
            - type: 'null'
        positive_count:
          anyOf:
            - type: integer
            - type: 'null'
        feedback_count:
          anyOf:
            - type: integer
            - type: 'null'
        level:
          anyOf:
            - type: string
            - type: 'null'
        score:
          anyOf:
            - type: integer
            - type: 'null'
        metrics:
          items:
            $ref: '#/components/schemas/AliexpressProductStoreMetric'
          type: array
          default: []
      type: object
    AliexpressProductShipping:
      properties:
        '@type':
          type: string
          default: AliexpressProductShipping
        price:
          anyOf:
            - type: number
            - type: 'null'
        price_text:
          anyOf:
            - type: string
            - type: 'null'
        ship_from:
          anyOf:
            - type: string
            - type: 'null'
        ship_to:
          anyOf:
            - type: string
            - type: 'null'
        provider:
          anyOf:
            - type: string
            - type: 'null'
        delivery_min_days:
          anyOf:
            - type: integer
            - type: 'null'
        delivery_max_days:
          anyOf:
            - type: integer
            - type: 'null'
        delivery_date_min:
          anyOf:
            - type: string
            - type: 'null'
        delivery_date_max:
          anyOf:
            - type: string
            - type: 'null'
        is_free:
          type: boolean
          default: false
      type: object
    AliexpressProductSku:
      properties:
        '@type':
          type: string
          default: AliexpressProductSku
        id:
          type: string
        attributes:
          anyOf:
            - type: string
            - type: 'null'
        properties:
          items:
            $ref: '#/components/schemas/AliexpressProductSkuProperty'
          type: array
          default: []
        price:
          anyOf:
            - type: number
            - type: 'null'
        price_text:
          anyOf:
            - type: string
            - type: 'null'
        original_price:
          anyOf:
            - type: number
            - type: 'null'
        original_price_text:
          anyOf:
            - type: string
            - type: 'null'
        currency:
          anyOf:
            - type: string
            - type: 'null'
        stock:
          anyOf:
            - type: integer
            - type: 'null'
        is_available:
          type: boolean
          default: false
        image:
          anyOf:
            - type: string
            - type: 'null'
      type: object
      required:
        - id
    AliexpressProductSpecification:
      properties:
        '@type':
          type: string
          default: AliexpressProductSpecification
        name:
          type: string
        value:
          anyOf:
            - type: string
            - type: 'null'
      type: object
      required:
        - name
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
        msg:
          type: string
        type:
          type: string
        input: {}
        ctx:
          type: object
      type: object
      required:
        - loc
        - msg
        - type
    AliexpressProductStoreMetric:
      properties:
        '@type':
          type: string
          default: AliexpressProductStoreMetric
        name:
          type: string
        value:
          anyOf:
            - type: string
            - type: 'null'
      type: object
      required:
        - name
    AliexpressProductSkuProperty:
      properties:
        '@type':
          type: string
          default: AliexpressProductSkuProperty
        name:
          type: string
        value:
          anyOf:
            - type: string
            - type: 'null'
      type: object
      required:
        - name
  securitySchemes:
    AccessToken:
      type: apiKey
      in: header
      name: access-token
      description: API token from the dashboard

````