Home
Contact usLog inSign up
TELNYX AI AGENT INFRASTRUCTURE

Web search built 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
WHY WEB SEARCH API

Search, fetch, and research through one API

Three endpoints cover the full agent search loop. No separate provider accounts, no extra keys, no extra bills.

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
  }'
USE CASES

What teams build with it

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

  • Web search results

    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.

  • Deep research

    Research agents

    Run multi-source research with citations. Background mode handles long tasks; poll the task_id when ready.

  • Content retrieval

    Competitive intelligence

    Track competitor pages, pricing, and announcements. Use include_domains to scope, freshness to control recrawl.

  • Background polling

    Content enrichment

    Fetch URLs and convert to clean Markdown for RAG pipelines, summaries, or downstream LLM calls.

Add web search to your agent stack.

Use your existing Telnyx API key. Free during beta.

Get startedRead the docs

FAQ

A Telnyx-owned API for web search, page content retrieval, and deep research. Currently backed by You.com, with the backend swappable without client changes.