Web Search

Search the web and return results directly. Returns structured search results including titles, URLs, content snippets, and dates.

Search providers:

• brave (default) — Brave Search with Zero Data Retention (ZDR). Search queries are never stored or logged by the search provider.
• google — Google Search with anonymized queries. Searches are proxied through Venice’s infrastructure so that your identity is not associated with the search request sent to Google. Venice does not store or log search queries.

Authentication: This endpoint accepts either a Bearer API key or an X-Sign-In-With-X header for x402 wallet-based authentication. When using x402, a 402 Payment Required response indicates insufficient balance and includes top-up instructions.

POST /augment/search

/api/v1/augment/search

cURL

curl --request POST \
  --url https://api.venice.ai/api/v1/augment/search \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "query": "latest news about AI",
  "limit": 10,
  "search_provider": "brave"
}
'

200

{
  "query": "<string>",
  "results": [
    {
      "title": "<string>",
      "url": "<string>",
      "content": "<string>",
      "date": "<string>"
    }
  ]
}

This is an experimental API. The request and response format may change without notice.

Send a search query in the query field. The API returns structured results including titles, URLs, content snippets, and dates.

Search providers:

• brave (default) — Brave Search with Zero Data Retention (ZDR). Search queries are never stored or logged by the search provider.
• google — Google Search with anonymized queries. Searches are proxied through Venice’s infrastructure so that your identity is not associated with the search request sent to Google. Venice does not store or log search queries.

Pricing: $0.01 per request.

Example (cURL)

curl -X POST https://api.venice.ai/api/v1/augment/search \
  -H "Authorization: Bearer $VENICE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "latest news about AI"}'

---

Authorizations

BearerAuthsiwx

Authorization · string · header · required

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

Body

application/json

query · string · required

The search query

Required string length: 1 - 400

Example:

"latest news about AI"

limit · integer · default: 10

Maximum number of results to return (default: 10, max: 20)

Required range: 1 <= x <= 20

Example:

10

search_provider · enum<string>

Search provider to use. "brave" uses Brave Search with Zero Data Retention (ZDR) for maximum privacy — search queries are never stored or logged. "google" uses Google Search with anonymized queries — searches are proxied through Venice's infrastructure so that your identity is not associated with the search request sent to Google. Venice does not store or log search queries. Defaults to "brave".

Available options: google, brave

Example:

"brave"

Response

200

application/json

Successfully executed search

query · string · required

The search query that was executed

results · object[] · required

The search results

Show child attributes