---
title: Web Search API for AI Agents | Telnyx
canonical: https://telnyx.com/products/web-search-api
---
# Web Search API for AI Agents | Telnyx

**Agent Platform**

# Web Search API for AI Agents

Search the web, fetch page content, and run deep research through one API. Same Telnyx key you use for voice, messaging, and inference. No separate search provider account.

[Get started](https://telnyx.com/sign-up)[Read the docs](https://developers.telnyx.com/docs/web-search)

USE CASES

## What teams build with it

Voice agents, research agents, and competitive intelligence all need the same primitives.

* ### Voice AI agents  
Give your voice agent live web access. Look up flight status, check store hours, pull current prices, all in the same call.
* ### Research agents  
Run multi-source research with citations. Background mode handles long tasks; poll the task\_id when ready.
* ### Competitive intelligence  
Track competitor pages, pricing, and announcements. Use include\_domains to scope, freshness to control recrawl.
* ### Content enrichment  
Fetch URLs and convert to clean Markdown for RAG pipelines, summaries, or downstream LLM calls.

ENDPOINTS

## Four endpoints, one auth header

Every endpoint uses your existing Telnyx API key as a Bearer token.

* POST /v1/web\_search  
Search the web. Params: query, count (1-100), country, safesearch, freshness, include\_domains, exclude\_domains, livecrawl.
* POST /v1/contents  
Fetch page content. Params: urls (array, max 20), formats (html|markdown|metadata), crawl\_timeout, max\_age.
* POST /v1/research  
Run a research task. Params: query, research\_effort (lite|standard|deep), max\_sources, background (boolean).
* GET /v1/research/:task\_id  
Poll a background research task. Returns status and the cited answer when ready.

HOW IT WORKS

## From query to cited answer

Search, fetch, and research through the same Bearer token you already use.

[EXPLORE DEV DOCS](https://developers.telnyx.com/docs/web-search)

cURL

```
# 1. Web search with snippets
curl -X POST "https://web-search.telnyx.com/v1/web_search" \
  -H "Authorization: Bearer $TELNYX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "latest Telnyx voice AI pricing",
    "count": 5,
    "country": "US",
    "safesearch": "moderate"
  }'

# 2. Fetch page content
curl -X POST "https://web-search.telnyx.com/v1/contents" \
  -H "Authorization: Bearer $TELNYX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "urls": ["https://telnyx.com/pricing/voice-ai-agents"],
    "formats": ["markdown"]
  }'

# 3. Deep research with citations
curl -X POST "https://web-search.telnyx.com/v1/research" \
  -H "Authorization: Bearer $TELNYX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "Compare Telnyx vs Twilio voice API pricing in 2026",
    "research_effort": "standard",
    "max_sources": 10
  }'
```

PRODUCTS

## One platform for agent infrastructure.

Web Search API is one part of a full platform for agent infrastructure. Same API key, same network, same bill.

[See all products](https://telnyx.com/products)

* ### Inference  
Run open-weight and proprietary models on Telnyx GPUs. No separate API key, no separate bill.  
[Learn more](https://telnyx.com/products/inference)
* ### Voice AI Agents  
Build and deploy low-latency Voice AI agents in minutes on a full-stack, conversational AI platform.  
[Learn more](https://telnyx.com/products/voice-ai)
* ### Functions  
Deploy containerized code to the edge with one command. Any language, any runtime, bindings to storage and the Telnyx API.  
[Learn more](https://telnyx.com/products/functions)
* ### Cloud Storage  
Discover low-latency, cost-effective storage for your AI applications. Store data and embeddings in one place.  
[Learn more](https://telnyx.com/products/cloud-storage)

## Get started with Web Search API

Web Search API is live. Try it with your Telnyx API key.

[Explore the platform](https://telnyx.com/products)[Read the docs](https://developers.telnyx.com/docs/web-search)

## Get started with Web Search API

Web Search API is live. Try it with your Telnyx API key.

[Explore the platform](https://telnyx.com/products)[Read the docs](https://developers.telnyx.com/docs/web-search)

## FAQ

### What is the Web Search API?

A Telnyx-owned API for web search, page content retrieval, and deep research. Uses your existing Telnyx API key. See the [docs](https://developers.telnyx.com/docs/web-search) for full API reference.

### Do I need a separate search provider account?

### What endpoints are available?

### How does background research work?

### What formats does /v1/contents return?

### Can I scope search to specific domains?

### What does livecrawl do?

### How much does it cost?

### Which provider backs the search?

### How fast is it?

[Start building](https://telnyx.com/sign-up)