Web API·1 credit per call

Search global indices in one call.

Send a search query and receive structured organic results. We handle the proxy rotation and HTML parsing required to extract data at scale.

POSTautomatio.ai/api/v1/query{ tool: "web_search", params: { query: … } }

Live demo

Try it live.

Change the parameters and run a real request against the endpoint. No account, no key.

Queryrequired

Free to try, no account. Costs 1 credit on your own key.

POST /api/v1/query · web_search

Run the request to see a live response.

Request
curl -X POST https://automatio.ai/api/v1/query \
  -H "Authorization: Bearer $AUTOMATIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tool":"web_search","params":{"query":"best screenshot api"}}'

How it works

One request, one response.

  1. 1

    Send search query

    Post a JSON body containing your query string and optional geographic or linguistic parameters.

  2. 2

    Index extraction

    The system processes the request through a global search index to identify relevant organic results.

  3. 3

    Receive structured data

    The API returns a JSON object containing ranked titles, descriptions, and destination URLs for immediate processing.

Capabilities

What you get.

Everything this endpoint does, without running the infrastructure yourself.

Geographic targeting

Target specific regions or cities to retrieve results as they appear to local users in those territories.

Language localization

Filter results by specific languages to ensure data relevance for international markets and diverse demographics.

Clean metadata

Receive titles and snippets in a predictable JSON format without maintaining custom CSS selectors for different layouts.

Direct AI integration

Use the Model Context Protocol to connect live search results to AI clients for RAG and automated research tasks.

Cost of ownership

Build it yourself, or call this.

Both are real options. Here is what each one actually costs you.

Build it yourself

  • Manage headless browser clusters for rendering
  • Subscribe to and rotate residential proxies
  • Continually update parsers as search engine layouts change

Use the API

  • Single POST endpoint returns cleaned JSON
  • Zero infrastructure to maintain or monitor
  • Unified billing across search and scraping tools

Integrate

Built for the language you use.

One HTTP endpoint. Copy the call in your language and go.

example.sh
curl -X POST https://automatio.ai/api/v1/query \
  -H "Authorization: Bearer $AUTOMATIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "tool": "web_search", "params": { "query": "web scraping" } }'

In production

What people build with it.

AI Research Agents

Feed live search snippets and URLs into a large language model to answer questions about technical documentation or current events. This allows agents to access information beyond their training cutoff.

Competitive Brand Monitoring

Search for company names or product keywords to track new mentions across the web. The structured output enables automated sentiment analysis or press coverage alerts.

SEO Visibility Tracking

Automate the collection of search engine results pages to analyze competitor rankings for specific terms. Developers use this to build internal dashboards that monitor domain performance over time.

Choosing parameters

Which options matter.

The table below lists what exists. These are the calls worth making deliberately.

location
Use this for city-level or neighborhood precision. It is the most effective way to analyze local SEO results or identify regional service providers.
country
Pass a two-letter ISO code to ensure results are pulled from a specific national index. This prevents global results from overriding locally relevant listings.
query
Standard search operators like 'site:' or 'filetype:' are supported. Using specific operators can significantly reduce the need for post-processing by narrowing results at the source.

Alternatives

When to use something else.

A page that pretends it has no alternatives reads as an advert. These are the other real options.

Official Search Engine APIs

Best for high-volume enterprise contracts where you require deep integration with a specific provider's ecosystem.

Custom Scraping Scripts

A viable choice for hobbyists with low volume who can afford the time to maintain their own proxy stacks and parsers.

Direct Browser Automation

Recommended if your workflow requires interacting with the search page, such as clicking specific filter buttons, before extraction.

Before you integrate

What it does not do.

The boundaries are as useful as the features. These are the ones worth knowing up front.

No advertisement data

The endpoint does not return paid search results or shopping ads; output is strictly limited to organic web listings.

No historical metrics

Keyword difficulty, monthly search volume, and CPC data are not provided. This tool is for retrieving results, not SEO analytics.

Standard widgets excluded

Features like 'People Also Ask' boxes or Knowledge Graph panels are not included in the JSON result array.

Reference

1 credit per call
Endpoint
POST https://automatio.ai/api/v1/query
Tool ID
web_search

Parameters

NameTypeRequiredDescription
querystringThe search query to find URLs and information about (e.g., "artificial intelligence")
countrystringOPTIONAL two-letter ISO country code (e.g. "us", "rs", "de") to localize results. Set ONLY for region-specific queries ("near me", local businesses, a query written in a local language, "in my country"). OMIT for global/general topics — forcing a country hurts global queries.
languagestringOPTIONAL two-letter ISO language code (e.g. "en", "sr", "de") for the results language. Set it to match the query language for local/non-English searches. OMIT for global/general topics.
locationstringOPTIONAL free-text origin at city level (e.g. "Belgrade, Serbia") to simulate a real user's location. Use only for hyper-local "near me" style queries.

The same endpoints are available over MCP, and the full machine-readable catalogue lives in the API documentation.

Frequently Asked Questions

Find answers to common questions about Web Search API

More than just prompts

Supercharge your workflow with AI Automation

Automatio combines the power of AI agents, web automation, and smart integrations to help you accomplish more in less time.

AI Agents
Web Automation
Smart Workflows