---
title: "Search the live web and get ranked results back: title, URL and snippet for each hit, up to 20 per call, optionally biased to a country. The natural first step before fetching or crawling - this tool finds the pages, the fetch and crawl tools read them. Results come from an independent web index and the response names which one answered."
method: POST
path: "/v1/tools/web-search"
---

# Search the live web and get ranked results back: title, URL and snippet for each hit, up to 20 per call, optionally biased to a country. The natural first step before fetching or crawling - this tool finds the pages, the fetch and crawl tools read them. Results come from an independent web index and the response names which one answered.

`POST /v1/tools/web-search`

## Request

- Base URL: `https://agents.dexl.io`
- URL: `https://agents.dexl.io/v1/tools/web-search`
- Auth: API key in header `X-Payment`

Paid per call via x402. Send without payment to get the exact price in the 402.

## Request body

- object
  - `query` string, required: What to search for.
  - `count` number: How many results to return (1-20).
  - `country` string: Two-letter country code to bias results, e.g. "us", "tr". Optional.

## Response `200`

The tool output

## Other responses

- `400`: The input did not match the schema
- `402`: Payment required

---

[API](https://skmtc.dev/dexl/apis/dexl-agents.md) · [All operations](https://skmtc.dev/dexl/apis/dexl-agents/llms.txt) · [OpenAPI document](https://skmtc.dev/dexl/apis/dexl-agents/revisions/e3692765c3f7?raw)