Pular para o conteúdo principal
GET
Ler um resultado de pesquisa na web
Use result_url sem alterações na origem da API e autentique-se com uma Key autorizada a ler todos os Runs. A resposta usa os mesmos campos da resposta inicial da Solution. O HTTP 200 ainda pode conter result_status: pending; continue consultando até que o Run final seja terminal. Esta é uma solicitação somente leitura. Ela não cria Runs, não chama provedores de dados, não retoma o fallback nem redefine o orçamento de execução. Get Run continua sendo a API separada para a saída nativa e a cobrança de um Run individual.

Parâmetros de consulta

token
string
obrigatório

Contexto de resultado opaco retornado em result_url. Mantenha-o inalterado e autentique-se com uma Key autorizada a ler todos os Runs listados.

Required string length: 1 - 16384

Resposta

WebResearchResult

id
string
obrigatório
run_url
string
obrigatório

Abra este Run no console. Requer associação ao Workspace.

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

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 envio. Leia charge_usd separadamente de status.

Opções disponíveis:
QUEUED,
RUNNING,
COMPLETED,
FAILED,
STOPPED
failure
object | null
obrigatório

Motivo da falha do Run. Não é null somente quando status é FAILED.

input
object
obrigatório
output
object
obrigatório

Campos normalizados por ação. A saída nativa do provedor de dados não é repetida aqui; ela permanece no Run (GET /v1/runs/:id). Os valores que o provedor de dados não informa são null.

  • search: results[]: url, title, snippet (trecho do Google; destaque extraído pelo Exa para o Exa), position, published_at, date_text, date (obsoleto)
  • news: items[]: title, url, source, published_at, date_text, snippet
  • places: items[]: name, address (texto do provedor de dados; pode conter somente a linha da rua), 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 do 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 é um timestamp UTC ISO 8601 e só é definido a partir de um timestamp de máquina do provedor de dados. date_text é o texto de exibição do Google conforme retornado; ele pode ser relativo a completed_at do Run e nunca é interpretado. rating é a média de estrelas de 1–5 do Google; reviews é uma contagem. source é o nome de um editor ou site. exa_similarity_score é a pontuação própria do Exa e só pode ser comparada dentro de uma única resposta.

provider_response
object | null
obrigatório

Não nulo somente quando status é COMPLETED.

  • Para respostas 2xx, output contém JSON nativo do provedor de dados (qualquer formato) ou null para um corpo vazio.
  • Para respostas não 2xx, error contém o corpo de erro do provedor de dados e output é null.

Os campos sensíveis são removidos de ambos os corpos.

charge_usd
string | null
obrigatório

Cobrança total dos Runs nesta resposta de Solution. Null até que todos os Runs listados sejam liquidados. Cada Run mantém sua própria cobrança; falhas também podem ser cobradas.

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

Base de cobrança de um único Run ou null para um total de vários Runs. Leia runs[].charge_basis para cada cobrança.

stoppable
boolean
obrigatório

Indica se uma solicitação de parada pode ser aceita no momento. Isso não garante que o Run possa ser interrompido antes do dispatch.

stop_requested_at
string<date-time> | null
obrigatório

Momento em que uma parada foi solicitada. O Run ainda pode continuar se o dispatch já tiver começado.

created_at
string<date-time>
obrigatório

Timestamp UTC ISO-8601

started_at
string<date-time> | null
obrigatório

Timestamp UTC ISO-8601

completed_at
string<date-time> | null
obrigatório

Timestamp UTC ISO-8601

task_id
string | null
obrigatório
metadata
object
obrigatório

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.
action
enum<string>
obrigatório
Opções disponíveis:
search,
news,
places,
scholar,
shopping,
images,
videos,
answer,
scrape,
similar
result_status
enum<string>
obrigatório

Status de entrega comercial, independente do ciclo de vida final do Run em status. success não é um veredito semântico sobre a qualidade do conteúdo.

Opções disponíveis:
success,
partial,
no_result,
error,
pending
missing_formats
enum<string>[]
obrigatório
Opções disponíveis:
text,
markdown,
html,
raw_html
error
object | null
obrigatório
runs
object[]
obrigatório
result_url
string
obrigatório

Caminho de URL autenticado e somente leitura para consultar este resultado normalizado e a cobrança total. Use-o com a origem da API. Não cria Runs nem retoma o fallback. GET /v1/runs/:id ainda retorna o Run individual nativo.