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

# Pesquisa da Amazon

> Produtos, ASINs exatos, demanda, avaliações filtradas, histórico e ofertas, com busca e leitura de páginas de comerciantes.

Informe o mercado. Ações: search, product, keywords, keyword\_volume, reviews, price\_history, offers, merchant\_search e merchant\_page. Consulte preços antes; max\_charge\_usd recusa pedidos acima do orçamento antes de criar o Run. Valores desconhecidos são null. Registre páginas e filtros observados sem afirmar prevalência populacional. Preserve série, moeda e data dos preços. Ofertas em cache não são preços de compra verificados. Leia result\_url autenticado para resultados pendentes; dados nativos permanecem no Run.


## OpenAPI

````yaml /openapi.pt.json post /v1/solutions/gtm/amazon_research
openapi: 3.1.0
info:
  title: Glasser
  version: 0.0.1
  description: >-
    Uma chave, sem contrato, pagamento por chamada, para todas as APIs pagas
    adquiridas no atacado. Cada resposta contém x-request-id; cada corpo de erro
    contém o mesmo envelope.
servers:
  - url: https://api.glasser.ai
security: []
tags:
  - name: Solutions
  - name: Endpoints
  - name: Runs
  - name: Balance
paths:
  /v1/solutions/gtm/amazon_research:
    post:
      tags:
        - Solutions
      summary: Pesquisa da Amazon
      description: >-
        Busque produtos e ASINs exatos, demanda estimada de termos relacionados
        ou explícitos, páginas limitadas de avaliações filtradas, histórico de
        preços e ofertas separadas de vendedores. Informe o mercado. Valores
        ausentes são null; preserve os limites de amostras e estimativas. Campos
        incompatíveis e pedidos que excedem max_charge_usd são recusados antes
        do Run. HTTP 202 retorna result_url assinado e autenticado para ler os
        mesmos Runs sem nova cobrança. Dados nativos permanecem em GET
        /v1/runs/:id. auto só usa alternativas para erros do Provider, tempo
        esgotado ou admissão 503, nunca por resultados vazios.
      operationId: gtm-amazon-research
      parameters:
        - name: idempotency-key
          in: header
          schema:
            type: string
            minLength: 1
            description: >-
              Gere um novo valor exclusivo (de preferência um UUID aleatório)
              para cada consulta independente, mesmo com os mesmos parâmetros no
              mesmo dia. Recupere a mesma execução com a chave e os parâmetros
              originais para obter o Run original sem outra cobrança. Alterar os
              parâmetros de execução com a mesma chave retorna 409; alterar
              task_id ou metadata não inicia um novo Run. As chaves opacas
              existentes continuam válidas para recuperação.
          required: true
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                action:
                  type: string
                  enum:
                    - search
                    - product
                    - keywords
                    - keyword_volume
                    - reviews
                    - price_history
                    - offers
                    - merchant_search
                    - merchant_page
                country:
                  type: string
                  minLength: 1
                  description: >-
                    Mercado da Amazon explícito. Consultas gerais aceitam us,
                    gb, de, fr, it, es, ca, jp, in e au; termos relacionados
                    apenas us/en. keyword_volume aceita seus próprios pares de
                    região e idioma.
                provider:
                  anyOf:
                    - type: string
                      enum:
                        - auto
                        - serpapi
                        - dataforseo
                        - apify
                        - keepa
                        - serper
                      description: >-
                        Padrão auto: seleciona o primeiro provedor de dados
                        elegível na ordem de preferência da Glasser. Um provedor
                        de dados nomeado precisa ser compatível com a
                        solicitação e permitido pela sua Key; ele não usa
                        fallback para outro provedor de dados. Os valores
                        disponíveis estão listados abaixo.
                    - type: 'null'
                max_charge_usd:
                  anyOf:
                    - type: string
                      pattern: ^(0|[1-9]\d*)\.(\d{2}|\d{2}\d{0,3}[1-9])$
                      description: >-
                        String decimal exata em USD (mínimo de 2 e máximo de 6
                        casas decimais, com uma única grafia canônica). Some
                        usando aritmética decimal ou multiplique por 10^6 —
                        nunca use números de ponto flutuante.
                      maxLength: 20
                    - type: 'null'
                review_pages:
                  anyOf:
                    - type: integer
                      minimum: 1
                      maximum: 10
                    - type: 'null'
                review_rating:
                  anyOf:
                    - type: integer
                      minimum: 1
                      maximum: 5
                    - type: 'null'
                review_sort:
                  anyOf:
                    - type: string
                      enum:
                        - recent
                        - helpful
                    - type: 'null'
                verified_only:
                  anyOf:
                    - type: boolean
                    - type: 'null'
                review_keyword:
                  anyOf:
                    - type: string
                      minLength: 1
                      maxLength: 200
                    - type: 'null'
                url:
                  anyOf:
                    - type: string
                      minLength: 1
                      maxLength: 2048
                      pattern: ^https?:\/\/
                    - type: 'null'
                query:
                  anyOf:
                    - type: string
                      minLength: 1
                      maxLength: 200
                    - type: 'null'
                keywords:
                  anyOf:
                    - type: array
                      items:
                        type: string
                        minLength: 1
                      minItems: 1
                      maxItems: 1000
                    - type: 'null'
                asin:
                  anyOf:
                    - type: string
                      pattern: ^[A-Z0-9]{10}$
                    - type: 'null'
                page:
                  anyOf:
                    - type: integer
                      minimum: 1
                      maximum: 20
                    - type: 'null'
                limit:
                  anyOf:
                    - type: integer
                      minimum: 1
                      maximum: 100
                    - type: 'null'
                offset:
                  anyOf:
                    - type: integer
                      minimum: 0
                      maximum: 10000
                    - type: 'null'
                language:
                  anyOf:
                    - type: string
                      minLength: 1
                    - type: 'null'
                days:
                  anyOf:
                    - type: integer
                      minimum: 1
                    - type: 'null'
                task_id:
                  anyOf:
                    - type: string
                      description: >-
                        Agrupe Runs relacionados, incluindo o fallback
                        automático, em uma única Task. Reutilize uma string
                        estável e filtre a lista de Runs por task para
                        recuperá-los.
                    - type: 'null'
                metadata:
                  anyOf:
                    - anyOf:
                        - type: object
                          additionalProperties:
                            type: string
                            minLength: 1
                            maxLength: 500
                          maxProperties: 20
                          propertyNames:
                            type: string
                            pattern: ^[a-z][a-z0-9_]{0,39}$
                        - {}
                      description: >-
                        Campos de rastreamento opcionais, retornados no Run e
                        disponíveis como filtros. Eles nunca são enviados ao
                        provedor de dados nem afetam o roteamento, o preço ou a
                        idempotência.


                        - Até 20 chaves: letras minúsculas, dígitos e
                        sublinhados; comece com uma letra; no máximo 40
                        caracteres.

                        - Valores: strings de 1–500 caracteres.

                        - user_id: o ID opaco do seu usuário final, nunca o
                        endereço de e-mail ou o nome dele.


                        Entradas inválidas são descartadas integralmente, não
                        truncadas. A solicitação continua, e o Run retorna os
                        campos que foram armazenados.
                    - type: 'null'
              required:
                - action
                - country
              additionalProperties: false
              description: >-
                merchant_search: query e idioma opcional; merchant_page: url
                pública. search: query e page opcional; product/reviews/offers:
                asin exato. reviews aceita review_pages, review_rating,
                review_sort, verified_only e review_keyword. keywords: query e
                language/limit/offset opcionais, apenas us/en. keyword_volume:
                keywords e idioma. max_charge_usd limita a cobrança antes do
                Run. price_history: asin e days opcional, padrão 180. Campos
                incompatíveis são recusados antes da cobrança. Sem alterações de
                produtos, estimativas de taxas ou monitoramento automático.
        required: true
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                anyOf:
                  - $ref: '#/components/schemas/AmazonResearchResult'
        '202':
          description: Success
          content:
            application/json:
              schema:
                anyOf:
                  - $ref: '#/components/schemas/AmazonResearchResult'
        '400':
          description: ValidationFailed | IdempotencyKeyRequired
          content:
            application/json:
              schema:
                anyOf:
                  - $ref: '#/components/schemas/ValidationFailedEncoded'
                  - $ref: '#/components/schemas/IdempotencyKeyRequiredEncoded'
                  - $ref: '#/components/schemas/ValidationFailedEncoded'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UnauthorizedEncoded'
        '402':
          description: InsufficientBalance
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InsufficientBalanceEncoded'
        '403':
          description: EndpointNotPermitted | Forbidden
          content:
            application/json:
              schema:
                anyOf:
                  - $ref: '#/components/schemas/EndpointNotPermittedEncoded'
                  - $ref: '#/components/schemas/ForbiddenEncoded'
        '409':
          description: IdempotencyConflict
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/IdempotencyConflictEncoded'
        '429':
          description: RateLimited
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RateLimitedEncoded'
        '503':
          description: ServiceUnavailable
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ServiceUnavailableEncoded'
      security:
        - bearer: []
