Home
Contact usLog inSign up
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 startedRead the docs
Web search API flow: query through POST /v1/web_search to structured results
USE CASES

What teams build with it

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

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
# 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
  • Inference

    Inference

    Run open-weight and proprietary models on Telnyx GPUs. No separate API key, no separate bill.

    Learn more
  • Voice AI Agents

    Voice AI Agents

    Build and deploy low-latency Voice AI agents in minutes on a full-stack, conversational AI platform.

    Learn more
  • Functions hero visual

    Functions

    Deploy containerized code to the edge with one command. Any language, any runtime, bindings to storage and the Telnyx API.

    Learn more
  • Cloud Storage

    Cloud Storage

    Discover low-latency, cost-effective storage for your AI applications. Store data and embeddings in one place.

    Learn more

Get started with Web Search API

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

Explore the platformRead the docs

FAQ

A Telnyx-owned API for web search, page content retrieval, and deep research. Uses your existing Telnyx API key. See the docs for full API reference.