> ## 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.

# Leer un resultado de Amazon

> Lee datos normalizados, estado de entrega y cargos totales de los mismos Runs.

Usa result\_url sin cambios y con autenticación. Esta lectura no crea Runs, llama a Providers ni reanuda alternativas. HTTP 200 aún puede indicar result\_status=pending. El contexto firmado pertenece al Workspace y cada Run se comprueba con la política actual de la Key.


## OpenAPI

````yaml /openapi.es.json get /v1/solutions/gtm/amazon_research/result
openapi: 3.1.0
info:
  title: Glasser
  version: 0.0.1
  description: >-
    Una API Key, sin contrato, con pago por llamada, para APIs de pago
    adquiridas al por mayor. Cada respuesta incluye x-request-id; cada cuerpo de
    error incluye el mismo sobre.
servers:
  - url: https://api.glasser.ai
security: []
tags:
  - name: Solutions
  - name: Endpoints
  - name: Runs
  - name: Balance
paths:
  /v1/solutions/gtm/amazon_research/result:
    get:
      tags:
        - Solutions
      summary: Leer un resultado de Amazon
      description: >-
        Sigue result_url de la investigación de Amazon para leer datos
        normalizados, estado y cargos de los mismos Runs. HTTP 200 puede indicar
        pending. Esta lectura autenticada no crea Runs, llama a Providers ni
        reanuda alternativas. GET /v1/runs/:id conserva los datos nativos. El
        contexto firmado pertenece al Workspace y cada Run se comprueba con la
        política actual de la Key.
      operationId: gtm-amazon-research-result
      parameters:
        - name: token
          in: query
          schema:
            type: string
            minLength: 1
            maxLength: 16384
            description: >-
              Contexto de resultado opaco devuelto en result_url. Consérvalo sin
              cambios y autentícate con una API Key autorizada para leer todos
              los Runs indicados.
          required: true
      responses:
        '200':
          description: Resultado de investigación de Amazon
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AmazonResearchResult'
        '400':
          description: ValidationFailed
          content:
            application/json:
              schema:
                anyOf:
                  - $ref: '#/components/schemas/ValidationFailedEncoded'
                  - $ref: '#/components/schemas/ValidationFailedEncoded'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UnauthorizedEncoded'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ForbiddenEncoded'
        '404':
          description: NotFound
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NotFoundEncoded'
        '429':
          description: RateLimited
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RateLimitedEncoded'
      security:
        - bearer: []
