Research web results - Autotouch AI

This page documents the canonical HTTP contract for this endpoint.

Returns the research_read.v1 envelope. data is provider-specific. The operation uses its configured provider and usage policy; no static price is implied here. Extra request fields are rejected.

Body parameters

queryrequired
string
Query, 1–2,000 characters.
num_results · optional
integer
Number of results, 1–10; default 10.

Name	Type	Description
queryrequired	string	Query, 1–2,000 characters.
num_results	integer	Number of results, 1–10; default 10.

Errors

Status	Meaning
401	Authentication is required.
403	The caller lacks access to the resource or the search:run scope.
400	The request does not satisfy the route or typed request contract.

Example

bash

curl -X POST "https://app.autotouch.ai/api/research-tools/search/web-results" \
  -H "Authorization: Bearer $AUTOTOUCH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "query": "official documentation example.test",
  "num_results": 10
}'

Request body

json

{
  "query": "official documentation example.test",
  "num_results": 10
}

Response example

json

{
  "schema_version": "research_read.v1",
  "operation_id": "search.web_results",
  "provider": "provider-specific",
  "data": {},
  "provenance": {}
}