components:
  schemas:
    AmazonResearchResult:
      type: object
      properties:
        id:
          type: string
        run_url:
          type: string
          description: Abra este Run no console. Requer associação ao Workspace.
        provider:
          type: string
          pattern: ^[a-z0-9][a-z0-9-]*$
        endpoint:
          type: string
          pattern: ^\/.+$
        endpoint_version:
          type: integer
          exclusiveMinimum: 0
        status:
          type: string
          enum:
            - QUEUED
            - RUNNING
            - COMPLETED
            - FAILED
            - STOPPED
          description: >-
            QUEUED ou RUNNING: ainda em andamento. COMPLETED: uma resposta do
            provedor de dados está disponível, incluindo respostas não 2xx.
            FAILED: consulte `failure`. STOPPED: interrompido antes do despacho.
            Leia charge_usd separadamente de status.
        failure:
          anyOf:
            - type: object
              properties:
                kind:
                  type: string
                  enum:
                    - TIMED_OUT
                    - INTERNAL
                message:
                  type: string
              required:
                - kind
                - message
              additionalProperties: false
            - type: 'null'
          description: Motivo da falha do Run. Não nulo somente quando status é FAILED.
        input:
          anyOf:
            - type: object
            - type: array
              items:
                type: object
        output:
          anyOf:
            - anyOf:
                - type: object
                  properties:
                    items:
                      type: array
                      items:
                        type: object
                        properties:
                          asin:
                            anyOf:
                              - type: string
                              - type: 'null'
                          title:
                            anyOf:
                              - type: string
                              - type: 'null'
                          url:
                            anyOf:
                              - type: string
                              - type: 'null'
                          brand:
                            anyOf:
                              - type: string
                              - type: 'null'
                          image_url:
                            anyOf:
                              - type: string
                              - type: 'null'
                          price:
                            anyOf:
                              - anyOf:
                                  - type: number
                                  - type: string
                                    enum:
                                      - Infinity
                                      - '-Infinity'
                                      - NaN
                              - type: 'null'
                          price_text:
                            anyOf:
                              - type: string
                              - type: 'null'
                          currency:
                            anyOf:
                              - type: string
                              - type: 'null'
                          rating:
                            anyOf:
                              - anyOf:
                                  - type: number
                                  - type: string
                                    enum:
                                      - Infinity
                                      - '-Infinity'
                                      - NaN
                              - type: 'null'
                          reviews:
                            anyOf:
                              - type: integer
                              - type: 'null'
                            description: >-
                              Total de avaliações exibido pelo Provider; pode
                              agrupar variantes. Não é o tamanho da amostra
                              coletada.
                          position:
                            anyOf:
                              - type: integer
                              - type: 'null'
                          sponsored:
                            anyOf:
                              - type: boolean
                              - type: 'null'
                          bought_past_month_text:
                            anyOf:
                              - type: string
                              - type: 'null'
                          stock_text:
                            anyOf:
                              - type: string
                              - type: 'null'
                          condition_text:
                            anyOf:
                              - type: string
                              - type: 'null'
                          price_basis:
                            type: string
                            enum:
                              - displayed_listing_price
                          variants:
                            type: array
                            items:
                              type: object
                              properties:
                                asin:
                                  anyOf:
                                    - type: string
                                    - type: 'null'
                                label:
                                  anyOf:
                                    - type: string
                                    - type: 'null'
                                selected:
                                  anyOf:
                                    - type: boolean
                                    - type: 'null'
                              required:
                                - asin
                                - label
                                - selected
                              additionalProperties: false
                          attributes:
                            type: array
                            items:
                              type: object
                              properties:
                                name:
                                  anyOf:
                                    - type: string
                                    - type: 'null'
                                value:
                                  anyOf:
                                    - type: string
                                    - type: 'null'
                              required:
                                - name
                                - value
                              additionalProperties: false
                        required:
                          - asin
                          - title
                          - url
                          - brand
                          - image_url
                          - price
                          - price_text
                          - currency
                          - rating
                          - reviews
                          - position
                          - sponsored
                          - bought_past_month_text
                          - stock_text
                          - condition_text
                          - price_basis
                          - variants
                          - attributes
                        additionalProperties: false
                    amazon_domain:
                      anyOf:
                        - type: string
                        - type: 'null'
                    total_matches:
                      anyOf:
                        - type: integer
                        - type: 'null'
                    next_page:
                      anyOf:
                        - type: integer
                        - type: 'null'
                  required:
                    - items
                    - amazon_domain
                    - total_matches
                    - next_page
                  additionalProperties: false
                - type: object
                  properties:
                    product:
                      type: object
                      properties:
                        asin:
                          anyOf:
                            - type: string
                            - type: 'null'
                        title:
                          anyOf:
                            - type: string
                            - type: 'null'
                        url:
                          anyOf:
                            - type: string
                            - type: 'null'
                        brand:
                          anyOf:
                            - type: string
                            - type: 'null'
                        image_url:
                          anyOf:
                            - type: string
                            - type: 'null'
                        price:
                          anyOf:
                            - anyOf:
                                - type: number
                                - type: string
                                  enum:
                                    - Infinity
                                    - '-Infinity'
                                    - NaN
                            - type: 'null'
                        price_text:
                          anyOf:
                            - type: string
                            - type: 'null'
                        currency:
                          anyOf:
                            - type: string
                            - type: 'null'
                        rating:
                          anyOf:
                            - anyOf:
                                - type: number
                                - type: string
                                  enum:
                                    - Infinity
                                    - '-Infinity'
                                    - NaN
                            - type: 'null'
                        reviews:
                          anyOf:
                            - type: integer
                            - type: 'null'
                          description: >-
                            Total de avaliações exibido pelo Provider; pode
                            agrupar variantes. Não é o tamanho da amostra
                            coletada.
                        position:
                          anyOf:
                            - type: integer
                            - type: 'null'
                        sponsored:
                          anyOf:
                            - type: boolean
                            - type: 'null'
                        bought_past_month_text:
                          anyOf:
                            - type: string
                            - type: 'null'
                        stock_text:
                          anyOf:
                            - type: string
                            - type: 'null'
                        condition_text:
                          anyOf:
                            - type: string
                            - type: 'null'
                        price_basis:
                          type: string
                          enum:
                            - displayed_listing_price
                        variants:
                          type: array
                          items:
                            type: object
                            properties:
                              asin:
                                anyOf:
                                  - type: string
                                  - type: 'null'
                              label:
                                anyOf:
                                  - type: string
                                  - type: 'null'
                              selected:
                                anyOf:
                                  - type: boolean
                                  - type: 'null'
                            required:
                              - asin
                              - label
                              - selected
                            additionalProperties: false
                        attributes:
                          type: array
                          items:
                            type: object
                            properties:
                              name:
                                anyOf:
                                  - type: string
                                  - type: 'null'
                              value:
                                anyOf:
                                  - type: string
                                  - type: 'null'
                            required:
                              - name
                              - value
                            additionalProperties: false
                      required:
                        - asin
                        - title
                        - url
                        - brand
                        - image_url
                        - price
                        - price_text
                        - currency
                        - rating
                        - reviews
                        - position
                        - sponsored
                        - bought_past_month_text
                        - stock_text
                        - condition_text
                        - price_basis
                        - variants
                        - attributes
                      additionalProperties: false
                    amazon_domain:
                      anyOf:
                        - type: string
                        - type: 'null'
                    purchase_options:
                      type: array
                      items:
                        type: object
                        properties:
                          condition:
                            anyOf:
                              - type: string
                              - type: 'null'
                          price:
                            anyOf:
                              - anyOf:
                                  - type: number
                                  - type: string
                                    enum:
                                      - Infinity
                                      - '-Infinity'
                                      - NaN
                              - type: 'null'
                          price_text:
                            anyOf:
                              - type: string
                              - type: 'null'
                          stock_text:
                            anyOf:
                              - type: string
                              - type: 'null'
                          seller_text:
                            anyOf:
                              - type: string
                              - type: 'null'
                        required:
                          - condition
                          - price
                          - price_text
                          - stock_text
                          - seller_text
                        additionalProperties: false
                  required:
                    - product
                    - amazon_domain
                    - purchase_options
                  additionalProperties: false
                - type: object
                  properties:
                    mode:
                      type: string
                      enum:
                        - related
                        - exact
                    location_code:
                      anyOf:
                        - type: integer
                        - type: 'null'
                    language:
                      anyOf:
                        - type: string
                        - type: 'null'
                    items:
                      type: array
                      items:
                        type: object
                        properties:
                          keyword:
                            anyOf:
                              - type: string
                              - type: 'null'
                          dataforseo_search_volume:
                            anyOf:
                              - type: integer
                              - type: 'null'
                          updated_at:
                            anyOf:
                              - type: string
                              - type: 'null'
                        required:
                          - keyword
                          - dataforseo_search_volume
                          - updated_at
                        additionalProperties: false
                    total_matches:
                      anyOf:
                        - type: integer
                        - type: 'null'
                    next_offset:
                      anyOf:
                        - type: integer
                        - type: 'null'
                  required:
                    - mode
                    - location_code
                    - language
                    - items
                    - total_matches
                    - next_offset
                  additionalProperties: false
                  description: >-
                    Estimativas de buscas da Amazon por termo do DataForSEO, não
                    vendas. Não some termos sobrepostos como tamanho de mercado.
                - type: object
                  properties:
                    asin:
                      anyOf:
                        - type: string
                        - type: 'null'
                    amazon_domain:
                      anyOf:
                        - type: string
                        - type: 'null'
                    items:
                      type: array
                      items:
                        type: object
                        properties:
                          id:
                            anyOf:
                              - type: string
                              - type: 'null'
                          url:
                            anyOf:
                              - type: string
                              - type: 'null'
                          asin:
                            anyOf:
                              - type: string
                              - type: 'null'
                          title:
                            anyOf:
                              - type: string
                              - type: 'null'
                          text:
                            anyOf:
                              - type: string
                              - type: 'null'
                          rating:
                            anyOf:
                              - anyOf:
                                  - type: number
                                  - type: string
                                    enum:
                                      - Infinity
                                      - '-Infinity'
                                      - NaN
                              - type: 'null'
                          published_at:
                            anyOf:
                              - type: string
                              - type: 'null'
                          date_text:
                            anyOf:
                              - type: string
                              - type: 'null'
                          verified_purchase:
                            anyOf:
                              - type: boolean
                              - type: 'null'
                          vine:
                            anyOf:
                              - type: boolean
                              - type: 'null'
                          language:
                            anyOf:
                              - type: string
                              - type: 'null'
                          helpful_votes:
                            anyOf:
                              - type: integer
                              - type: 'null'
                          variation_asin:
                            anyOf:
                              - type: string
                              - type: 'null'
                          variant_attributes:
                            type: array
                            items:
                              type: string
                        required:
                          - id
                          - url
                          - asin
                          - title
                          - text
                          - rating
                          - published_at
                          - date_text
                          - verified_purchase
                          - vine
                          - language
                          - helpful_votes
                          - variation_asin
                          - variant_attributes
                        additionalProperties: false
                    sample_kind:
                      type: string
                      enum:
                        - recent_page
                        - filtered_pages
                    sampling:
                      type: object
                      properties:
                        requested_pages:
                          anyOf:
                            - type: integer
                            - type: 'null'
                        observed_pages:
                          type: array
                          items:
                            type: integer
                        sort:
                          anyOf:
                            - type: string
                            - type: 'null'
                        rating_filter:
                          anyOf:
                            - type: string
                            - type: 'null'
                        keyword_filter:
                          anyOf:
                            - type: string
                            - type: 'null'
                        reviewer_type:
                          anyOf:
                            - type: string
                            - type: 'null'
                        representative:
                          type: string
                          enum:
                            - not_established
                      required:
                        - requested_pages
                        - observed_pages
                        - sort
                        - rating_filter
                        - keyword_filter
                        - reviewer_type
                        - representative
                      additionalProperties: false
                    next_cursor:
                      type: 'null'
                  required:
                    - asin
                    - amazon_domain
                    - items
                    - sample_kind
                    - sampling
                    - next_cursor
                  additionalProperties: false
                  description: >-
                    Páginas limitadas pelo orçamento, com filtros de estrelas,
                    palavras ou compra verificada. Separe páginas solicitadas e
                    observadas. Sem afirmação de representatividade; alegações
                    não são verificadas.
                - type: object
                  properties:
                    updated_at:
                      anyOf:
                        - type: string
                        - type: 'null'
                    asin:
                      anyOf:
                        - type: string
                        - type: 'null'
                    title:
                      anyOf:
                        - type: string
                        - type: 'null'
                    amazon_domain:
                      anyOf:
                        - type: string
                        - type: 'null'
                    currency:
                      anyOf:
                        - type: string
                        - type: 'null'
                    series:
                      type: array
                      items:
                        type: object
                        properties:
                          price_type:
                            type: string
                            enum:
                              - AMAZON
                              - NEW
                              - LISTPRICE
                          points:
                            type: array
                            items:
                              type: object
                              properties:
                                observed_at:
                                  type: string
                                price:
                                  anyOf:
                                    - anyOf:
                                        - type: number
                                        - type: string
                                          enum:
                                            - Infinity
                                            - '-Infinity'
                                            - NaN
                                    - type: 'null'
                                available:
                                  type: boolean
                              required:
                                - observed_at
                                - price
                                - available
                              additionalProperties: false
                        required:
                          - price_type
                          - points
                        additionalProperties: false
                  required:
                    - updated_at
                    - asin
                    - title
                    - amazon_domain
                    - currency
                    - series
                  additionalProperties: false
                  description: >-
                    Séries de preços separadas do Keepa. Valores indisponíveis
                    têm price=null. NEW mudou de definição em 2026-02-23; não
                    una bases entre os dois lados dessa data. O histórico não é
                    uma cotação de compra.
                - type: object
                  properties:
                    asin:
                      anyOf:
                        - type: string
                        - type: 'null'
                    title:
                      anyOf:
                        - type: string
                        - type: 'null'
                    amazon_domain:
                      anyOf:
                        - type: string
                        - type: 'null'
                    currency:
                      anyOf:
                        - type: string
                        - type: 'null'
                    updated_at:
                      anyOf:
                        - type: string
                        - type: 'null'
                    refresh_success:
                      anyOf:
                        - type: boolean
                        - type: 'null'
                    parent_asin:
                      anyOf:
                        - type: string
                        - type: 'null'
                    number_of_items:
                      anyOf:
                        - type: integer
                        - type: 'null'
                    package_quantity:
                      anyOf:
                        - type: integer
                        - type: 'null'
                    size:
                      anyOf:
                        - type: string
                        - type: 'null'
                    color:
                      anyOf:
                        - type: string
                        - type: 'null'
                    material:
                      anyOf:
                        - type: string
                        - type: 'null'
                    fee_context:
                      type: object
                      properties:
                        fulfillment_fee:
                          anyOf:
                            - anyOf:
                                - type: number
                                - type: string
                                  enum:
                                    - Infinity
                                    - '-Infinity'
                                    - NaN
                            - type: 'null'
                        updated_at:
                          anyOf:
                            - type: string
                            - type: 'null'
                        referral_fee_percent:
                          anyOf:
                            - anyOf:
                                - type: number
                                - type: string
                                  enum:
                                    - Infinity
                                    - '-Infinity'
                                    - NaN
                            - type: 'null'
                      required:
                        - fulfillment_fee
                        - updated_at
                        - referral_fee_percent
                      additionalProperties: false
                    items:
                      type: array
                      items:
                        type: object
                        properties:
                          seller_id:
                            anyOf:
                              - type: string
                              - type: 'null'
                          condition_code:
                            anyOf:
                              - type: integer
                              - type: 'null'
                          condition_text:
                            anyOf:
                              - type: string
                              - type: 'null'
                          is_amazon:
                            anyOf:
                              - type: boolean
                              - type: 'null'
                          fulfilled_by_amazon:
                            anyOf:
                              - type: boolean
                              - type: 'null'
                          last_seen_at:
                            anyOf:
                              - type: string
                              - type: 'null'
                          price_observed_at:
                            anyOf:
                              - type: string
                              - type: 'null'
                          price:
                            anyOf:
                              - anyOf:
                                  - type: number
                                  - type: string
                                    enum:
                                      - Infinity
                                      - '-Infinity'
                                      - NaN
                              - type: 'null'
                          shipping:
                            anyOf:
                              - anyOf:
                                  - type: number
                                  - type: string
                                    enum:
                                      - Infinity
                                      - '-Infinity'
                                      - NaN
                              - type: 'null'
                          landed_price:
                            anyOf:
                              - anyOf:
                                  - type: number
                                  - type: string
                                    enum:
                                      - Infinity
                                      - '-Infinity'
                                      - NaN
                              - type: 'null'
                        required:
                          - seller_id
                          - condition_code
                          - condition_text
                          - is_amazon
                          - fulfilled_by_amazon
                          - last_seen_at
                          - price_observed_at
                          - price
                          - shipping
                          - landed_price
                        additionalProperties: false
                  required:
                    - asin
                    - title
                    - amazon_domain
                    - currency
                    - updated_at
                    - refresh_success
                    - parent_asin
                    - number_of_items
                    - package_quantity
                    - size
                    - color
                    - material
                    - fee_context
                    - items
                  additionalProperties: false
                  description: >-
                    Ofertas observadas do Keepa para o ASIN exato. Códigos de
                    condição preservam seu significado; última observação e
                    mudança de preço são datas distintas. O cache não é uma
                    cotação de compra verificada. Taxas do concorrente são
                    contexto, não custos do SKU proposto.
                - type: object
                  properties:
                    items:
                      type: array
                      items:
                        type: object
                        properties:
                          title:
                            anyOf:
                              - type: string
                              - type: 'null'
                          url:
                            anyOf:
                              - type: string
                              - type: 'null'
                            description: A página do produto no Google Shopping.
                          merchant_url:
                            anyOf:
                              - type: string
                              - type: 'null'
                            description: >-
                              URL da oferta do comerciante quando informada pelo
                              provedor de dados (link do SerpApi); null para o
                              Serper.
                          google_product_id:
                            anyOf:
                              - type: string
                              - type: 'null'
                            description: >-
                              ID do produto no catálogo do Google Shopping
                              (productId do Serper, product_id do SerpApi).
                          price_text:
                            anyOf:
                              - type: string
                              - type: 'null'
                            description: >-
                              Preço de exibição do provedor de dados, como
                              '$69.00'. Não é analisado; a moeda segue o país.
                          seller:
                            anyOf:
                              - type: string
                              - type: 'null'
                          rating:
                            anyOf:
                              - anyOf:
                                  - type: number
                                  - type: string
                                    enum:
                                      - Infinity
                                      - '-Infinity'
                                      - NaN
                              - type: 'null'
                            description: Avaliação média em estrelas do Google, de 1 a 5.
                          reviews:
                            anyOf:
                              - type: integer
                              - type: 'null'
                            description: >-
                              Número de avaliações do Google que compõem a
                              classificação.
                          image_url:
                            anyOf:
                              - type: string
                              - type: 'null'
                        required:
                          - title
                          - url
                          - merchant_url
                          - google_product_id
                          - price_text
                          - seller
                          - rating
                          - reviews
                          - image_url
                        additionalProperties: false
                  required:
                    - items
                  additionalProperties: false
                - type: object
                  properties:
                    url:
                      type: string
                      description: >-
                        A URL solicitada ou a URL final quando o provedor de
                        dados informar uma.
                    final_url:
                      anyOf:
                        - type: string
                        - type: 'null'
                      description: >-
                        A URL após o redirecionamento conforme informada pelo
                        provedor de dados (Firecrawl, Exa). Null quando o
                        provedor de dados não informar uma.
                    title:
                      anyOf:
                        - type: string
                        - type: 'null'
                    text:
                      anyOf:
                        - type: string
                        - type: 'null'
                    markdown:
                      anyOf:
                        - type: string
                        - type: 'null'
                    html:
                      anyOf:
                        - type: string
                        - type: 'null'
                    raw_html:
                      anyOf:
                        - type: string
                        - type: 'null'
                    text_character_limit:
                      anyOf:
                        - type: integer
                        - type: 'null'
                      description: >-
                        O limite de caracteres que o Glasser pediu ao provedor
                        de dados para aplicar ao texto (10000 para Exa);
                        portanto, um texto com exatamente esse tamanho pode ser
                        truncado. Null quando nenhum limite foi aplicado.
                    cached:
                      anyOf:
                        - type: boolean
                        - type: 'null'
                      description: >-
                        Indica se o provedor de dados forneceu a página a partir
                        do cache (cacheState do Firecrawl, status source do
                        Exa). Null quando o provedor de dados não informar.
                    fetched_at:
                      anyOf:
                        - type: string
                        - type: 'null'
                      description: >-
                        Quando o provedor de dados buscou a página, em UTC ISO
                        8601 (fetch_time do DataForSEO). Null quando o provedor
                        de dados não informar.
                    quality:
                      type: string
                      enum:
                        - unverified
                      description: >-
                        Obsoleto: sempre 'unverified'; nenhuma verificação de
                        conteúdo é aplicada. Mantido para compatibilidade e será
                        removido na próxima revisão com alterações
                        incompatíveis.
                  required:
                    - url
                    - final_url
                    - title
                    - text
                    - markdown
                    - html
                    - raw_html
                    - text_character_limit
                    - cached
                    - fetched_at
                    - quality
                  additionalProperties: false
            - type: 'null'
        response_file:
          type: object
          properties:
            body_field:
              type: string
              enum:
                - output
                - provider_response.error
            state:
              type: string
              enum:
                - available
                - link_pending
                - expired
                - unavailable
            download_url:
              anyOf:
                - type: string
                - type: 'null'
            link_expires_at:
              anyOf:
                - type: string
                  description: carimbo de data e hora UTC ISO-8601
                  format: date-time
                - type: 'null'
            file_expires_at:
              type: string
              description: carimbo de data e hora UTC ISO-8601
              format: date-time
            bytes:
              type: integer
              minimum: 0
            sha256:
              type: string
            content_type:
              type: string
              enum:
                - application/json
          required:
            - body_field
            - state
            - download_url
            - link_expires_at
            - file_expires_at
            - bytes
            - sha256
            - content_type
          additionalProperties: false
          description: >-
            Corpo completo e de grande tamanho do provedor de dados, entregue
            como arquivo JSON. O Glasser aplica um limite de recursos de 32 MiB
            ao corpo capturado e ao arquivo serializado. body_field identifica o
            campo substituído; output é null ou provider_response.error é
            omitido. Os links de download expiram em no máximo uma hora. Get Run
            com autenticação renova a URL enquanto o arquivo estiver disponível,
            por 7 dias. Leituras e downloads não executam nem cobram outro Run.
            Se state for link_pending, leia o mesmo Run para preparar o link sem
            outra execução ou cobrança. A URL concede acesso temporário de
            leitura: compartilhe-a apenas com os destinatários pretendidos.
        provider_response:
          anyOf:
            - type: object
              properties:
                http_status:
                  type: integer
                  minimum: 100
                  maximum: 599
                  description: >-
                    Status HTTP retornado pelo provedor de dados. Verifique-o
                    mesmo quando o Run estiver COMPLETED.
                error:
                  anyOf:
                    - {}
                    - type: 'null'
              required:
                - http_status
              additionalProperties: false
            - type: 'null'
          description: >-
            Não nulo somente quando status é COMPLETED.


            - Para respostas 2xx, output contém JSON nativo do provedor de dados
            (qualquer estrutura) ou nulo para um corpo vazio.

            - Para respostas não 2xx, error contém o corpo de erro do provedor
            de dados e output é nulo.


            Os campos confidenciais são removidos de ambos os corpos.
        charge_usd:
          anyOf:
            - type: string
              pattern: ^(0|[1-9]\d*)\.(\d{2}|\d{2}\d{0,3}[1-9])$
              description: >-
                String decimal exata em USD (mínimo de 2 e máximo de 6 casas
                decimais, com uma única grafia canônica). Some usando aritmética
                decimal ou multiplique por 10^6 — nunca use números de ponto
                flutuante.
            - type: 'null'
          description: >-
            Cobrança histórica total dos Runs listados, incluindo os
            reproduzidos ou lidos. É null até que todos sejam liquidados. Não é
            uma nova despesa da solicitação atual; request_charge a informa
            separadamente. Falhas também podem ser cobradas.
        charge_basis:
          anyOf:
            - type: object
              properties:
                clause:
                  type: string
                  enum:
                    - rule
                    - NO_RESULT
                    - PROVIDER_ERROR
                    - TIMED_OUT
                    - INTERNAL
                quantity:
                  anyOf:
                    - type: integer
                      minimum: 0
                    - type: 'null'
              required:
                - clause
                - quantity
              additionalProperties: false
            - type: 'null'
          description: >-
            Base de cobrança de um único Run ou nulo para um total de vários
            Runs. Leia runs[].charge_basis para cada cobrança.
        stoppable:
          type: boolean
          description: >-
            Indica se uma solicitação de interrupção pode ser aceita no momento.
            Isso não garante que o Run possa ser interrompido antes do despacho.
        stop_requested_at:
          anyOf:
            - type: string
              description: carimbo de data e hora UTC ISO-8601
              format: date-time
            - type: 'null'
          description: >-
            Momento em que uma interrupção foi solicitada. O Run ainda pode
            continuar se o despacho já tiver começado.
        created_at:
          type: string
          description: carimbo de data e hora UTC ISO-8601
          format: date-time
        started_at:
          anyOf:
            - type: string
              description: carimbo de data e hora UTC ISO-8601
              format: date-time
            - type: 'null'
        completed_at:
          anyOf:
            - type: string
              description: carimbo de data e hora UTC ISO-8601
              format: date-time
            - type: 'null'
        task_id:
          anyOf:
            - type: string
            - type: 'null'
        metadata:
          type: object
          additionalProperties:
            type: string
            minLength: 1
            maxLength: 500
          maxProperties: 20
          propertyNames:
            type: string
            pattern: ^[a-z][a-z0-9_]{0,39}$
          description: >-
            Seus campos de acompanhamento armazenados. Use-os para filtrar Runs.
            Eles nunca são enviados ao provedor de dados nem afetam o
            roteamento, o Price ou a idempotência.


            - Até 20 chaves: letras minúsculas, dígitos e sublinhados; comece
            com uma letra; no máximo 40 caracteres.

            - Valores: strings de 1–500 caracteres.

            - user_id: o ID opaco do seu usuário final, nunca o endereço de
            e-mail ou o nome dele.
        review_invitation:
          type: object
          properties:
            run_id:
              type: string
            ratings:
              type: array
              items:
                type: string
                enum:
                  - exceeds_expectations
                  - meets_expectations
                  - partially_meets_expectations
                  - does_not_meet_expectations
                  - unable_to_assess
            instruction:
              type: string
          required:
            - run_id
            - ratings
            - instruction
          additionalProperties: false
          description: >-
            Aparece no máximo uma vez por Run, na primeira entrega de alguns
            Runs concluídos. Depois de usar este resultado na tarefa, envie uma
            avaliação conforme indicado em instruction e continue. É opcional;
            nunca afeta o Run nem a cobrança.
        action:
          type: string
          enum:
            - search
            - product
            - keywords
            - keyword_volume
            - reviews
            - price_history
            - offers
            - merchant_search
            - merchant_page
        result_status:
          type: string
          enum:
            - success
            - no_result
            - error
            - pending
        error:
          anyOf:
            - type: object
              properties:
                code:
                  type: string
                message:
                  type: string
              required:
                - code
                - message
              additionalProperties: false
            - type: 'null'
        runs:
          type: array
          items:
            type: object
            properties:
              id:
                type: string
              run_url:
                type: string
                description: Abra este Run no console. Requer associação ao Workspace.
              provider:
                type: string
                pattern: ^[a-z0-9][a-z0-9-]*$
              endpoint:
                type: string
                pattern: ^\/.+$
              endpoint_version:
                type: integer
                exclusiveMinimum: 0
              status:
                type: string
                enum:
                  - QUEUED
                  - RUNNING
                  - COMPLETED
                  - FAILED
                  - STOPPED
                description: >-
                  QUEUED ou RUNNING: ainda em andamento. COMPLETED: uma resposta
                  do provedor de dados está disponível, incluindo respostas não
                  2xx. FAILED: consulte `failure`. STOPPED: interrompido antes
                  do despacho. Leia charge_usd separadamente de status.
              failure:
                anyOf:
                  - type: object
                    properties:
                      kind:
                        type: string
                        enum:
                          - TIMED_OUT
                          - INTERNAL
                      message:
                        type: string
                    required:
                      - kind
                      - message
                    additionalProperties: false
                  - type: 'null'
                description: >-
                  Motivo da falha do Run. Não nulo somente quando status é
                  FAILED.
              input:
                type: object
                properties:
                  omitted:
                    type: boolean
                    enum:
                      - true
                required:
                  - omitted
                additionalProperties: false
              output:
                type: object
                properties:
                  omitted:
                    type: boolean
                    enum:
                      - true
                required:
                  - omitted
                additionalProperties: false
              response_file:
                type: object
                properties:
                  body_field:
                    type: string
                    enum:
                      - output
                      - provider_response.error
                  state:
                    type: string
                    enum:
                      - available
                      - link_pending
                      - expired
                      - unavailable
                  download_url:
                    anyOf:
                      - type: string
                      - type: 'null'
                  link_expires_at:
                    anyOf:
                      - type: string
                        description: carimbo de data e hora UTC ISO-8601
                        format: date-time
                      - type: 'null'
                  file_expires_at:
                    type: string
                    description: carimbo de data e hora UTC ISO-8601
                    format: date-time
                  bytes:
                    type: integer
                    minimum: 0
                  sha256:
                    type: string
                  content_type:
                    type: string
                    enum:
                      - application/json
                required:
                  - body_field
                  - state
                  - download_url
                  - link_expires_at
                  - file_expires_at
                  - bytes
                  - sha256
                  - content_type
                additionalProperties: false
                description: >-
                  Corpo completo e de grande tamanho do provedor de dados,
                  entregue como arquivo JSON. O Glasser aplica um limite de
                  recursos de 32 MiB ao corpo capturado e ao arquivo
                  serializado. body_field identifica o campo substituído; output
                  é null ou provider_response.error é omitido. Os links de
                  download expiram em no máximo uma hora. Get Run com
                  autenticação renova a URL enquanto o arquivo estiver
                  disponível, por 7 dias. Leituras e downloads não executam nem
                  cobram outro Run. Se state for link_pending, leia o mesmo Run
                  para preparar o link sem outra execução ou cobrança. A URL
                  concede acesso temporário de leitura: compartilhe-a apenas com
                  os destinatários pretendidos.
              provider_response:
                anyOf:
                  - type: object
                    properties:
                      http_status:
                        type: integer
                        minimum: 100
                        maximum: 599
                        description: >-
                          Status HTTP retornado pelo provedor de dados.
                          Verifique-o mesmo quando o Run estiver COMPLETED.
                    required:
                      - http_status
                    additionalProperties: false
                  - type: 'null'
              charge_usd:
                anyOf:
                  - type: string
                    pattern: ^(0|[1-9]\d*)\.(\d{2}|\d{2}\d{0,3}[1-9])$
                    description: >-
                      String decimal exata em USD (mínimo de 2 e máximo de 6
                      casas decimais, com uma única grafia canônica). Some
                      usando aritmética decimal ou multiplique por 10^6 — nunca
                      use números de ponto flutuante.
                  - type: 'null'
                description: >-
                  Cobrança final como uma string decimal exata em USD. Nulo
                  enquanto estiver QUEUED ou RUNNING. Um Run FAILED pode ter uma
                  cobrança diferente de zero conforme o Price do Endpoint.
              charge_basis:
                anyOf:
                  - type: object
                    properties:
                      clause:
                        type: string
                        enum:
                          - rule
                          - NO_RESULT
                          - PROVIDER_ERROR
                          - TIMED_OUT
                          - INTERNAL
                      quantity:
                        anyOf:
                          - type: integer
                            minimum: 0
                          - type: 'null'
                    required:
                      - clause
                      - quantity
                    additionalProperties: false
                  - type: 'null'
                description: >-
                  Cláusula de Price usada para calcular a cobrança. Nulo antes
                  da liquidação ou quando nenhuma tentativa com o provedor de
                  dados foi feita.
              stoppable:
                type: boolean
                description: >-
                  Indica se uma solicitação de interrupção pode ser aceita no
                  momento. Isso não garante que o Run possa ser interrompido
                  antes do despacho.
              stop_requested_at:
                anyOf:
                  - type: string
                    description: carimbo de data e hora UTC ISO-8601
                    format: date-time
                  - type: 'null'
                description: >-
                  Momento em que uma interrupção foi solicitada. O Run ainda
                  pode continuar se o despacho já tiver começado.
              created_at:
                type: string
                description: carimbo de data e hora UTC ISO-8601
                format: date-time
              started_at:
                anyOf:
                  - type: string
                    description: carimbo de data e hora UTC ISO-8601
                    format: date-time
                  - type: 'null'
              completed_at:
                anyOf:
                  - type: string
                    description: carimbo de data e hora UTC ISO-8601
                    format: date-time
                  - type: 'null'
              task_id:
                anyOf:
                  - type: string
                  - type: 'null'
              metadata:
                type: object
                additionalProperties:
                  type: string
                  minLength: 1
                  maxLength: 500
                maxProperties: 20
                propertyNames:
                  type: string
                  pattern: ^[a-z][a-z0-9_]{0,39}$
                description: >-
                  Seus campos de acompanhamento armazenados. Use-os para filtrar
                  Runs. Eles nunca são enviados ao provedor de dados nem afetam
                  o roteamento, o Price ou a idempotência.


                  - Até 20 chaves: letras minúsculas, dígitos e sublinhados;
                  comece com uma letra; no máximo 40 caracteres.

                  - Valores: strings de 1–500 caracteres.

                  - user_id: o ID opaco do seu usuário final, nunca o endereço
                  de e-mail ou o nome dele.
            required:
              - id
              - run_url
              - provider
              - endpoint
              - endpoint_version
              - status
              - failure
              - input
              - output
              - provider_response
              - charge_usd
              - charge_basis
              - stoppable
              - stop_requested_at
              - created_at
              - started_at
              - completed_at
              - task_id
              - metadata
            additionalProperties: false
        request_charge:
          type: object
          properties:
            charge_usd:
              anyOf:
                - type: string
                  pattern: ^(0|[1-9]\d*)\.(\d{2}|\d{2}\d{0,3}[1-9])$
                  description: >-
                    String decimal exata em USD (mínimo de 2, máximo de 6 casas
                    decimais, uma única grafia canônica). Faça a soma com
                    aritmética decimal ou multiplique por 10^6 — nunca use
                    números de ponto flutuante.
                - type: 'null'
              description: >-
                Cobrança apenas dos Runs criados por esta solicitação. Runs
                reproduzidos e leituras gratuitas acrescentam zero. É null
                enquanto um novo Run não estiver liquidado ou sua origem de
                admissão for desconhecida. Não é o total histórico de charge_usd
                ou runs[].charge_usd.
            created_run_ids:
              type: array
              items:
                type: string
                pattern: >-
                  ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|[fF]{8}-[fF]{4}-[fF]{4}-[fF]{4}-[fF]{12})$
                format: uuid
            replayed_run_ids:
              type: array
              items:
                type: string
                pattern: >-
                  ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|[fF]{8}-[fF]{4}-[fF]{4}-[fF]{4}-[fF]{12})$
                format: uuid
            unknown_run_ids:
              type: array
              items:
                type: string
                pattern: >-
                  ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|[fF]{8}-[fF]{4}-[fF]{4}-[fF]{4}-[fF]{12})$
                format: uuid
          required:
            - charge_usd
            - created_run_ids
            - replayed_run_ids
            - unknown_run_ids
          additionalProperties: false
          description: >-
            Evidência de admissão e cobrança da solicitação atual. Preserve
            created_run_ids durante o trabalho do usuário e conte cada Run
            liquidado uma única vez. Alterar task_id não transforma uma
            reprodução idempotente em um novo Run. A leitura de resultado tem
            cobrança zero e listas de admissão vazias.
        result_url:
          type: string
          description: >-
            Caminho de URL autenticado e somente leitura para consultar este
            resultado normalizado e a cobrança total. Use com a origem da API.
            Não cria Runs nem retoma o fallback. GET /v1/runs/:id ainda retorna
            o Run nativo e individual.
      required:
        - id
        - run_url
        - provider
        - endpoint
        - endpoint_version
        - status
        - failure
        - input
        - output
        - provider_response
        - charge_usd
        - charge_basis
        - stoppable
        - stop_requested_at
        - created_at
        - started_at
        - completed_at
        - task_id
        - metadata
        - action
        - result_status
        - error
        - runs
        - result_url
      additionalProperties: false
    ValidationFailedEncoded:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              enum:
                - validation_failed
            message:
              type: string
            reason:
              anyOf:
                - type: string
                - type: 'null'
            control:
              anyOf:
                - type: string
                - type: 'null'
            retry_after_ms:
              anyOf:
                - anyOf:
                    - type: integer
                    - type: 'null'
                - type: 'null'
            details:
              anyOf:
                - type: object
                - type: 'null'
          required:
            - code
            - message
          additionalProperties: false
        request_id:
          type: string
      required:
        - error
        - request_id
      additionalProperties: false
    IdempotencyKeyRequiredEncoded:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              enum:
                - idempotency_key_required
            message:
              type: string
            reason:
              anyOf:
                - type: string
                - type: 'null'
            control:
              anyOf:
                - type: string
                - type: 'null'
            retry_after_ms:
              anyOf:
                - anyOf:
                    - type: integer
                    - type: 'null'
                - type: 'null'
            details:
              anyOf:
                - type: object
                - type: 'null'
          required:
            - code
            - message
          additionalProperties: false
        request_id:
          type: string
      required:
        - error
        - request_id
      additionalProperties: false
    UnauthorizedEncoded:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              enum:
                - unauthorized
            message:
              type: string
            reason:
              anyOf:
                - type: string
                - type: 'null'
            control:
              anyOf:
                - type: string
                - type: 'null'
            retry_after_ms:
              anyOf:
                - anyOf:
                    - type: integer
                    - type: 'null'
                - type: 'null'
            details:
              anyOf:
                - type: object
                - type: 'null'
          required:
            - code
            - message
          additionalProperties: false
        request_id:
          type: string
      required:
        - error
        - request_id
      additionalProperties: false
    InsufficientBalanceEncoded:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              enum:
                - insufficient_balance
            message:
              type: string
            reason:
              anyOf:
                - type: string
                - type: 'null'
            control:
              anyOf:
                - type: string
                - type: 'null'
            retry_after_ms:
              anyOf:
                - anyOf:
                    - type: integer
                    - type: 'null'
                - type: 'null'
            details:
              anyOf:
                - type: object
                - type: 'null'
          required:
            - code
            - message
          additionalProperties: false
        request_id:
          type: string
      required:
        - error
        - request_id
      additionalProperties: false
    EndpointNotPermittedEncoded:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              enum:
                - endpoint_not_permitted
            message:
              type: string
            reason:
              anyOf:
                - type: string
                - type: 'null'
            control:
              anyOf:
                - type: string
                - type: 'null'
            retry_after_ms:
              anyOf:
                - anyOf:
                    - type: integer
                    - type: 'null'
                - type: 'null'
            details:
              anyOf:
                - type: object
                - type: 'null'
          required:
            - code
            - message
          additionalProperties: false
        request_id:
          type: string
      required:
        - error
        - request_id
      additionalProperties: false
    ForbiddenEncoded:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              enum:
                - forbidden
            message:
              type: string
            reason:
              anyOf:
                - type: string
                - type: 'null'
            control:
              anyOf:
                - type: string
                - type: 'null'
            retry_after_ms:
              anyOf:
                - anyOf:
                    - type: integer
                    - type: 'null'
                - type: 'null'
            details:
              anyOf:
                - type: object
                - type: 'null'
          required:
            - code
            - message
          additionalProperties: false
        request_id:
          type: string
      required:
        - error
        - request_id
      additionalProperties: false
    IdempotencyConflictEncoded:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              enum:
                - idempotency_conflict
            message:
              type: string
            reason:
              anyOf:
                - type: string
                - type: 'null'
            control:
              anyOf:
                - type: string
                - type: 'null'
            retry_after_ms:
              anyOf:
                - anyOf:
                    - type: integer
                    - type: 'null'
                - type: 'null'
            details:
              anyOf:
                - type: object
                - type: 'null'
          required:
            - code
            - message
          additionalProperties: false
        request_id:
          type: string
      required:
        - error
        - request_id
      additionalProperties: false
    RateLimitedEncoded:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              enum:
                - rate_limited
            message:
              type: string
            reason:
              anyOf:
                - type: string
                - type: 'null'
            control:
              anyOf:
                - type: string
                - type: 'null'
            retry_after_ms:
              anyOf:
                - anyOf:
                    - type: integer
                    - type: 'null'
                - type: 'null'
            details:
              anyOf:
                - type: object
                - type: 'null'
          required:
            - code
            - message
          additionalProperties: false
        request_id:
          type: string
      required:
        - error
        - request_id
      additionalProperties: false
    ServiceUnavailableEncoded:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              enum:
                - service_unavailable
            message:
              type: string
            reason:
              anyOf:
                - type: string
                - type: 'null'
            control:
              anyOf:
                - type: string
                - type: 'null'
            retry_after_ms:
              anyOf:
                - anyOf:
                    - type: integer
                    - type: 'null'
                - type: 'null'
            details:
              anyOf:
                - type: object
                - type: 'null'
          required:
            - code
            - message
          additionalProperties: false
        request_id:
          type: string
      required:
        - error
        - request_id
      additionalProperties: false
  securitySchemes:
    bearer:
      type: http
      scheme: Bearer

````

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