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

# AliExpress Product

> Look up one AliExpress product by id and get its price, original price, rating, reviews count, images, options, variants with stock, specifications, store, ship-from country and delivery estimate in one normalized response.

**Price:** \$0.85 per 1,000 requests (flat per request - same cost regardless of results returned).

**Routing:** 2 independent lanes are available in execution order. A failed attempt uses the next lane only when the request's payment authorizes that lane's price; the normalized schema stays the same.

**Catalog:** [AliExpress Product pricing and uptime](https://getanyapi.com/api/aliexpress/product) - live USD price, lane routing, and measured 30-day uptime. [Every Aliexpress endpoint](https://getanyapi.com/api/aliexpress).



## OpenAPI

````yaml /openapi.json post /v1/run/aliexpress.product
openapi: 3.1.0
info:
  contact:
    email: support@getanyapi.com
  description: >-
    Any API, one wallet, USD, no subscriptions. Each API is a single discovered
    operation: send the normalized input, get a normalized result. Prices and
    payment outcomes are reported in USD; each operation documents the
    settlement policy for its enabled payment rails.
  title: AnyAPI
  version: 1.0.0
  x-guidance: >-
    Use each operation's published method and path with its normalized JSON
    input (see the operation requestBody). Before setting a client or tool
    timeout, GET /v1/apis/{sku} and inspect its trailing-30-day latency
    p50/p95/p99 and sample; p99 is an observation, not a maximum. To pay: send
    your AnyAPI key (Authorization: Bearer, billed from your USD wallet). For
    operations that advertise an inline rail, pay per call inline with x402 -
    call with no key, receive HTTP 402 with a PAYMENT-REQUIRED header, then
    retry with the PAYMENT-SIGNATURE header (base, no account needed); or pay
    per call inline with MPP (Machine Payments Protocol) - call with no key,
    receive HTTP 402 with a WWW-Authenticate: Payment challenge, then retry with
    the Authorization: Payment header (tempo, no account needed). x402 settles
    after execution; execution failure is reported as released; mpp settles
    before execution; execution failure is reported as charged_undelivered.
servers:
  - url: https://api.getanyapi.com
security:
  - bearerAuth: []
  - apiKeyAuth: []
tags:
  - name: ahrefs
    x-group: Ahrefs
  - name: airbnb
    x-group: Airbnb
  - name: alibaba
    x-group: Alibaba
  - name: aliexpress
    x-group: Aliexpress
  - name: amazon
    x-group: Amazon
  - name: apollo
    x-group: Apollo
  - name: appstore
    x-group: Appstore
  - name: asos
    x-group: Asos
  - name: bestbuy
    x-group: Bestbuy
  - name: bing
    x-group: Bing
  - name: bluesky
    x-group: Bluesky
  - name: booking
    x-group: Booking
  - name: brave
    x-group: Brave
  - name: capterra
    x-group: Capterra
  - name: chatgpt
    x-group: Chatgpt
  - name: coinmarketcap
    x-group: Coinmarketcap
  - name: company
    x-group: Company
  - name: company-enrichment
    x-group: Company_enrichment
  - name: company-identify
    x-group: Company_identify
  - name: company-search
    x-group: Company_search
  - name: congress
    x-group: Congress
  - name: contact-enrichment
    x-group: Contact_enrichment
  - name: douyin
    x-group: Douyin
  - name: duckduckgo
    x-group: Duckduckgo
  - name: ebay
    x-group: Ebay
  - name: email
    x-group: Email
  - name: email-finding
    x-group: Email_finding
  - name: email-verification
    x-group: Email_verification
  - name: etsy
    x-group: Etsy
  - name: facebook
    x-group: Facebook
  - name: fiverr
    x-group: Fiverr
  - name: g2
    x-group: G2
  - name: gemini
    x-group: Gemini
  - name: github
    x-group: Github
  - name: glassdoor
    x-group: Glassdoor
  - name: google
    x-group: Google
  - name: google-ads
    x-group: Google Ads
  - name: google-finance
    x-group: Google Finance
  - name: google-hotels
    x-group: Google Hotels
  - name: google-shopping
    x-group: Google Shopping
  - name: hackernews
    x-group: Hackernews
  - name: ikea
    x-group: Ikea
  - name: indeed
    x-group: Indeed
  - name: instagram
    x-group: Instagram
  - name: job-search
    x-group: Job_search
  - name: levels
    x-group: Levels
  - name: linkedin
    x-group: Linkedin
  - name: linktree
    x-group: Linktree
  - name: maps
    x-group: Maps
  - name: mobile-phone
    x-group: Mobile_phone
  - name: naver
    x-group: Naver
  - name: nextdoor
    x-group: Nextdoor
  - name: people-search
    x-group: People_search
  - name: perplexity
    x-group: Perplexity
  - name: person
    x-group: Person
  - name: person-enrichment
    x-group: Person_enrichment
  - name: pexels
    x-group: Pexels
  - name: pinterest
    x-group: Pinterest
  - name: playstore
    x-group: Playstore
  - name: polymarket
    x-group: Polymarket
  - name: property-records
    x-group: Property_records
  - name: realtor
    x-group: Realtor
  - name: reddit
    x-group: Reddit
  - name: redfin
    x-group: Redfin
  - name: rednote
    x-group: Rednote
  - name: samsclub
    x-group: Samsclub
  - name: sec
    x-group: Sec
  - name: semrush
    x-group: Semrush
  - name: seo
    x-group: Seo
  - name: similarweb
    x-group: Similarweb
  - name: slickdeals
    x-group: Slickdeals
  - name: snapchat
    x-group: Snapchat
  - name: social
    x-group: Social
  - name: spotify
    x-group: Spotify
  - name: substack
    x-group: Substack
  - name: target
    x-group: Target
  - name: technographics
    x-group: Technographics
  - name: telegram
    x-group: Telegram
  - name: threads
    x-group: Threads
  - name: tiktok
    x-group: TikTok
  - name: tiktok-shop
    x-group: TikTok Shop
  - name: tripadvisor
    x-group: Tripadvisor
  - name: trustpilot
    x-group: Trustpilot
  - name: truthsocial
    x-group: Truthsocial
  - name: twitter
    x-group: X (Twitter)
  - name: unsplash
    x-group: Unsplash
  - name: upwork
    x-group: Upwork
  - name: walmart
    x-group: Walmart
  - name: web
    x-group: Web
  - name: weibo
    x-group: Weibo
  - name: yahoo-finance
    x-group: Yahoo Finance
  - name: yelp
    x-group: Yelp
  - name: youtube
    x-group: YouTube
  - name: zhihu
    x-group: Zhihu
  - name: zillow
    x-group: Zillow
paths:
  /v1/run/aliexpress.product:
    post:
      tags:
        - aliexpress
      summary: AliExpress Product
      description: >-
        Look up one AliExpress product by id and get its price, original price,
        rating, reviews count, images, options, variants with stock,
        specifications, store, ship-from country and delivery estimate in one
        normalized response.


        **Price:** \$0.85 per 1,000 requests (flat per request - same cost
        regardless of results returned).


        **Routing:** 2 independent lanes are available in execution order. A
        failed attempt uses the next lane only when the request's payment
        authorizes that lane's price; the normalized schema stays the same.


        **Catalog:** [AliExpress Product pricing and
        uptime](https://getanyapi.com/api/aliexpress/product) - live USD price,
        lane routing, and measured 30-day uptime. [Every Aliexpress
        endpoint](https://getanyapi.com/api/aliexpress).
      operationId: aliexpress_product
      parameters:
        - description: >-
            Optional. Comma-separated keys (dotted paths like `author.name`
            descend into nested objects) to keep on each result item: each row
            of the API's result list, or the `data` object itself for an API
            that returns one record. Keys are matched relative to that item, not
            against the top-level response envelope, so use `jq` to reshape the
            whole envelope. Shrinks the response without changing cost.
          in: query
          name: fields
          required: false
          schema:
            type: string
        - description: >-
            Optional. Cap the number of result rows returned; a `_truncated`
            note reports how many were withheld so you can page via the API's
            own `limit`. An API that returns one record is not trimmed. Does not
            change cost.
          in: query
          name: max_items
          required: false
          schema:
            minimum: 0
            type: integer
        - description: >-
            Optional. Return only a structural outline (top-level keys, item
            counts, and per-field byte sizes) instead of the full data. Does not
            change cost.
          in: query
          name: summary
          required: false
          schema:
            type: boolean
        - description: >-
            Optional. A jq expression applied to the result envelope; its output
            replaces `output` (multiple outputs collect into an array). Reshape
            freely, e.g. `jq=.data | {title, description, md:
            .markdown[:3500]}`. Runs sandboxed with a 250ms / 2MB budget; on
            failure the full result is returned with a `jqError`. Does not
            change cost.
          in: query
          name: jq
          required: false
          schema:
            type: string
        - description: >-
            Optional. The most you are willing to pay for this one request, in
            US dollars (for example 0.05). Any route that would charge more than
            this is not used, so a request only ever runs on something you can
            afford. If nothing is available at or below your amount, the request
            is refused before it runs, nothing is charged, and the message tells
            you the cheapest price per request so you can raise it. Leave it out
            to accept the normal price.
          in: query
          name: max_cost_usd
          required: false
          schema:
            type: string
        - description: >-
            Optional wallet idempotency key, scoped to this customer for 24
            hours. When the gateway honors the key, this synchronous in-process
            execution can continue after the caller disconnects, bounded by its
            execution deadline. A completed replayable result charges normally
            exactly once and can be replayed without another provider run or
            charge. A pending duplicate returns 409 idempotency_in_progress;
            reuse with different request semantics returns 409
            idempotency_conflict.
          in: header
          name: Idempotency-Key
          required: false
          schema:
            maxLength: 255
            minLength: 1
            type: string
      requestBody:
        content:
          application/json:
            example:
              productId: '3256807039224587'
            schema:
              additionalProperties: false
              example:
                productId: '3256807039224587'
              properties:
                allowFallbacks:
                  default: true
                  description: >-
                    Optional, default true. When false, only the sources listed
                    in `source` may serve; the request is refused with no charge
                    if none of them can. When true, the listed sources are tried
                    first and any other source may serve after them, at the
                    normal price.
                  type: boolean
                country:
                  default: US
                  description: >-
                    Ship-to country as a 2-letter ISO code, e.g. US or DE. It
                    changes prices, stock and the delivery estimate.
                  pattern: ^[A-Z]{2}$
                  type: string
                currency:
                  default: USD
                  description: Price currency as a 3-letter ISO code, e.g. USD or EUR.
                  pattern: ^[A-Z]{3}$
                  type: string
                ignoreSources:
                  description: >-
                    Optional. Source ids to skip for this request, taken from
                    this endpoint's `lanes[].source.id`. The cheapest remaining
                    source serves and the price is that of the dearest remaining
                    source. An id that does not serve this endpoint, or that is
                    also in `source`, is rejected as invalid input with no
                    charge; skipping every source is rejected the same way.
                  items:
                    minLength: 1
                    type: string
                  type: array
                  uniqueItems: true
                preferLatencyUnderMs:
                  description: >-
                    Optional; omit it and routing is unchanged, with the
                    cheapest source serving. Prefer sources whose typical
                    response time (median over the trailing 30 days, as
                    published on this endpoint's lane health) is under this many
                    milliseconds; among those, the cheapest serves. This can
                    raise your price: when the cheapest source misses the
                    target, a faster and dearer one serves, and you are quoted
                    and charged its price. If no source is that fast the request
                    is still served, by whichever source offers the best speed
                    for its price - it is never refused for being slow. Sources
                    we have not timed are tried last. This is a preference, not
                    a guarantee: the median describes past requests and is not a
                    ceiling on this one, and it excludes any wait this request
                    itself asks for. On a paginated walk it applies to the first
                    page only: later pages stay with the source that page chose,
                    at the price it was quoted.
                  minimum: 1
                  type: integer
                productId:
                  description: >-
                    AliExpress product id, the number in the product URL
                    (https://www.aliexpress.com/item/<id>.html), e.g.
                    3256807039224587. The AliExpress Search SKU returns it as
                    productId.
                  pattern: ^[0-9]+$
                  type: string
                requireFields:
                  description: >-
                    Optional; omit it and routing is unchanged, with the
                    cheapest source serving. Name the output fields this request
                    must be able to return, for example `video`, and it is
                    served only by a source that returns every one of them.
                    Fields you do not name are still returned whenever the
                    serving source has them. This can raise your price: when the
                    cheapest source cannot return a named field, a dearer source
                    serves, and you are quoted and charged its price. Naming a
                    combination that no single source returns together is
                    refused as invalid input, with no charge.
                  items:
                    enum:
                      - freeShipping
                      - returnPolicy
                      - shippingCost
                      - video
                      - wishlistCount
                    type: string
                  type: array
                  uniqueItems: true
                source:
                  description: >-
                    Optional. Source ids to prefer, in order, taken from this
                    endpoint's `lanes[].source.id` in /catalog or /apis. Omit it
                    and the cheapest source serves, with automatic failover.
                    Listed sources are tried first in the order given, then the
                    others, unless `allowFallbacks` is false. A single source
                    with `allowFallbacks` false is served only by that source at
                    its price, quoted and charged exactly, with no failover. The
                    price is that of the dearest source that may serve. An id
                    that does not serve this endpoint is rejected as invalid
                    input with no charge; a listed source that is not serving
                    right now is refused with no charge, so omit `source` to be
                    served by another. On a paginated walk, later pages must
                    include the source that served page one, or omit `source`.
                  items:
                    minLength: 1
                    type: string
                  type: array
                  uniqueItems: true
              required:
                - productId
              title: AliExpress product input
              type: object
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                properties:
                  costUsd:
                    description: >-
                      USD charged on the original run. On a replay this value is
                      echoed for parity; the replay itself is free.
                    type: number
                  hint:
                    description: >-
                      Optional one-line nudge, absent when there is nothing to
                      say. `large_result:` suggests the
                      fields/max_items/summary/jq controls for a big response.
                      `paging_unavailable:` means this result came from a source
                      that cannot return a `nextCursor`, so it may be INCOMPLETE
                      and cannot be continued - re-run with `requireFields:
                      ["nextCursor"]` to be served only by a source that can
                      page, which may cost more per request. `malformed_query:`
                      means X read your search query differently than it looks
                      (adjacent bare words are ANDed and OR binds tighter, so a
                      multi-word alternative is not a phrase, and an operator
                      after an unbracketed OR list applies to its last
                      alternative only); the run was served and billed as X read
                      it, and the hint carries the corrected query to send
                      instead. `date_adjusted:` means a date you sent was
                      outside the range the platform accepts, so the run used
                      the nearest accepted date the hint names.
                    type: string
                  items:
                    description: >-
                      Number of result rows returned; an API that returns one
                      record counts it as one row. For per-result APIs the
                      per-item cost is charged against this count; for
                      input-priced APIs the charge is per submitted input,
                      independent of this count.
                    type: integer
                  jqError:
                    description: >-
                      Present only when a `jq` expression failed; `output` then
                      carries the full unshaped result and this explains why the
                      reshape did not apply.
                    type: string
                  output:
                    anyOf:
                      - additionalProperties: false
                        properties:
                          data:
                            description: >-
                              Product wrapper, or null when AliExpress has no
                              product with that id.
                            oneOf:
                              - type: 'null'
                              - additionalProperties: false
                                properties:
                                  items:
                                    description: >-
                                      Product detail records (one per requested
                                      product id). Populated whenever the
                                      provider has data for the entity.
                                    items:
                                      properties:
                                        currency:
                                          description: >-
                                            Price currency code, e.g. "USD", or null
                                            when no price is shown. Populated
                                            whenever the provider has data for the
                                            entity.
                                          type:
                                            - string
                                            - 'null'
                                          x-anyapi-must-populate: true
                                        deliveryDaysMax:
                                          description: >-
                                            Most days the default shipping option
                                            takes to the requested country, or null
                                            when not reported. Populated whenever
                                            the provider has data for the entity.
                                          type:
                                            - integer
                                            - 'null'
                                          x-anyapi-must-populate: true
                                        deliveryDaysMin:
                                          description: >-
                                            Fewest days the default shipping option
                                            takes to the requested country, or null
                                            when not reported. Populated whenever
                                            the provider has data for the entity.
                                          type:
                                            - integer
                                            - 'null'
                                          x-anyapi-must-populate: true
                                        freeShipping:
                                          description: >-
                                            True when the default shipping option to
                                            the requested country costs nothing
                                            after AliExpress's buyer promotions, or
                                            null when the serving source does not
                                            report it.
                                          type:
                                            - boolean
                                            - 'null'
                                        images:
                                          description: >-
                                            Product image URLs, primary first.
                                            Populated whenever the provider has data
                                            for the entity.
                                          items:
                                            type: string
                                          type: array
                                          x-anyapi-must-populate: true
                                        isTopRatedSeller:
                                          description: >-
                                            True when AliExpress marks the store as
                                            a top-rated seller, or null when not
                                            reported. Populated whenever the
                                            provider has data for the entity.
                                          type:
                                            - boolean
                                            - 'null'
                                          x-anyapi-must-populate: true
                                        options:
                                          description: >-
                                            The choices a buyer picks from, e.g.
                                            Color and Size, each with its values.
                                            Populated whenever the provider has data
                                            for the entity.
                                          items:
                                            properties:
                                              name:
                                                description: >-
                                                  Option name as AliExpress shows it, e.g.
                                                  "Color".
                                                type: string
                                              values:
                                                description: >-
                                                  Values a buyer can pick, e.g. ["green",
                                                  "Purple"].
                                                items:
                                                  type: string
                                                type: array
                                            type: object
                                          type: array
                                          x-anyapi-must-populate: true
                                        originalPrice:
                                          description: >-
                                            Price of the default variant before the
                                            current discount, or null when not
                                            shown. Populated whenever the provider
                                            has data for the entity.
                                          type:
                                            - number
                                            - 'null'
                                          x-anyapi-must-populate: true
                                        price:
                                          description: >-
                                            Current price of the default variant in
                                            the requested currency (the lowest
                                            variant price when the page shows a
                                            range), or null when not shown.
                                            Populated whenever the provider has data
                                            for the entity.
                                          type:
                                            - number
                                            - 'null'
                                          x-anyapi-must-populate: true
                                        productId:
                                          description: >-
                                            AliExpress product id. Populated
                                            whenever the provider has data for the
                                            entity.
                                          type: string
                                          x-anyapi-must-populate: true
                                        quantityAvailable:
                                          description: >-
                                            Units in stock across all variants, or
                                            null when not reported. Populated
                                            whenever the provider has data for the
                                            entity.
                                          type:
                                            - integer
                                            - 'null'
                                          x-anyapi-must-populate: true
                                        rating:
                                          description: >-
                                            Average customer rating, 0-5, or null
                                            when the product is unrated. Populated
                                            whenever the provider has data for the
                                            entity.
                                          type:
                                            - number
                                            - 'null'
                                          x-anyapi-must-populate: true
                                        returnPolicy:
                                          description: >-
                                            The returns promise AliExpress shows on
                                            the product, e.g. "Free returns within
                                            90 days", or null when the serving
                                            source does not report it.
                                          type:
                                            - string
                                            - 'null'
                                        reviewsCount:
                                          description: >-
                                            Number of customer reviews, or null when
                                            not reported. Populated whenever the
                                            provider has data for the entity.
                                          type:
                                            - integer
                                            - 'null'
                                          x-anyapi-must-populate: true
                                        sellerCountry:
                                          description: >-
                                            Country the store is registered in, as
                                            AliExpress names it, e.g. "China", or
                                            null when not reported. Populated
                                            whenever the provider has data for the
                                            entity.
                                          type:
                                            - string
                                            - 'null'
                                          x-anyapi-must-populate: true
                                        sellerFeedbackCount:
                                          description: >-
                                            Number of buyer feedback ratings the
                                            store has received, or null when not
                                            reported. Populated whenever the
                                            provider has data for the entity.
                                          type:
                                            - integer
                                            - 'null'
                                          x-anyapi-must-populate: true
                                        sellerFeedbackPercent:
                                          description: >-
                                            Share of the store's buyer feedback that
                                            is positive, as a percentage, e.g. 95.9,
                                            or null when not reported. Populated
                                            whenever the provider has data for the
                                            entity.
                                          type:
                                            - number
                                            - 'null'
                                          x-anyapi-must-populate: true
                                        sellerLevel:
                                          description: >-
                                            The store's AliExpress seller level
                                            code, e.g. "25-s", or null when not
                                            reported. Populated whenever the
                                            provider has data for the entity.
                                          type:
                                            - string
                                            - 'null'
                                          x-anyapi-must-populate: true
                                        sellerOpenedUtc:
                                          description: >-
                                            UTC epoch timestamp in seconds (Unix
                                            time). Multiply by 1000 for a JS Date in
                                            milliseconds. The day the store opened
                                            on AliExpress, as midnight UTC of that
                                            date; null when not reported. Populated
                                            whenever the provider has data for the
                                            entity.
                                          type:
                                            - number
                                            - 'null'
                                          x-anyapi-must-populate: true
                                        sellerScore:
                                          description: >-
                                            The store's AliExpress feedback score,
                                            the points AliExpress shows beside the
                                            store, or null when not reported.
                                            Populated whenever the provider has data
                                            for the entity.
                                          type:
                                            - integer
                                            - 'null'
                                          x-anyapi-must-populate: true
                                        shipFrom:
                                          description: >-
                                            Country the default shipping option
                                            ships from, as AliExpress names it, e.g.
                                            "China", or null when not reported.
                                            Populated whenever the provider has data
                                            for the entity.
                                          type:
                                            - string
                                            - 'null'
                                          x-anyapi-must-populate: true
                                        shippingCost:
                                          description: >-
                                            Shipping cost of the default option to
                                            the requested country, in the requested
                                            currency, or null when not reported or
                                            the serving source does not report it in
                                            that currency. AliExpress applies buyer
                                            promotions to it, so sources can differ.
                                          type:
                                            - number
                                            - 'null'
                                        soldCount:
                                          description: >-
                                            Units sold, read from AliExpress's
                                            rounded label, so "4,000+ sold" comes
                                            back as 4000; null when not shown.
                                          type:
                                            - integer
                                            - 'null'
                                        specifications:
                                          description: >-
                                            The seller's specifications table, one
                                            name and value per row. Populated
                                            whenever the provider has data for the
                                            entity.
                                          items:
                                            properties:
                                              name:
                                                description: >-
                                                  Attribute name as the seller lists it,
                                                  e.g. "Material".
                                                type: string
                                              value:
                                                description: Attribute value as the seller lists it.
                                                type: string
                                            type: object
                                          type: array
                                          x-anyapi-must-populate: true
                                        storeId:
                                          description: >-
                                            Storefront number of the store, the
                                            digits in
                                            https://www.aliexpress.com/store/<id>,
                                            or null when not reported. Populated
                                            whenever the provider has data for the
                                            entity.
                                          type:
                                            - string
                                            - 'null'
                                          x-anyapi-must-populate: true
                                        storeName:
                                          description: >-
                                            Name of the store selling the product,
                                            or null when not reported. Populated
                                            whenever the provider has data for the
                                            entity.
                                          type:
                                            - string
                                            - 'null'
                                          x-anyapi-must-populate: true
                                        title:
                                          description: >-
                                            Product title. Populated whenever the
                                            provider has data for the entity.
                                          type: string
                                          x-anyapi-must-populate: true
                                        url:
                                          description: >-
                                            AliExpress product page URL with
                                            tracking query parameters removed.
                                          type: string
                                        variants:
                                          description: >-
                                            One entry per purchasable combination of
                                            options. Populated whenever the provider
                                            has data for the entity.
                                          items:
                                            properties:
                                              attributes:
                                                description: >-
                                                  The option values that make up this
                                                  variant, keyed by option name, e.g.
                                                  {"Color": "Purple", "Size": "XL"}, or
                                                  null when the serving source does not
                                                  report them.
                                                type:
                                                  - object
                                                  - 'null'
                                              image:
                                                description: >-
                                                  Picture of this variant, or null when it
                                                  has none or the serving source does not
                                                  report it.
                                                type:
                                                  - string
                                                  - 'null'
                                              inStock:
                                                description: >-
                                                  True when this variant can be bought
                                                  now, or null when not reported.
                                                type:
                                                  - boolean
                                                  - 'null'
                                              originalPrice:
                                                description: >-
                                                  Price of this variant before the current
                                                  discount, or null when not reported.
                                                type:
                                                  - number
                                                  - 'null'
                                              price:
                                                description: >-
                                                  Current price of this variant, or null
                                                  when the serving source does not report
                                                  it.
                                                type:
                                                  - number
                                                  - 'null'
                                              quantityAvailable:
                                                description: >-
                                                  Units of this variant in stock, or null
                                                  when not reported.
                                                type:
                                                  - integer
                                                  - 'null'
                                              skuId:
                                                description: AliExpress id of this variant.
                                                type: string
                                            type: object
                                          type: array
                                          x-anyapi-must-populate: true
                                        video:
                                          description: >-
                                            Product video URL (MP4), or null when
                                            the product has none or the serving
                                            source does not report it.
                                          type:
                                            - string
                                            - 'null'
                                        wishlistCount:
                                          description: >-
                                            Number of shoppers who added the product
                                            to their wish list, or null when the
                                            serving source does not report it.
                                          type:
                                            - integer
                                            - 'null'
                                      required:
                                        - productId
                                        - title
                                        - url
                                      type: object
                                    type: array
                                    x-anyapi-must-populate: true
                                required:
                                  - items
                                type: object
                          found:
                            description: True when the product was found.
                            type: boolean
                          reason:
                            description: >-
                              Present only when `found` is false, and says why
                              there is no result. `not_found`: the source states
                              the target does not exist, or returned nothing for
                              it. A `found: false` answer is a successful call,
                              not an error, and `costUsd` is what it actually
                              cost.
                            enum:
                              - not_found
                            type: string
                        required:
                          - found
                          - data
                        title: AliExpress product output
                        type: object
                        x-anyapi-heavy: true
                      - type: 'null'
                    description: >-
                      Normalized output, or null when the replay payload was not
                      retained.
                  provider:
                    description: Always "AnyAPI".
                    type: string
                  replayed:
                    description: >-
                      True when this response replays the durable result of an
                      earlier run without billing or upstream execution.
                    type: boolean
                  resultId:
                    description: >-
                      Opaque handle to the full unshaped result, cached ~15 min.
                      Re-shape it for free (fields/max_items/summary/jq) via GET
                      /v1/results/{id}, no re-billing. Absent when the result
                      was too large to cache.
                    type: string
                  source:
                    description: >-
                      The source that served this run. Pass its `id` back as
                      `source` to prefer it again, or as `ignoreSources` to
                      avoid it. Absent when no source identity applies to the
                      run.
                    properties:
                      artworkKey:
                        description: Key for this source's artwork.
                        type: string
                      id:
                        description: Stable identifier for this source.
                        type: string
                      kind:
                        description: >-
                          anonymous is a stable identity for an unattributed
                          source; brand names the dataset that supplies the
                          data.
                        enum:
                          - anonymous
                          - brand
                        type: string
                      name:
                        description: Display name for this source.
                        type: string
                    required:
                      - id
                      - name
                      - kind
                      - artworkKey
                    type: object
                required:
                  - output
                  - provider
                  - costUsd
                  - items
                  - replayed
                type: object
          description: Normalized result.
          headers:
            Idempotency-Replayed:
              description: >-
                Present only when the request carried an Idempotency-Key this
                gateway honored. "false" means the key was claimed and the run
                executed freshly; "true" means it replayed a prior identical run
                and was NOT charged again. Absent means either no key was sent
                or this gateway does not honor keys, so a retry could be charged
                twice.
              schema:
                enum:
                  - 'false'
                  - 'true'
                type: string
            PAYMENT-RESPONSE:
              description: Inline x402 payment receipt.
              schema:
                type: string
            Payment-Receipt:
              description: Inline mpp payment receipt.
              schema:
                type: string
            X-PAYMENT-RESPONSE:
              description: Inline x402 payment receipt.
              schema:
                type: string
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: >-
            Input did not match the schema, or the upstream rejected the
            request.
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Missing or invalid API key.
        '402':
          content:
            application/json:
              schema:
                oneOf:
                  - $ref: '#/components/schemas/PaymentRequiredError'
                  - $ref: '#/components/schemas/TrialCapReached'
            application/problem+json:
              schema:
                properties:
                  challengeId:
                    minLength: 1
                    type: string
                  status:
                    const: 402
                    type: integer
                required:
                  - status
                  - challengeId
                type: object
          description: >-
            Insufficient wallet balance or spend cap, or an inline-payment
            challenge. Agent trials receive a trial_cap_reached continuation
            with a live RFC 8628 device authorization.
          headers:
            PAYMENT-REQUIRED:
              description: Inline x402 payment challenge.
              schema:
                type: string
            WWW-Authenticate:
              description: Inline mpp payment challenge.
              schema:
                type: string
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: >-
            This API key's access (run only or read only) does not allow this
            operation.
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: >-
            Unknown API. A target that does not exist is not a 404: the call
            succeeds with `output.found` false and `data` null.
        '409':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: >-
            Idempotency collision. Codes: idempotency_in_progress means retry
            after the Retry-After delay; idempotency_conflict means use a new
            key for different request semantics; idempotency_needs_review means
            stop retrying and contact AnyAPI support with X-Anyapi-Request-Id.
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: >-
            The request was well formed but this API cannot serve the requested
            target site; the body's `alternatives` array lists the AnyAPI APIs
            that can.
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: >-
            The upstream was rate limited; resend the same request, with the
            same cursor if one was sent, after Retry-After seconds. Inspect
            `payment` when present before deciding whether to retry.
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: >-
            An internal error prevented completion. Inspect payment when present
            before retrying.
        '502':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: >-
            Every provider failed with a server/transport error, or inline
            payment settlement could not be confirmed; inspect `payment` when
            present before retrying.
      security:
        - bearerAuth: []
        - apiKeyAuth: []
        - {}
components:
  schemas:
    Error:
      properties:
        code:
          description: Stable machine-readable error code when the endpoint defines one.
          type: string
        error:
          description: Customer-safe error message.
          type: string
        payment:
          $ref: '#/components/schemas/Payment'
        requestId:
          description: >-
            This run's AnyAPI request id, the same value as the
            X-Anyapi-Request-Id response header. Quote it to support. Absent on
            endpoints that do not execute a run.
          format: uuid
          type: string
      required:
        - error
      type: object
    PaymentRequiredError:
      allOf:
        - $ref: '#/components/schemas/Error'
        - properties:
            error:
              not:
                const: trial_cap_reached
          type: object
    TrialCapReached:
      properties:
        error:
          const: trial_cap_reached
          type: string
        message:
          description: >-
            Human-relayable continuation instructions, including an executable
            token poll.
          type: string
        upgrade:
          $ref: '#/components/schemas/AgentUpgrade'
      required:
        - error
        - message
        - upgrade
      type: object
    Payment:
      properties:
        costUsd:
          description: Known USD payment amount for this request.
          minimum: 0
          type: number
        rail:
          minLength: 1
          type: string
        settlementState:
          enum:
            - charged_undelivered
            - indeterminate
          type: string
      required:
        - rail
        - settlementState
        - costUsd
      type: object
    AgentUpgrade:
      properties:
        authorizationServer:
          format: uri
          type: string
        clientId:
          type: string
        device:
          $ref: '#/components/schemas/DeviceUpgrade'
        scope:
          type: string
      required:
        - authorizationServer
        - scope
      type: object
    DeviceUpgrade:
      properties:
        deviceCode:
          type: string
        expiresIn:
          minimum: 0
          type: integer
        grantType:
          type: string
        interval:
          minimum: 1
          type: integer
        tokenEndpoint:
          format: uri
          type: string
        userCode:
          type: string
        verificationUri:
          format: uri
          type: string
        verificationUriComplete:
          format: uri
          type: string
      required:
        - verificationUriComplete
        - verificationUri
        - userCode
        - deviceCode
        - tokenEndpoint
        - grantType
        - interval
        - expiresIn
      type: object
  securitySchemes:
    bearerAuth:
      description: Your AnyAPI key as a Bearer token.
      scheme: bearer
      type: http
      x-default: YOUR_ANYAPI_KEY
    apiKeyAuth:
      description: Your AnyAPI key.
      in: header
      name: X-API-Key
      type: apiKey
      x-default: YOUR_ANYAPI_KEY

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.