Web search API for AI agents

1. Get a key

   Sign up, top up from $5 and create a key in API keys. The tool catalog itself is public, so you can read schemas and prices before you have one.

2. Search the web

   Send the query, and optionally count (1 to 50 results) in input. The price is per search, so count doesn't change it.

   cURLPythonNode.js

   Shell

   curl https://lovelyrouter.com/v1/tools/web-search/run \
     -H "Authorization: Bearer $LOVELY_API_KEY" \
     -H "content-type: application/json" \
     -d '{
       "input": {"query": "electric car prices site:reuters.com OR site:bloomberg.com after:2026", "count": 10},
       "max_results": 1
     }'

3. Read the pages worth reading

   Pass one URL to web-fetch and get its title and text as Markdown, without menus or ads.

   cURL

   curl https://lovelyrouter.com/v1/tools/web-fetch/run \
     -H "Authorization: Bearer $LOVELY_API_KEY" \
     -H "content-type: application/json" \
     -d '{"input": {"url": "https://en.wikipedia.org/wiki/Web_search_engine"}, "max_results": 1}'

Each request waits up to 60 seconds for the run by default (wait goes up to 300). A finished run comes back with 200, its charge_usd and the results in items; a longer one returns 202 and a path to poll. Run a tool covers both.

web-search reads these operators in its query (1 to 128 characters):

google-news takes "exact phrase", OR, -word, site: and intitle:, and google-search accepts operators as you would type them into Google.

Connect the MCP server and your agent gets web_search and web_fetch as tools, next to the rest of the data tool catalog. The server tells the agent to use them for anything it needs to look up or read, and to keep the browser agent for pages it has to click through. Results come back short and numbered, and web_fetch returns long pages in parts of about 12,000 characters; reading on is free.

claude mcp add --transport http lovely-tools https://lovelyrouter.com/mcp \
  --header "Authorization: Bearer $LOVELY_API_KEY"

Then ask Claude Code: "Search for this week's announcements about solid-state batteries from news sites, read the three most relevant articles and summarize what changed, with links." MCP server has the setup for Cursor, Claude Desktop and other clients.

web-search is billed per search, $0.0009, whether you ask for 1 result or 50; a search with no results costs nothing. web-fetch is billed per page at the same price; a page that can't be read costs nothing. Search Google is billed per results page, Google News per article and Google Trends per call, with live prices on the cards above.

Every run holds its maximum cost from your prepaid balance and settles at what it returned, so you know the most a run can cost before it starts. A run that fails pays only for results it delivered. There is no subscription; see pricing for every tool and model.