Web search

from $0.0075 per pageweb.search

Run a Google web search and get back ranked organic results with title, url, and snippet.

What a call costs

Billed on actual usage, minimum $0.0020 per call, capped at $1.00 per call.

a price before every call. failed calls are never charged.

When to use it

Use when you need current information from the web, to find pages about a topic, or to answer questions that need fresh sources. Billed per result page, about 10 results each.

Inputs

Web search takes 29 fields, 1 of them required. Anything you leave out falls back to the tool's own default.

Field	Type	Required	What it does
queries	string	yes	Search term(s), or Google Search URLs. Newline-separate for multiple. Supports advanced operators like site: and OR.
site	string	optional	Limit to one site, e.g. example.com
saveHtml	boolean	optional	Attach each results page's raw HTML to its item as html. Useful when you want to parse the page yourself, and it makes the response very large.
afterDate	string	optional	Only results from after this date. Same formats as beforeDate. Do not combine with quickDateRange.
fileTypes	array of string	optional	Only results of these file types, the filetype: operator, e.g. pdf, xlsx, csv. Several types are combined with OR.
aiOverview	object	optional	PAID ADD-ON. Capture Google's AI Overview in full for each query. Set scrapeFullAiOverview true inside this object. Billed $0.002 per query where an overview is actually captured, against $0.0025 for the search page itself.
beforeDate	string	optional	Only results from before this date. Absolute (2026-05-03, read as UTC) or relative (8 days, 3 months). Do not combine with quickDateRange.
wordsInUrl	array of string	optional	Words that must appear in the URL, the inurl: operator.
countryCode	string	optional	Two-letter country code, sets the Google domain (e.g. es for google.es)
wordsInText	array of string	optional	Words that must appear in the page text, the intext: operator.
aiModeSearch	object	optional	PAID ADD-ON. Also answer each query from Google AI Mode, the conversational search surface, with cited sources. Set enableAiMode true inside this object. Billed $0.005 per answer returned, twice the price of the search page.
geminiSearch	object	optional	PAID ADD-ON. Also answer each query from Google Gemini. Set enableGemini true inside this object. Billed $0.005 per answer returned.
includeIcons	boolean	optional	Include base64 icon image data on organic, paid and suggested results. Large.
languageCode	string	optional	Interface language (hl)
locationUule	string	optional	Google's uule parameter, which pins the search to an exact location. Much more precise than countryCode when local results matter.
wordsInTitle	array of string	optional	Words that must appear in the page title, the intitle: operator.
chatGptSearch	object	optional	PAID ADD-ON. Also answer each query from ChatGPT search, including the follow-up queries it generated, under queryFanOut. Set enableChatGpt true inside this object. Billed $0.005 per answer returned.
copilotSearch	object	optional	PAID ADD-ON. Also answer each query from Microsoft Copilot. Set enableCopilot true inside this object. Billed $0.005 per answer returned.
mobileResults	boolean	optional
relatedToSite	string	optional	Only pages Google considers related to this domain, the related: operator. Ignored when site is also set.
focusOnPaidAds	boolean	optional	PAID ADD-ON. Extract Google Ads results, retrying each query up to three times through an ad-specialised proxy. Billed $0.005 per search page whether or not any ads are found.
quickDateRange	string	optional	Recency window in Google's qdr form: h6 for the past six hours, d10 for ten days, w2, m3, y1. Do not combine with beforeDate or afterDate.
searchLanguage	string	optional	Restrict results to this language (lr)
forceExactMatch	boolean	optional
maxPagesPerQuery	integer	optional	Result pages per query, roughly 10 results each. Billing is per page.
perplexitySearch	object	optional	PAID ADD-ON, and the dearest one here. Also answer each query from Perplexity (Sonar) with citations. Set enablePerplexity true inside this object. Billed $0.013 per answer returned, five times the search page.
websiteContentScraper	object	optional	PAID ADD-ON. Fetch each organic result's page and attach its text, and markdown when convertible, as websiteContent. Set enable true inside this object. Billed $0.005 per page fetched, so a full page of ten results costs about twenty times the search page itself.
saveHtmlToKeyValueStore	boolean	optional	The actor leaves this ON and it slows every run down. It writes HTML snapshots to the run's key-value store, which Goro does not expose, so the htmlSnapshotUrl you get back is not readable by you. Set it false unless you have a reason not to.
includeUnfilteredResults	boolean	optional	Also return the lower quality results Google normally hides behind its omitted-results notice.

How to call it

Connect once and your agent can reach Web search the same way it reaches everything else in the catalog. Add Goro as an MCP connector, or paste the setup line into an agent that reads skills.

MCP

Add this server in Claude, Claude Code, or any MCP client.

https://mcp.usegoro.ai/mcp

Skill

One line in your agent's chat. It sets itself up.

set up https://usegoro.ai/SKILL.md

Or plain HTTP

POST /v1/run

{
  "endpoint": "web.search",
  "input": {
    "queries": "<queries>",
    "mobileResults": false,
    "forceExactMatch": false,
    "maxPagesPerQuery": 1
  }
}

Related tools

More from search, news and trends, or browse the full tool catalog.

Google News search

News articles from Google News for one or more keywords, sections or topic URLs, with headline, publisher, publish time, link and image, in any of 80...

from $0.0120 per result

Google Trends

Google search demand for a term over time, as an interest index of 0 to 100 with an optional ranked regional breakdown, or the searches spiking in...

from $0.0030 per result

Further reading: How to give Claude access to real-time web data

Run Web search from your agent.

One balance for every tool in the catalog. Start with Build, $25 of credit for $19 a month.

Get started