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

# Página de producto de Flipkart

> Lee una página de producto de Flipkart por productId o url: precio, stock, imágenes, especificaciones y opciones. 0,5 créditos por página.



## OpenAPI

````yaml POST /v1/commerce/flipkart/product
openapi: 3.1.0
info:
  title: querying.ai
  description: >-
    One API for every AI answer engine. Every task is asynchronous: submit, then
    collect the result via webhook or polling.
  version: 1.0.0
servers:
  - url: https://api.querying.ai
    description: Production
security:
  - bearerAuth: []
paths:
  /v1/commerce/flipkart/product:
    post:
      tags:
        - Commerce
      summary: Flipkart product page
      description: >-
        Reads one Flipkart product page, named by its `productId` or `url`, and
        answers with what the page shows, such as the price, stock, images,
        specs and options. `POST /v1/async/task` takes the same read as
        `COMMERCE_PRODUCT` with the page's `url`. The request waits for the task
        as `POST /v1/sync/task` does: up to 290 seconds or what `Prefer: wait`
        asks, then `202` with the task and `Location` while it still runs. A
        completed read costs 0.5 credits.
      operationId: commerceProductFlipkart
      parameters:
        - $ref: '#/components/parameters/PreferWait'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              additionalProperties: false
              properties:
                productId:
                  type: string
                  pattern: ^[A-Z0-9]{16}$
                  example: ACCHSJJ8VV23AT2G
                  description: >-
                    The product's Flipkart ID, such as ACCHSJJ8VV23AT2G: the
                    productId a search of Flipkart answers with. Send productId
                    or url, not both.
                url:
                  type: string
                  format: uri
                  maxLength: 2048
                  description: >-
                    A product page on flipkart.com, such as a product url a
                    search answers with. Send productId or url, not both.
                idempotencyKey:
                  $ref: '#/components/schemas/CommerceIdempotencyKey'
                priority:
                  $ref: '#/components/schemas/CommercePriority'
                webhook:
                  $ref: '#/components/schemas/CommerceWebhook'
              oneOf:
                - required:
                    - productId
                - required:
                    - url
            examples:
              productId:
                summary: By product ID
                value:
                  productId: ACCHQGW2GYZXP57R
              url:
                summary: By url
                value:
                  url: >-
                    https://www.flipkart.com/gwalbros-new-trending-buds-r2-true-wireless-earbuds-mic-12-4mm-drivers-f03-bluetooth/p/itm07d92543aca98?pid=ACCHQGW2GYZXP57R
      responses:
        '200':
          description: >-
            The read ended: the body `GET /v1/async/task/{id}` returns, with the
            page in `response` or the reason in `error`.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TaskResponse'
              example:
                success: true
                task:
                  id: 8f2c1e40-0000-0000-0000-000000000000
                  taskType: COMMERCE_PRODUCT
                  status: COMPLETED
                  priority: 1
                  createdAt: '2026-07-09T04:12:00.000Z'
                  latencyMs: 4210
                credits:
                  creditsToCharge: 0.5
                  creditsCharged: 0.5
                response:
                  site: flipkart
                  country: IN
                  url: >-
                    https://www.flipkart.com/gwalbros-new-trending-buds-r2-true-wireless-earbuds-mic-12-4mm-drivers-f03-bluetooth/p/itm07d92543aca98?pid=ACCHQGW2GYZXP57R
                  productId: ACCHQGW2GYZXP57R
                  title: >-
                    GWALBROS New Trending BUDS R2 True Wireless Earbuds with
                    Mic, 12.4mm Drivers F03 Bluetooth
                  brand: GWALBROS
                  price: 361
                  currency: INR
                  inStock: true
                  rating: 3.7
                  reviewCount: 504
                  images:
                    - >-
                      https://rukmini1.flixcart.com/image/1500/1500/xif0q/headphone/e/2/r/bx-2r-techio-original-imahpyystsr3y4dt.jpeg?q=70
                    - >-
                      https://rukmini1.flixcart.com/image/1500/1500/xif0q/headphone/x/f/b/nord-buds-2r-tws-bluetooth-earbuds-with-deep-bass-enc-mic-touch-original-imahpyhynh6e3f9w.jpeg?q=70
                  description: >-
                    Buy GWALBROS New Trending BUDS R2 True Wireless Earbuds with
                    Mic, 12.4mm Drivers F03 Bluetooth for Rs.1499.0 Online, Also
                    get GWALBROS New Trending BUDS R2 True Wireless Earbuds with
                    Mic, 12.4mm…
        '202':
          $ref: '#/components/responses/CommerceTaskRunning'
        '400':
          $ref: '#/components/responses/CommerceUnknownField'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '402':
          $ref: '#/components/responses/InsufficientCredits'
        '403':
          $ref: '#/components/responses/CommerceKeyScopeDenied'
        '409':
          $ref: '#/components/responses/IdempotencyKeyExpired'
        '413':
          $ref: '#/components/responses/PayloadTooLarge'
        '422':
          $ref: '#/components/responses/CommerceProductInvalid'
        '429':
          $ref: '#/components/responses/TaskLimitExceeded'
        '503':
          $ref: '#/components/responses/CommerceUnavailable'