components:
  schemas:
    AmazonResearchResult:
      type: object
      properties:
        id:
          type: string
        run_url:
          type: string
          description: Abre este Run en la consola. Requiere pertenecer al 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 o RUNNING: todavía está en curso. COMPLETED: hay una
            respuesta del proveedor de datos disponible, incluidas las
            respuestas que no son 2xx. FAILED: consulta `failure`. STOPPED:
            detenido antes del dispatch. Consulta charge_usd por separado 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 por el que falló el Run. Solo es distinto de null cuando
            status es 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 reseñas mostrado por el Provider; puede
                              agrupar variantes. No es el tamaño de la muestra
                              recogida.
                          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 reseñas mostrado por el Provider; puede
                            agrupar variantes. No es el tamaño de la muestra
                            recogida.
                        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: >-
                    Estimaciones de búsquedas de Amazon por término de
                    DataForSEO, no ventas. No sumes términos superpuestos como
                    tamaño 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 por presupuesto, con filtros de estrellas,
                    palabras o compra verificada. Separa páginas solicitadas y
                    observadas. Sin afirmación de representatividad; las
                    acusaciones no están 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: >-
                    Series de precios separadas de Keepa. Los valores no
                    disponibles tienen price=null. NEW cambió de definición el
                    2026-02-23; no unas bases entre ambos lados de esa fecha. El
                    historial no es una cotización 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 de Keepa para el ASIN exacto. Los códigos
                    de estado conservan su significado; la última observación y
                    el cambio de precio son fechas distintas. La caché no es una
                    cotización verificada de compra. Las tarifas del competidor
                    son contexto, no costes del SKU propuesto.
                - type: object
                  properties:
                    items:
                      type: array
                      items:
                        type: object
                        properties:
                          title:
                            anyOf:
                              - type: string
                              - type: 'null'
                          url:
                            anyOf:
                              - type: string
                              - type: 'null'
                            description: Página del producto en Google Shopping.
                          merchant_url:
                            anyOf:
                              - type: string
                              - type: 'null'
                            description: >-
                              URL de la oferta del comerciante cuando la informa
                              el proveedor de datos (link de SerpApi); null para
                              Serper.
                          google_product_id:
                            anyOf:
                              - type: string
                              - type: 'null'
                            description: >-
                              ID del producto del catálogo de Google Shopping
                              (productId de Serper, product_id de SerpApi).
                          price_text:
                            anyOf:
                              - type: string
                              - type: 'null'
                            description: >-
                              Precio mostrado por el proveedor de datos, como
                              '$69.00'. No se analiza; la moneda depende del
                              país.
                          seller:
                            anyOf:
                              - type: string
                              - type: 'null'
                          rating:
                            anyOf:
                              - anyOf:
                                  - type: number
                                  - type: string
                                    enum:
                                      - Infinity
                                      - '-Infinity'
                                      - NaN
                              - type: 'null'
                            description: >-
                              Valoración media de Google mediante estrellas, de
                              1 a 5.
                          reviews:
                            anyOf:
                              - type: integer
                              - type: 'null'
                            description: >-
                              Número de reseñas de Google en las que se basa la
                              valoración.
                          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: >-
                        La URL solicitada o la URL final cuando el proveedor de
                        datos informa de una.
                    final_url:
                      anyOf:
                        - type: string
                        - type: 'null'
                      description: >-
                        La URL posterior a la redirección según la informa el
                        proveedor de datos (Firecrawl, Exa). Null cuando el
                        proveedor de datos no informa de ninguna.
                    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: >-
                        Límite de caracteres que Glasser solicitó al proveedor
                        de datos para el texto (10000 para Exa), por lo que el
                        texto de exactamente esta longitud puede estar truncado.
                        Null cuando no se aplicó ningún límite.
                    cached:
                      anyOf:
                        - type: boolean
                        - type: 'null'
                      description: >-
                        Indica si el proveedor de datos sirvió la página desde
                        su caché (cacheState de Firecrawl, source de status de
                        Exa). Null cuando el proveedor de datos no lo indica.
                    fetched_at:
                      anyOf:
                        - type: string
                        - type: 'null'
                      description: >-
                        Momento en que el proveedor de datos obtuvo la página,
                        UTC ISO 8601 (fetch_time de DataForSEO). Null cuando el
                        proveedor de datos no lo informa.
                    quality:
                      type: string
                      enum:
                        - unverified
                      description: >-
                        Obsoleto: siempre 'unverified'; no se comprueba el
                        contenido. Se conserva por compatibilidad y se eliminará
                        en la próxima revisión incompatible.
                  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: Marca de tiempo UTC ISO-8601
                  format: date-time
                - type: 'null'
            file_expires_at:
              type: string
              description: Marca de tiempo 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: >-
            Cuerpo completo de gran tamaño del proveedor de datos, entregado
            como archivo JSON. Glasser aplica un límite de recursos de 32 MiB al
            cuerpo capturado y al archivo serializado. body_field identifica el
            campo sustituido; output es null o se omite provider_response.error.
            Los enlaces de descarga caducan como máximo en una hora. Get Run con
            autenticación renueva la URL mientras el archivo esté disponible,
            durante 7 días. Las lecturas y descargas no ejecutan ni cobran otro
            Run. Si state es link_pending, consulta el mismo Run para preparar
            el enlace sin otra ejecución ni otro cargo. La URL concede acceso
            temporal de lectura: compártela solo con los destinatarios
            previstos.
        provider_response:
          anyOf:
            - type: object
              properties:
                http_status:
                  type: integer
                  minimum: 100
                  maximum: 599
                  description: >-
                    Estado HTTP devuelto por el proveedor de datos. Compruébalo
                    incluso cuando el Run esté COMPLETED.
                error:
                  anyOf:
                    - {}
                    - type: 'null'
              required:
                - http_status
              additionalProperties: false
            - type: 'null'
          description: >-
            Solo es distinto de null cuando status es COMPLETED.


            - Para respuestas 2xx, output contiene JSON nativo del proveedor de
            datos (con cualquier estructura) o null si el cuerpo está vacío.

            - Para respuestas que no son 2xx, error contiene el cuerpo del error
            del proveedor de datos y output es null.


            Los campos sensibles se eliminan de ambos cuerpos.
        charge_usd:
          anyOf:
            - type: string
              pattern: ^(0|[1-9]\d*)\.(\d{2}|\d{2}\d{0,3}[1-9])$
              description: >-
                Cadena decimal exacta en USD (mínimo 2 y máximo 6 decimales, con
                una única representación canónica). Suma con aritmética decimal
                o escala por 10^6; nunca uses números de coma flotante.
            - type: 'null'
          description: >-
            Cargo histórico total de los Runs enumerados, incluidos los
            repetidos o leídos. Es null hasta que todos se liquiden. No es gasto
            nuevo de la solicitud actual; request_charge lo informa por
            separado. Los fallos también pueden tener cargo.
        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 del cargo de un único Run, o null para un total de varios Runs.
            Consulta runs[].charge_basis para cada cargo.
        stoppable:
          type: boolean
          description: >-
            Indica si actualmente se puede aceptar una solicitud de detención.
            Esto no garantiza que el Run pueda detenerse antes del dispatch.
        stop_requested_at:
          anyOf:
            - type: string
              description: Marca de tiempo UTC ISO-8601
              format: date-time
            - type: 'null'
          description: >-
            Momento en que se solicitó la detención. El Run puede continuar si
            el dispatch ya había comenzado.
        created_at:
          type: string
          description: Marca de tiempo UTC ISO-8601
          format: date-time
        started_at:
          anyOf:
            - type: string
              description: Marca de tiempo UTC ISO-8601
              format: date-time
            - type: 'null'
        completed_at:
          anyOf:
            - type: string
              description: Marca de tiempo 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: >-
            Tus campos de seguimiento almacenados. Úsalos para filtrar Runs.
            Nunca se envían al proveedor de datos ni afectan al enrutamiento,
            Price o la idempotencia.


            - Hasta 20 claves: letras minúsculas, dígitos y guiones bajos; deben
            comenzar por una letra; como máximo 40 caracteres.

            - Valores: cadenas de 1–500 caracteres.

            - user_id: el ID opaco de tu usuario final, nunca su dirección de
            correo electrónico ni su nombre.
        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 como máximo una vez por Run, en la primera entrega de
            algunos Runs completados. Después de usar este resultado en la
            tarea, envía una reseña como indica instruction y continúa. Es
            opcional; nunca afecta al Run ni a su cargo.
        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: Abre este Run en la consola. Requiere pertenecer al 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 o RUNNING: todavía está en curso. COMPLETED: hay una
                  respuesta del proveedor de datos disponible, incluidas las
                  respuestas que no son 2xx. FAILED: consulta `failure`.
                  STOPPED: detenido antes del dispatch. Consulta charge_usd por
                  separado 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 por el que falló el Run. Solo es distinto de null
                  cuando status es 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: Marca de tiempo UTC ISO-8601
                        format: date-time
                      - type: 'null'
                  file_expires_at:
                    type: string
                    description: Marca de tiempo 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: >-
                  Cuerpo completo de gran tamaño del proveedor de datos,
                  entregado como archivo JSON. Glasser aplica un límite de
                  recursos de 32 MiB al cuerpo capturado y al archivo
                  serializado. body_field identifica el campo sustituido; output
                  es null o se omite provider_response.error. Los enlaces de
                  descarga caducan como máximo en una hora. Get Run con
                  autenticación renueva la URL mientras el archivo esté
                  disponible, durante 7 días. Las lecturas y descargas no
                  ejecutan ni cobran otro Run. Si state es link_pending,
                  consulta el mismo Run para preparar el enlace sin otra
                  ejecución ni otro cargo. La URL concede acceso temporal de
                  lectura: compártela solo con los destinatarios previstos.
              provider_response:
                anyOf:
                  - type: object
                    properties:
                      http_status:
                        type: integer
                        minimum: 100
                        maximum: 599
                        description: >-
                          Estado HTTP devuelto por el proveedor de datos.
                          Compruébalo incluso cuando el Run esté 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: >-
                      Cadena decimal exacta en USD (mínimo 2 y máximo 6
                      decimales, con una única representación canónica). Suma
                      con aritmética decimal o escala por 10^6; nunca uses
                      números de coma flotante.
                  - type: 'null'
                description: >-
                  Cargo final como cadena decimal exacta en USD. Es null
                  mientras está QUEUED o RUNNING. Un Run FAILED puede tener un
                  cargo distinto de cero según el Price del 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 utilizada para calcular el cargo. Es null
                  antes de la liquidación o cuando no se realizó ningún intento
                  con el proveedor de datos.
              stoppable:
                type: boolean
                description: >-
                  Indica si actualmente se puede aceptar una solicitud de
                  detención. Esto no garantiza que el Run pueda detenerse antes
                  del dispatch.
              stop_requested_at:
                anyOf:
                  - type: string
                    description: Marca de tiempo UTC ISO-8601
                    format: date-time
                  - type: 'null'
                description: >-
                  Momento en que se solicitó la detención. El Run puede
                  continuar si el dispatch ya había comenzado.
              created_at:
                type: string
                description: Marca de tiempo UTC ISO-8601
                format: date-time
              started_at:
                anyOf:
                  - type: string
                    description: Marca de tiempo UTC ISO-8601
                    format: date-time
                  - type: 'null'
              completed_at:
                anyOf:
                  - type: string
                    description: Marca de tiempo 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: >-
                  Tus campos de seguimiento almacenados. Úsalos para filtrar
                  Runs. Nunca se envían al proveedor de datos ni afectan al
                  enrutamiento, Price o la idempotencia.


                  - Hasta 20 claves: letras minúsculas, dígitos y guiones bajos;
                  deben comenzar por una letra; como máximo 40 caracteres.

                  - Valores: cadenas de 1–500 caracteres.

                  - user_id: el ID opaco de tu usuario final, nunca su dirección
                  de correo electrónico ni su nombre.
            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: >-
                    Cadena decimal exacta en USD (mínimo 2 y máximo 6 decimales,
                    una única escritura canónica). Suma con aritmética decimal o
                    escala por 10^6; nunca uses números de coma flotante.
                - type: 'null'
              description: >-
                Cargo solo de los Runs creados por esta solicitud. Los Runs
                repetidos y las lecturas gratuitas añaden cero. Es null mientras
                un Run nuevo siga sin liquidar o se desconozca su origen de
                admisión. No es el total histórico de charge_usd o
                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: >-
            Evidencia de admisión y cargo de la solicitud actual. Conserve
            created_run_ids durante el trabajo del usuario y cuente cada Run
            liquidado una sola vez. Cambiar task_id no convierte una repetición
            idempotente en un Run nuevo. Leer un resultado tiene cargo cero y
            listas de admisión vacías.
        result_url:
          type: string
          description: >-
            Ruta de URL autenticada y de solo lectura para consultar este
            resultado normalizado y el cargo total. Úsala con el origen de la
            API. No crea Runs ni reanuda el fallback. GET /v1/runs/:id sigue
            devolviendo el 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
    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
    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
    NotFoundEncoded:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              enum:
                - not_found
            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
  securitySchemes:
    bearer:
      type: http
      scheme: Bearer

````

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