> ## Documentation Index
> Fetch the complete documentation index at: https://developers.telnyx.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Web Search Overview

> Real-time web search, page content retrieval, and deep research with citations -- live web access for AI agents through one API.

Web Search gives your application live access to the web through one API: run real-time searches with structured, LLM-ready results, retrieve clean page content, or hand off an entire research question and get back a synthesized answer with citations.

It is built as grounding for AI agents -- every response is structured JSON ready to feed a model as tool output.

## What You Can Do

| Capability                                     | Endpoint                    | Returns                                                        |
| ---------------------------------------------- | --------------------------- | -------------------------------------------------------------- |
| [Web Search](/docs/web-search/web-search)      | `POST /web_search`          | Ranked results with titles, descriptions, and snippets         |
| [Content Retrieval](/docs/web-search/contents) | `POST /web_search/contents` | Clean HTML or Markdown for up to 20 URLs per request           |
| [Research](/docs/web-search/research)          | `POST /web_search/research` | A synthesized answer with citations, synchronous or background |

## Next Steps

<CardGroup cols={2}>
  <Card title="Get Started" href="/docs/web-search/getting-started">
    First search to synthesized answer in a few minutes.
  </Card>

  <Card title="Web Search" href="/docs/web-search/web-search">
    Domain filters, freshness, and live crawling.
  </Card>

  <Card title="Content Retrieval" href="/docs/web-search/contents">
    Formats, caching, and per-URL behavior.
  </Card>

  <Card title="Research" href="/docs/web-search/research">
    Synchronous vs background mode, polling, and the task lifecycle.
  </Card>
</CardGroup>