Saltar al contenido principal
GET
Leer un resultado de investigación web
Usa result_url sin cambios en el origen de la API y autentícate con una API Key autorizada para leer todos los Run. La respuesta usa los mismos campos que la respuesta inicial de Solution. HTTP 200 aún puede contener result_status: pending; sigue consultando hasta que el Run final sea terminal. Esta es una solicitud de solo lectura. No crea Run, no llama a proveedores de datos, no reanuda el fallback ni restablece el presupuesto de ejecución. Get Run sigue siendo la API independiente para la salida nativa y el cargo de un Run individual.

Parámetros de consulta

token
string
requerido

Contexto de resultado opaco devuelto en result_url. Consérvalo sin cambios y autentícate con una Key autorizada para leer todos los Runs enumerados.

Required string length: 1 - 16384

Respuesta

Resultado de investigación web

id
string
requerido
run_url
string
requerido

Abre este Run en la consola. Requiere pertenecer al Workspace.

provider
string
requerido
Pattern: ^[a-z0-9][a-z0-9-]*$
endpoint
string
requerido
Pattern: ^\/.+$
endpoint_version
integer
requerido
status
enum<string>
requerido

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: se detuvo antes del dispatch. Lee charge_usd por separado del estado.

Opciones disponibles:
QUEUED,
RUNNING,
COMPLETED,
FAILED,
STOPPED
failure
object | null
requerido

Motivo por el que falló el Run. No es null solo cuando el estado es FAILED.

input
object
requerido
output
object
requerido

Campos normalizados por acción. El resultado nativo del proveedor de datos no se repite aquí; permanece en el Run (GET /v1/runs/:id). Los valores que el proveedor de datos no informa son null.

  • search: results[]: url, title, snippet (extracto de Google; fragmento extraído de Exa para Exa), position, published_at, date_text, date (obsoleto)
  • news: items[]: title, url, source, published_at, date_text, snippet
  • places: items[]: name, address (texto del proveedor de datos; puede ser solo la línea de la calle), category, rating (1–5), reviews, phone, website, latitude, longitude, google_cid
  • scholar: items[]: title, url, snippet, publication, year, cited_by, pdf_url
  • shopping: items[]: title, url (página de Google Shopping), merchant_url, google_product_id, price_text, seller, rating (1–5), reviews, image_url
  • images: items[]: title, image_url, thumbnail_url, source_url, source, width, height
  • videos: items[]: title, url, channel, source, date_text, duration_text, snippet, thumbnail_url
  • answer: answer, citations[]: url, title, published_at
  • scrape: url, final_url, title, text, markdown, html, raw_html, text_character_limit, cached, fetched_at, quality (obsoleto)
  • similar: items[]: url, title, exa_similarity_score, published_at, author

published_at está en formato ISO 8601 UTC y solo se establece a partir de la marca de tiempo generada por máquina del proveedor de datos. date_text es el texto mostrado por Google tal como se devuelve; puede ser relativo a completed_at del Run y nunca se analiza. rating es el promedio de estrellas de Google de 1–5; reviews es un recuento. source es el nombre del editor o sitio. exa_similarity_score es la puntuación propia de Exa y solo se puede comparar dentro de una misma respuesta.

provider_response
object | null
requerido

No es null únicamente cuando el estado es COMPLETED.

  • Para respuestas 2xx, output contiene el JSON nativo del proveedor de datos (de cualquier estructura), o null si el cuerpo está vacío.
  • Para respuestas que no sean 2xx, error contiene el cuerpo de error del proveedor de datos y output es null.

Los campos confidenciales se eliminan de ambos cuerpos.

charge_usd
string | null
requerido

Cargo total de los Runs de esta respuesta de Solution. Es null hasta que se establezcan todos los Runs enumerados. Cada Run conserva su propio cargo; los fallos también pueden generar cargos.

Pattern: ^(0|[1-9]\d*)\.(\d{2}|\d{2}\d{0,3}[1-9])$
charge_basis
object | null
requerido

Base del cargo de un solo Run, o null para un total de varios Runs. Lee runs[].charge_basis para cada cargo.

stoppable
boolean
requerido

Indica si actualmente se puede aceptar una solicitud de detención. No garantiza que el Run pueda detenerse antes del dispatch.

stop_requested_at
string<date-time> | null
requerido

Momento en que se solicitó la detención. El Run puede continuar si el dispatch ya había comenzado.

created_at
string<date-time>
requerido

Marca de tiempo UTC en formato ISO-8601

started_at
string<date-time> | null
requerido

Marca de tiempo UTC en formato ISO-8601

completed_at
string<date-time> | null
requerido

Marca de tiempo UTC en formato ISO-8601

task_id
string | null
requerido
metadata
object
requerido

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 y tener 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.
action
enum<string>
requerido
Opciones disponibles:
search,
news,
places,
scholar,
shopping,
images,
videos,
answer,
scrape,
similar
result_status
enum<string>
requerido

Estado de entrega empresarial, independiente del ciclo de vida final del Run en status. success no es un veredicto semántico sobre la calidad del contenido.

Opciones disponibles:
success,
partial,
no_result,
error,
pending
missing_formats
enum<string>[]
requerido
Opciones disponibles:
text,
markdown,
html,
raw_html
error
object | null
requerido
runs
object[]
requerido
result_url
string
requerido

Ruta 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 individual nativo.