components:
  parameters:
    PreferWait:
      name: Prefer
      in: header
      required: false
      description: >-
        `wait=<seconds>` holds the request at most that long, up to 290.
        `wait=0` answers with the task id at once.
      schema:
        type: string
        example: wait=120
  schemas:
    CommerceIdempotencyKey:
      type: string
      description: >-
        Optional. A repeat of the key within at least 30 days answers with the
        task that holds it, so a caller that hung up can ask again.
    CommercePriority:
      type: integer
      description: >-
        Compatibility field; does not guarantee execution order. Values outside
        1–10 are clamped, not rejected.
      minimum: 1
      maximum: 10
      default: 1
    CommerceWebhook:
      type: object
      description: Optional. Omit to collect the result by polling instead.
      required:
        - url
      properties:
        url:
          type: string
          format: uri
          description: Receives a POST when the task reaches a terminal state.
    TaskResponse:
      type: object
      required:
        - success
        - task
        - credits
      allOf:
        - if:
            properties:
              task:
                properties:
                  taskType:
                    const: COMMERCE_SERP
                required:
                  - taskType
            required:
              - task
          then:
            properties:
              response:
                $ref: '#/components/schemas/CommerceSerpResult'
        - if:
            properties:
              task:
                properties:
                  taskType:
                    const: COMMERCE_PRODUCT
                required:
                  - taskType
            required:
              - task
          then:
            properties:
              response:
                $ref: '#/components/schemas/CommerceProductResult'
        - if:
            properties:
              task:
                properties:
                  taskType:
                    const: SOCIAL
                required:
                  - taskType
            required:
              - task
          then:
            properties:
              response:
                $ref: '#/components/schemas/SocialResult'
        - if:
            properties:
              task:
                properties:
                  taskType:
                    const: ADS
                required:
                  - taskType
            required:
              - task
          then:
            properties:
              response:
                $ref: '#/components/schemas/AdsResult'
        - if:
            properties:
              task:
                properties:
                  taskType:
                    const: GOOGLE_PLACES
                required:
                  - taskType
            required:
              - task
          then:
            properties:
              response:
                $ref: '#/components/schemas/GooglePlacesResult'
        - if:
            properties:
              task:
                properties:
                  taskType:
                    const: GOOGLE_NEWS
                required:
                  - taskType
            required:
              - task
          then:
            properties:
              response:
                $ref: '#/components/schemas/GoogleNewsResult'
        - if:
            properties:
              task:
                properties:
                  taskType:
                    const: SEARCH
                required:
                  - taskType
            required:
              - task
          then:
            properties:
              response:
                $ref: '#/components/schemas/SearchResult'
      properties:
        success:
          type: boolean
          const: true
        task:
          $ref: '#/components/schemas/TaskMeta'
        credits:
          $ref: '#/components/schemas/Credits'
        response:
          type: object
          description: >-
            The engine-specific result. Absent until the task is terminal. See
            the Engines guide for per-engine shapes. NAVER_AI_TAB preserves the
            original text, markdown, sources and cards when Naver returns HTTP
            success, a valid stream ending in done, and nonempty answer text
            with unknown_error. It includes upstreamError and returns
            immediately without retrying or rephrasing, even with retryQuery.
            COMPLETED means collection finished; the answer may still be
            incomplete. Empty, cut-off or malformed streams still fail. Policy
            refusals complete with a policy_declined notice. rawContent is
            returned only with include.rawResponse. With
            `include.citationAnalysis`, answer results also carry
            `citationAnalysis` (see Include). CITATION_ANALYSIS returns
            CitationAnalysisResult; see the Citation Analysis guide.
            PROMPT_RESEARCH returns PromptResearchResult; see the Prompt
            Research guide. GEO_SCORE returns GeoScoreResult; see the GEO Score
            guide. Answer engines with `include.analysis` add `analysis`
            (AnswerAnalysis).
          properties:
            upstreamError:
              $ref: '#/components/schemas/NaverAiTabUpstreamError'
          additionalProperties: true
        error:
          type: string
          description: >-
            Present when `task.status` is `FAILED`. A plain string, not the
            `{code, message, timestamp}` object used by request-level errors.
    TaskMeta:
      type: object
      required:
        - id
        - taskType
        - status
        - priority
        - createdAt
        - latencyMs
      properties:
        id:
          type: string
          format: uuid
        taskType:
          $ref: '#/components/schemas/TaskResultType'
        status:
          $ref: '#/components/schemas/TaskStatus'
        priority:
          type: integer
        createdAt:
          type: string
          format: date-time
        latencyMs:
          type:
            - integer
            - 'null'
          description: >-
            Milliseconds from the worker's first pickup to the final outcome,
            excluding the queue wait. `null` until the task settles. Returned by
            polling, the webhook and the submit response alike.
        idempotencyKey:
          type: string
          description: >-
            Echoed back verbatim. **Omitted**, not null, when the caller
            supplied none.
    Credits:
      type: object
      description: >-
        Credits, with up to two decimals (for example `1.25`). The submit
        response always shows `0`: nothing is charged yet, and the task's price
        is held from your balance when it starts. Polling shows `0` until the
        task is terminal, then the settled charge: the task's price for
        COMPLETED, `0` for FAILED. A task webhook reports the same charge in
        `creditsCharged`; on a FAILED task it reports the task's price in
        `creditsToCharge` and `0` in `creditsCharged`. CITATION_ANALYSIS,
        GOOGLE_PLACES and GOOGLE_NEWS are charged by usage, up to the hold
        placed when the task starts.
      properties:
        creditsToCharge:
          type: number
        creditsCharged:
          type:
            - number
            - 'null'
    NaverAiTabUpstreamError:
      type: object
      description: >-
        Optional NAVER_AI_TAB generation error accompanying preserved answer
        text. Collection finished, but the answer may be incomplete.
      required:
        - type
      additionalProperties: false
      properties:
        type:
          type: string
          const: unknown_error
        message:
          type: string
          description: >-
            Naver's exact notice text, without translation or rewording. Omitted
            when Naver provides no notice text.
    AsyncResponse:
      type: object
      required:
        - success
        - task
        - credits
      properties:
        success:
          type: boolean
          const: true
        task:
          $ref: '#/components/schemas/TaskMeta'
        credits:
          $ref: '#/components/schemas/Credits'
    ErrorResponse:
      type: object
      required:
        - success
        - error
      properties:
        success:
          type: boolean
          const: false
        error:
          $ref: '#/components/schemas/ErrorDetail'
    TaskResultType:
      description: >-
        Task types returned by task polling, submissions, batch results and
        webhooks, including tasks created by dedicated endpoints. This is not a
        submission engine list.
      anyOf:
        - $ref: '#/components/schemas/TaskType'
        - type: string
          enum:
            - AI_RENDERING
    TaskStatus:
      type: string
      description: >-
        `PROCESSING` means a worker holds the task. `COMPLETED` and `FAILED` are
        terminal. For NAVER_AI_TAB with response.upstreamError, `COMPLETED`
        means collection finished; the answer may still be incomplete.
      enum:
        - QUEUED
        - PROCESSING
        - COMPLETED
        - FAILED
    ErrorDetail:
      type: object
      required:
        - code
        - message
      properties:
        code:
          type: string
          description: Stable, safe to branch on. See the Errors guide for the full list.
        message:
          type: string
          description: For humans. May change.
        details:
          description: >-
            Context for the error. An array of `{field, message}` on most
            `VALIDATION_ERROR`s; an object elsewhere (for example `{id}` on
            `RESOURCE_NOT_FOUND`, `retryAfterSec` on 429 and 503 codes). Omitted
            when there is nothing to add.
          oneOf:
            - type: array
              items:
                type: object
                properties:
                  field:
                    type: string
                  message:
                    type: string
            - type: object
              additionalProperties: true
        timestamp:
          type: string
          format: date-time
    TaskType:
      type: string
      description: >-
        The engine to query. `NAVER` is a deprecated alias for `NAVER_AI_BRIEF`.
        GOOGLE_AIO and GOOGLE_AIMODE are the names of Google AI Overviews and
        Google AI Mode; the earlier names GOOGLE and AIMODE are accepted too,
        and a task answers under the name it was sent with. `NAVER_AI_MODE` is
        accepted as an earlier spelling of `NAVER_AI_TAB`. `BING_AIMODE` returns
        Bing AI Mode's answer (bing.com/copilotsearch) for `payload.query` in
        AE, AU, BR, CA, DE, EE, ES, FR, GB, HK, HU, IE, IN, IT, JP, MX, NL, PL,
        PT, RO, RS, SE, SG, SK, TR, US and ZA, and refuses other countries with
        422 REGION_UNSUPPORTED; `BING_COPILOT_SEARCH` and `COPILOT_SEARCH` are
        accepted as its other names. `BING_COPILOT` and `MICROSOFT_COPILOT` are
        accepted as other names of `COPILOT` (Microsoft Copilot). `GOOGLE_SERP`
        returns the Google results page without the AI Overview; `payload.page`
        selects pages 1-10. `BRAVE_SEARCH` returns Brave's own results page:
        organic results, ads, FAQ, knowledge panel, news, videos, discussions,
        places and related queries, with `payload.country` from Brave's markets
        and `payload.page` from 1 to 10; there is no HTML payload, so `include`
        adds nothing. `GOOGLE_PLACES` returns the places Google's Places tab
        lists for `payload.query`, up to 100 over up to five pages of 20, every
        page searched from `payload.city` or `payload.uule`; `payload.limit`
        (1-100, default 20) sets how many, and the task is charged 1 credit per
        page read (GooglePlacesResult). `NAVER_SERP` returns Naver's web
        results, 15 per page (`payload.page` 1-10), and with `payload.action`
        `page` reads one naver.com page by `payload.url`. `META_AI` returns the
        meta.ai chat answer with its cited sources, search queries and the
        products, places, photos and accounts it shows (`shoppingCards`,
        `inlineProducts`, `map`, `images`, `socialCards`); a prompt Meta refuses
        completes with an empty text and a `notice` quoting Meta. `QWEN` returns
        the answer of Qwen's China web chat (qianwen.com) with its web search,
        sources and search queries; `payload.country` sets the exit and the
        answer locale. `DOUBAO` returns the answer of Doubao's China web chat
        (doubao.com) with its web search, sources and search queries; it always
        asks from mainland China, whatever `payload.country` is. `BAIDU_WENXIN`
        returns the answer of Baidu's Wenxin web chat (文心, wenxin.baidu.com)
        with the pages it read as sources and its search queries; it always asks
        from mainland China, whatever `payload.country` is. `BAIDU_AI_SEARCH`
        returns the AI answer card at the top of Baidu's results page for
        `payload.query`, with the pages it cites, and the rest of that page:
        organic results, ads, related searches, news, videos, notes, products,
        images, places and Baidu's other cards; it always searches from mainland
        China, and a query Baidu shows no AI answer for completes with `card:
        null` and the rest of the page. `BING` is accepted as an earlier
        spelling of `BING_SEARCH`, and `BING_COPILOT` and `MICROSOFT_COPILOT` as
        earlier spellings of `COPILOT`; responses echo the new names. `SOCIAL`
        reads public YouTube, Instagram and Threads data: `payload.platform`
        picks the site and `payload.action` what to read (SocialPayload,
        SocialResult); other `payload.platform` values are rejected with 403
        ENGINE_PRIVATE or 400 VALIDATION_ERROR. `ADS` reads the public ad
        libraries of Meta, Google, LinkedIn and TikTok (AdsPayload, AdsResult):
        `payload.platform` is `meta_ad_library`, `google_ads_transparency`,
        `linkedin_ad_library`, `tiktok_ad_library` or `tiktok_creative_center`,
        and `payload.action` picks `search` (the default: the ads that match the
        platform's search inputs, each with its days run where the library gives
        dates and a `summary` of the response, charged 0.5 credits for every 30
        ads returned, with a `nextCursor` to read the ads after them),
        `advertisers` (the advertisers whose names match `payload.query`, on
        Meta, Google and the TikTok Ad Library), `ad` (one ad by
        `payload.libraryId` with its advertiser and the transparency the library
        publishes) or `advertiser` (one Meta advertiser by `payload.pageId`),
        0.5 credits each. Private engines (for example CLAUDE) are rejected with
        403 ENGINE_PRIVATE. CITATION_ANALYSIS, PROMPT_RESEARCH and GEO_SCORE
        tasks are created through their own endpoints (POST
        /v1/citation-analysis, POST /v1/prompt-research, POST /v1/geo-score) and
        are rejected here with 400 USE_DEDICATED_ENDPOINT; they appear in this
        list because their tasks report them. SEARCH is the name a search made
        through POST /v1/search answers under, and WEB_SEARCH the id
        capabilities, key scopes and usage list it by; both are rejected here
        with 400 USE_DEDICATED_ENDPOINT. GEO_AUDIT, SOURCE_INFLUENCE and
        CITATION_ATTRIBUTION are accepted as earlier names of CITATION_ANALYSIS;
        responses echo CITATION_ANALYSIS.
      enum:
        - CHATGPT
        - PERPLEXITY
        - GEMINI
        - AIMODE
        - GOOGLE_AIMODE
        - GOOGLE
        - GOOGLE_AIO
        - GOOGLE_SERP
        - GOOGLE_PLACES
        - GOOGLE_NEWS
        - NAVER_AI_BRIEF
        - NAVER_AI_TAB
        - NAVER_AI_MODE
        - NAVER
        - NAVER_SERP
        - COMMERCE_SERP
        - COMMERCE_PRODUCT
        - SOCIAL
        - ADS
        - BING_SEARCH
        - BRAVE_SEARCH
        - BING
        - COPILOT
        - BING_COPILOT
        - MICROSOFT_COPILOT
        - BING_AIMODE
        - BING_COPILOT_SEARCH
        - COPILOT_SEARCH
        - META_AI
        - QWEN
        - DOUBAO
        - BAIDU_WENXIN
        - BAIDU_AI_SEARCH
        - CITATION_ANALYSIS
        - GEO_AUDIT
        - SOURCE_INFLUENCE
        - CITATION_ATTRIBUTION
        - PROMPT_RESEARCH
        - GEO_SCORE
        - SEARCH
        - WEB_SEARCH
        - WEB_SCRAPE
  responses:
    CommerceTaskRunning:
      description: >-
        The task had not ended when the wait was over. It keeps running; poll
        `Location` or wait for the webhook.
      headers:
        Location:
          description: 'Where to poll the task: `/v1/async/task/{id}`.'
          schema:
            type: string
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/AsyncResponse'
          examples:
            search:
              summary: A search still running
              value:
                success: true
                task:
                  id: 8f2c1e40-0000-0000-0000-000000000000
                  taskType: COMMERCE_SERP
                  status: QUEUED
                  priority: 1
                  createdAt: '2026-07-09T04:12:00.000Z'
                  latencyMs: null
                credits:
                  creditsToCharge: 0
                  creditsCharged: 0
            product:
              summary: A product still running
              value:
                success: true
                task:
                  id: 8f2c1e40-0000-0000-0000-000000000000
                  taskType: COMMERCE_PRODUCT
                  status: QUEUED
                  priority: 1
                  createdAt: '2026-07-09T04:12:00.000Z'
                  latencyMs: null
                credits:
                  creditsToCharge: 0
                  creditsCharged: 0
    CommerceUnknownField:
      description: >-
        `VALIDATION_ERROR`: the body is not a JSON object, or it has a field
        this endpoint does not take; `details` names the field.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          example:
            success: false
            error:
              code: VALIDATION_ERROR
              message: Request validation failed
              details:
                - field: site
                  message: >-
                    unknown field; Walmart search takes query, limit, sort,
                    minPrice, maxPrice, page, brand, soldByWalmart,
                    fastDelivery, minRating, idempotencyKey, priority, webhook
              timestamp: '2026-07-09T04:12:00.000Z'
    Unauthorized:
      description: Missing or invalid bearer token.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          example:
            success: false
            error:
              code: MISSING_API_KEY
              message: Missing or invalid API key
              timestamp: '2026-07-09T04:12:00.000Z'
    InsufficientCredits:
      description: '`INSUFFICIENT_CREDITS`: the balance is below the price of the task.'
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          example:
            success: false
            error:
              code: INSUFFICIENT_CREDITS
              message: insufficient credits (need 2)
              timestamp: '2026-07-09T04:12:00.000Z'
    CommerceKeyScopeDenied:
      description: >-
        `KEY_SCOPE_DENIED`: the key's Allowed engines leave out `COMMERCE_SERP`,
        for a search, or `COMMERCE_PRODUCT`, for a product page.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          example:
            success: false
            error:
              code: KEY_SCOPE_DENIED
              message: This API key is not allowed to submit taskType 'COMMERCE_SERP'
              timestamp: '2026-07-09T04:12:00.000Z'
    IdempotencyKeyExpired:
      description: >-
        A task with this `idempotencyKey` exists but is past its retention
        window, so its result can no longer be read. A key whose task can still
        be read is answered with that task instead.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          example:
            success: false
            error:
              code: RESOURCE_ALREADY_EXISTS
              message: Task already exists.
              details:
                taskId: 8f2c1e40-0000-0000-0000-000000000000
              timestamp: '2026-07-09T04:12:00.000Z'
    PayloadTooLarge:
      description: '`PAYLOAD_TOO_LARGE`: the body exceeds 1 MiB. Rejected before parsing.'
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          example:
            success: false
            error:
              code: PAYLOAD_TOO_LARGE
              message: request body exceeds 1 MiB
              timestamp: '2026-07-09T04:12:00.000Z'
    CommerceProductInvalid:
      description: >-
        `VALIDATION_ERROR`: the body sends both productId and url or neither,
        productId is not one of the store's product IDs, or url is not a product
        page of the store. A product page of another store gets that store's
        endpoint in the message.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          example:
            success: false
            error:
              code: VALIDATION_ERROR
              message: Request validation failed
              details:
                - field: url
                  message: >-
                    url is a product page of Amazon; send it to
                    /v1/commerce/amazon/product
              timestamp: '2026-07-09T04:12:00.000Z'
    TaskLimitExceeded:
      description: >-
        Retry after the `Retry-After` header (seconds). `QUEUE_LIMIT_EXCEEDED`:
        the account already has 1,000,000 queued tasks.
        `KEY_DAILY_CREDIT_LIMIT`: the key used up its daily credit limit.
        `SUB_ACCOUNT_CREDIT_LIMIT`: the sub-account would exceed its
        `monthlyCreditLimit`. A task past the plan or contract concurrency limit
        is not refused: it is accepted, polls as `QUEUED`, and starts as running
        tasks finish.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          example:
            success: false
            error:
              code: QUEUE_LIMIT_EXCEEDED
              message: >-
                Queue limit exceeded. Maximum 1000000 queued tasks allowed per
                account
              details:
                limit: 1000000
                retryAfterSec: 30
              timestamp: '2026-07-09T04:12:00.000Z'
    CommerceUnavailable:
      description: >-
        Retry after the `Retry-After` header (seconds). `QUEUE_BACKPRESSURE`:
        this engine's queue is full. `SERVER_OVERLOADED`: admission is
        saturated, or the task queue as a whole is full. `DB_UNAVAILABLE`: task
        storage did not answer. `ENGINE_UNAVAILABLE`: this engine is temporarily
        not accepting tasks; `details.resumeAt`, when present, is when it
        expects to take tasks again.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          example:
            success: false
            error:
              code: DB_UNAVAILABLE
              message: Task storage unavailable. Retry shortly.
              details:
                retryAfterSec: 2
                retryable: true
              timestamp: '2026-07-09T04:12:00.000Z'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: 'Your API key, sent as `Authorization: Bearer <key>`.'

````

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