search_web

Google organic results for a query as structured rows, for a chosen country and language. ₹0.14 per call; an empty result list is ₹0.

What it does

Google's organic ranking for a query in a market: up to ten rows with position, title, link and snippet, in data.output.results. Use it when the task needs the actual ranking for a country and language; for a quick fact the assistant's own search is free and better. It returns organic rows only: no AI Overview unless ai_overview is true, no news (search_news), no page text (read_page).

India: pass country: "in" and language: "en" or "hi"; the defaults are the United States and English.

Inputs

Generated from the contract captured from staging on 2026-11-05 (GET /v1/tools/search_web).

FieldTypeRequiredDescription
qstringone ofidentity
limitintegernofilter; default 10; results to return where the provider bills by depth
countrystringnofilter; default 'us'; ISO country code; mapped to each provider's location code / gl / region
languagestringnofilter; default 'en'
ai_overviewbooleannoidentity

One of these sets must be complete (anything else is invalid_input, ₹0): q.

What drives the cost

Nothing you can turn: the price is flat per call whatever limit says. Keep limit at the default 10: a deeper page costs more at the source and can be refused by the per-call cost cap as estimate_too_low, which is ₹0.

Price today

Price today₹0.14 per call (cost_paise: 14) at ₹93.93 per US dollar on 17 November 2026
Hold before the call₹0.38 (hold_paise: 38); when the call settles the real price is charged and the unused part is released
₹0 whenit fails: ₹0
Timeout30 s, then upstream_timeout (₹0, retryable)
Over MCPa headline tool: call search_web directly
Over RESTPOST https://api.parel.si/v1/run with "tool": "search_web"
Confirmationnot needed (the estimate is under the ₹200 threshold)

Request

curl https://api.parel.si/v1/run \
  -H "Authorization: Bearer $PAREL_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tool":"search_web","input":{"q":"best crm for small business","limit":10,"country":"in","language":"en"}}'

Over MCP, search_web is a headline tool: Claude calls it directly with the same fields as arguments.

What comes back

data.output.results[], one row per organic result: position, title, link, snippet. data.output is the whole answer. An empty results is class: "ok_free", ₹0. No recorded example of a success is shown here: the staging environment's connection to the source was being re-keyed when these pages were captured, so the shape above is from the tool's contract.

Notes

  • Organic rows only: no news, maps, images, ads or page text.
  • Keep limit at 10. A deeper page can be refused by the cost cap (estimate_too_low); that refusal is free.
  • An empty result list is free for you (empty_list rule) even when the provider charged for the miss.
  • India: country "in", language "en" or "hi". The upstream default is the United States.

Siblings

This page as Markdown: /docs/tools/search_web.md. Something wrong or missing: hello@parel.si.