Skip to main content
POST
/
api
/
v1
/
web_search
/
context
Web Search Context Endpoint
curl --request POST \
  --url https://services.staging.app.dados.rio/eai-agent-surkai/api/v1/web_search/context \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "query": "<string>",
  "k": 6,
  "lang": "pt-BR",
  "freshness_days": 2
}
'
{
  "snippets": [
    {
      "url": "<string>",
      "title": "<string>",
      "snippet": "<string>"
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.dados.rio/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Schema da requisição para /web_search.

​
query
string
required

Pergunta ou termos de busca.

​
k
integer
default:6

Número máximo de resultados iniciais.

Required range: 1 <= x <= 20
​
lang
string
default:pt-BR

Idioma preferido para resultados e summary.

​
freshness_days
integer | null

Restringe busca a conteúdos recentes (opcional).

Required range: x >= 1

Response

Successful Response

Schema da resposta para /web_search/context.

​
snippets
ContextSnippet · object[]
required

Lista de trechos relevantes para a query.