API Documentation

Base URL: https://contextwire.dev/api

Free tier: 1,000 queries/month. All endpoints included. Get your API key →

Authentication

All API requests require an API key passed via the Authorization header:

Authorization: Bearer YOUR_API_KEY

Quickstart

curl "https://contextwire.dev/api/ask?q=What+is+quantum+computing" \
  -H "Authorization: Bearer YOUR_API_KEY"

Rate Limits

Tier	Queries/month	Rate
Free	1,000	30/min
Pro	50,000	120/min
Admin	Unlimited	Unlimited

Ask — Full Research Loop

GET/api/ask

Ask a factual question and get a direct answer with sources. Multi-phase research loop scoring 94.3% on SimpleQA benchmark.

Parameter	Type	Description
`q` required	string	The question to answer

{
  "answer": "299,792,458 meters per second",
  "source": "snippets",
  "latency_ms": 3854,
  "sources": [{"title": "Speed of light - Wikipedia", "url": "..."}],
  "pageExcerpts": [{"title": "...", "text": "..."}],
  "phases": [{"phase": 1, "source": "Google+Bing snippets"}]
}

Search — Web Search

GET/api/search

Search the web using 100+ engines via SearXNG.

Parameter	Type	Description
`q` required	string	Search query
`profile`	string	web, news, academic, code, devnews, images, videos, social, reference, finance, repos, packages, security, all
`max_results`	number	1-100 (default: 10)
`format`	string	json or text (default: json)
`freshness`	string	day, week, month, year
`include_content`	number	Number of results to fetch full page content for (0-5)

Extract — Page Content

GET/api/extract

Extract clean text or markdown from any URL.

Parameter	Type	Description
`url` required	string	URL to extract content from
`format`	string	text or markdown (default: text)

Research — Academic Papers

GET/api/research

Search academic papers from arXiv, Semantic Scholar, CrossRef, PubMed, and OpenAlex.

Parameter	Type	Description
`q` required	string	Research query
`max_papers`	number	1-20 (default: 5)

Batch Search

POST/api/search/batch

Run multiple search queries in parallel.

{
  "queries": [
    {"q": "latest AI news", "profile": "news", "max_results": 5},
    {"q": "machine learning papers", "profile": "academic", "max_results": 5}
  ]
}

Autocomplete

GET/api/suggest

Get autocomplete suggestions for a partial query.

Engines

GET/api/engines

List all available search engines. Filter by category.

Profiles

GET/api/profiles

List all 22 search profiles with their engine configurations.

MCP Server Integration

Add ContextWire to Claude Code or Cursor as an MCP server:

# Claude Code
claude mcp add contextwire --transport http \
  https://contextwire.dev/mcp \
  -- --header "Authorization: Bearer YOUR_KEY"

# Cursor — add to .cursor/mcp.json
{
  "mcpServers": {
    "contextwire": {
      "url": "https://contextwire.dev/mcp",
      "headers": {"Authorization": "Bearer YOUR_KEY"}
    }
  }
}

Error Codes

Code	Meaning
400	Bad request — missing or invalid parameters
401	Unauthorized — invalid or missing API key
429	Rate limit exceeded
500	Server error

Changelog

v2.1.0 (March 2026) — MCP server, fact checker, deep research reports, batch search, 22 profiles

v2.0.0 (March 2026) — Full research loop, 94.3% SimpleQA, page extraction, academic search