# typesearch

> Search API for AI agents: our own continuously refreshed news index, a calibrated relevance score on every
> result, structured answers per result, and drop-in compatibility with the Exa, Tako and Perplexity SDKs.
> Base URL: https://api.typesearch.ai · OpenAPI: /openapi.json · Full docs as one file: /llms-full.txt
> Agents calling the API: start with /.well-known/skill.md (which endpoint to use, what it costs, a request for each).

## Products

- [Search API](https://typesearch.ai/products/search): Ranked, verified results from our own index. From $1.00 / 1k requests.
- [Contents API](https://typesearch.ai/products/contents): Metadata and a short verbatim excerpt for any URL. $0.20 / 1k pages.
- [Similar API](https://typesearch.ai/products/similar): Everything written about the same story. $2.20 / 1k requests.
- [Live site search](https://typesearch.ai/products/site-search): Search any site, right now. $2.40 / 1k requests.
- [Custom index](https://typesearch.ai/products/custom-index): Your agent searches the pages you choose. $2.00 / 1k URLs a month.
- [Charts API](https://typesearch.ai/products/charts): Ask in plain words, get the right chart. From $1.50 / 1k charts.
- [Monitors](https://typesearch.ai/products/monitors): Webhooks when your topic moves. $2.80 / 1k requests (planned, coming soon).
- [News API for AI agents](https://typesearch.ai/news-api): real-time news search built for agents and LLMs: coverage in 130+ countries and 30+ languages, an example request and prices per mode. Spanish: https://typesearch.ai/es/api-de-noticias
- [Argentina news API](https://typesearch.ai/news-api/argentina): news from outlets based in Argentina that publish in Spanish. Filter with countries: ["AR"], languages: ["es"]. Spanish: https://typesearch.ai/es/api-de-noticias/argentina
- [Brazil news API](https://typesearch.ai/news-api/brazil): news from outlets based in Brazil that publish in Portuguese. Filter with countries: ["BR"], languages: ["pt"]. Spanish: https://typesearch.ai/es/api-de-noticias/brasil
- [Spain news API](https://typesearch.ai/news-api/spain): news from outlets based in Spain that publish in Spanish. Filter with countries: ["ES"], languages: ["es"]. Spanish: https://typesearch.ai/es/api-de-noticias/espana

## Integrations

- [All integrations](https://typesearch.ai/integrations): what works today with each framework and SDK, and how. Spanish: https://typesearch.ai/es/integraciones
- MCP server: https://api.typesearch.ai/mcp (Streamable HTTP, stateless; key in Authorization: Bearer or x-api-key). Tools: search_news, get_contents, find_similar, create_chart; search_news takes an optional index (idx_…) to search a custom index instead of the news index, and create_chart turns a question into a chart card (image and embed URLs, with sources). Claude Code: `claude mcp add --transport http typesearch https://api.typesearch.ai/mcp --header "Authorization: Bearer $TYPESEARCH_API_KEY"`
- [MCP server](https://typesearch.ai/mcp): News search as tools for Claude, Cursor, VS Code, Codex and any MCP client. Setup: Remote server · one click.
- [LangChain](https://typesearch.ai/docs/integrations/langchain): A news search tool and retriever for LangChain agents, in Python and JavaScript. Setup: langchain-exa, pointed at typesearch.
- [Vercel AI SDK](https://typesearch.ai/docs/integrations/vercel-ai-sdk): A news search tool for generateText, streamText and agents. Setup: A tool() over the HTTP API.
- [LlamaIndex](https://typesearch.ai/docs/integrations/llamaindex): News search as a tool for LlamaIndex agents and workflows. Setup: A FunctionTool over the HTTP API.
- [n8n](https://typesearch.ai/docs/integrations/n8n): News in your workflows, and as a tool for the AI Agent node. Setup: The HTTP Request node.
- [Exa SDKs](https://typesearch.ai/docs/integrations/exa-compatible): exa-py, exa-js and the tools built on them that let you set the base URL, such as langchain-exa. Setup: Change the base URL and the key.
- [Tako SDK](https://typesearch.ai/docs/migration/tako): The Tako SDK, Python and JavaScript, against our compatibility layer. Setup: Change the host and the key.
- [Perplexity SDK](https://typesearch.ai/docs/migration/perplexity): The Perplexity Search API SDK, Python and JavaScript, against our compatibility layer. Setup: Change the base URL and the key.
- [HTTP API and OpenAPI](https://typesearch.ai/docs/api-reference): Plain JSON over HTTPS from any language, described by an OpenAPI 3.1 document you can feed to any client generator. Setup: OpenAPI 3.1 · JSON · SSE.

## Open source

- [Open-source apps and SDKs](https://typesearch.ai/open-source): MIT-licensed apps to clone or deploy in one click, and the SDKs, MCP server and plugins. GitHub: https://github.com/typesearch-ai. Spanish: https://typesearch.ai/es/open-source
- [Fact check](https://github.com/typesearch-ai/fact-check): Paste a text: each checkable claim is searched in recent coverage and marked supported, contradicted or unverified, with the quote that decides it and a link to the article. Next.js and the Vercel AI SDK. Use case: https://typesearch.ai/use-cases/fact-checking
- [News briefing](https://github.com/typesearch-ai/news-briefing): Pick a country, a language and a topic: typesearch finds the day’s articles and the model writes the briefing, with every sentence linked to the article it comes from. Next.js and the Vercel AI SDK. Use case: https://typesearch.ai/use-cases/briefings

## Changelog

- [Changelog](https://typesearch.ai/changelog): new products, endpoints and behavior in the API, newest first. RSS: https://typesearch.ai/changelog/rss.xml. Spanish: https://typesearch.ai/es/novedades

## Pricing and comparisons

- [Pricing](https://typesearch.ai/pricing): pay per request, no seats or minimums. Spanish: https://typesearch.ai/es/precios
- Search, USD per 1,000 requests, by mode: ultra $1.00, fast $1.40, normal $2.20 (reads the top 4), deep $5.60 (reads 8, with highlights). Each query in a multi-query request is one search of its mode.
- Similar $2.20 per 1,000 requests ($4.60 in deep mode, which reads 8); live site search $2.40; contents $0.20 per 1,000 pages, $0.40 with a query. Cached repeats and failed requests are free.
- Custom index: $2.00 per 1,000 URLs a month, billed daily and prorated from the same credit; every URL is re-read daily, sitemaps and feeds are checked hourly. Up to 100 URLs (3 indexes) pay as you go, 10,000 (50 indexes) with the monthly credit plan, unlimited on Enterprise. Searches over it (POST /v1/search with index: "idx_…") cost the same as the mode.
- Charts (POST /v1/charts, and create_chart on the MCP server): ask in plain words and get a chart card that picks the chart type (12: line, area, bar, bar_horizontal, stacked_bar, pie, donut, scatter, funnel, timeline, kpi, table), the key figures, a title that states the finding and the source of every value; or send your own data. From a query it first works out what you expect to see (returned as interpretation, with other readings to ask for) and gets that data, checked against the sources: race standings, wins in a season, poll or election results, what an outlet published, coverage, share of voice, tone, outlets, timelines or published figures. If the exact data is not published it shows the closest thing and says how close (rung), and a stored chart keeps improving until the data arrives; stream: true sends step, result and improved events. Four themes (light, dark, editorial, electric), an embeddable iframe, a PNG and an SVG. From a query: the search it needs (its mode, per query) plus $0.50 per 1,000 charts, so $1.50 per 1,000 with ultra and $1.90 with fast. From your own data: $0.30 per 1,000. Embeds, images, type or theme changes (PATCH) and repeats within 10 minutes are free; failed charts are not billed. Tako's Search, which returns chart cards, lists at $7 per 1,000.
- New accounts get $5 in free credit, valid for 30 days.
- Against Exa: an ultra search (headlines only) lists at $1.00 per 1,000 and a fast one at $1.40, against $7 for a search on Exa. Normal and deep read pages before ranking and cost more, so the gap in those modes is smaller. Some search APIs (Perplexity, Parallel) list their most basic search at the price of our ultra mode and for less than our fast mode. Every comparison, mode by mode and with sources, is on the compare pages.
- [Alternatives](https://typesearch.ai/alternatives): Exa, Tavily, Perplexity, Tako and Bing News compared side by side.
- [Google News API](https://typesearch.ai/google-news-api): there is no official Google News API; the real options for getting news into an app or an agent, compared.
- [typesearch vs Exa](https://typesearch.ai/compare/exa): the Exa alternative that works with the Exa SDK: change the base URL and the key. Prices for comparable work, mode by mode, on the page.
- [typesearch vs Tako](https://typesearch.ai/compare/tako): the Tako alternative that works with the Tako SDK: change the base URL and the key. Prices for comparable work, mode by mode, on the page.
- [typesearch vs Perplexity](https://typesearch.ai/compare/perplexity): the Perplexity alternative that works with the Perplexity SDK: change the base URL and the key. Prices for comparable work, mode by mode, on the page.
- [typesearch vs Tavily](https://typesearch.ai/compare/tavily): the Tavily alternative for news search: one request to rewrite. Prices mode by mode on the page.
- [typesearch vs Bing News Search API](https://typesearch.ai/compare/bing-news-search): a replacement for the Bing News Search API, retired by Microsoft on August 11, 2025.

## Compared with news APIs

- [typesearch vs NewsAPI.org](https://typesearch.ai/compare/newsapi-org): A news API with a 5-year archive. Plans, limits and news features compared, each with its source and date (checked 2026-09-25).
- [typesearch vs GNews](https://typesearch.ai/compare/gnews): A low-cost news API with full text. Plans, limits and news features compared, each with its source and date (checked 2026-09-25).
- [typesearch vs NewsData.io](https://typesearch.ai/compare/newsdata): A news API with a 10-year archive and AI tags. Plans, limits and news features compared, each with its source and date (checked 2026-09-25).
- [typesearch vs NewsCatcher](https://typesearch.ai/compare/newscatcher): An enterprise news API with rich NLP. Plans, limits and news features compared, each with its source and date (checked 2026-09-25).
- [typesearch vs Event Registry](https://typesearch.ai/compare/event-registry): A news API with events, concepts and a 2014+ archive. Plans, limits and news features compared, each with its source and date (checked 2026-09-25).
- [typesearch vs mediastack](https://typesearch.ai/compare/mediastack): A simple, low-cost news API. Plans, limits and news features compared, each with its source and date (checked 2026-09-25).
- [typesearch vs Perigon](https://typesearch.ai/compare/perigon): A news context platform with rich enrichment. Plans, limits and news features compared, each with its source and date (checked 2026-09-25).
- [typesearch vs APITube](https://typesearch.ai/compare/apitube): A low-cost news API with many filters. Plans, limits and news features compared, each with its source and date (checked 2026-09-25).
- [typesearch vs SerpApi](https://typesearch.ai/compare/serpapi): Google News results, scraped. Plans, limits and news features compared, each with its source and date (checked 2026-09-25).
- [typesearch vs Brave Search API](https://typesearch.ai/compare/brave): A web search API with a news endpoint. Plans, limits and news features compared, each with its source and date (checked 2026-09-25).
- [typesearch vs Linkup](https://typesearch.ai/compare/linkup): A web search API for AI, with sourced answers. Plans, limits and news features compared, each with its source and date (checked 2026-09-25).
- [typesearch vs Parallel](https://typesearch.ai/compare/parallel): A web search API for agents, with monitors. Plans, limits and news features compared, each with its source and date (checked 2026-09-25).

## Lists of alternatives

- [Best Exa alternatives for news search in 2026](https://typesearch.ai/alternatives/exa)
- [Best Tavily alternatives for news search in 2026](https://typesearch.ai/alternatives/tavily)
- [Best Perplexity Search API alternatives for news in 2026](https://typesearch.ai/alternatives/perplexity)
- [Best NewsAPI.org alternatives in 2026](https://typesearch.ai/alternatives/newsapi-org)

## Use cases

- [News API use cases for AI agents](https://typesearch.ai/use-cases): six jobs done with news search, each with the mode, the request and what it costs. Spanish: https://typesearch.ai/es/casos-de-uso
- [Media monitoring](https://typesearch.ai/use-cases/media-monitoring): Brands, people, competitors and topics, checked on a schedule — a Google Alerts alternative for developers.
- [Financial news](https://typesearch.ai/use-cases/financial-news): Company, ticker and macro news for trading and research agents, with typed answers on every article.
- [Risk and compliance](https://typesearch.ai/use-cases/risk-compliance): Adverse media screening, supplier risk and regulatory watch, with verbatim evidence for every flag.
- [Daily briefings](https://typesearch.ai/use-cases/briefings): The day’s coverage per topic, deduplicated, with verbatim quotes your model can cite.
- [Fact-checking](https://typesearch.ai/use-cases/fact-checking): Check a recent claim against what was actually reported, with the quote that supports or contradicts it.
- [Local and multilingual news](https://typesearch.ai/use-cases/multilingual-news): Local press in the language it was written in, starting with Latin America, filtered by country and language.

## For publishers

- [For publishers](https://typesearch.ai/publishers): what typesearch takes from news sites, what it shows and stores, the opt-out signals it honors, and a form to opt out, remove pages or talk about licensing. Spanish: https://typesearch.ai/es/medios · Portuguese: https://typesearch.ai/pt/imprensa
- [Our crawler](https://typesearch.ai/bot): TypesearchBot and Typesearch-User, their user agents, robots.txt rules and IP addresses.


- Documentation

  - **Get started**
  - [Introduction](/docs): Search for AI agents, with a calibrated relevance score on every result and a price per mode.
  - [Quickstart](/docs/quickstart): Get a key and run your first search in under five minutes.
  - [Authentication](/docs/authentication): Every request carries an API key, in either of two headers.
  - [For AI agents](/docs/agents): Where an agent finds everything it needs to use typesearch on its own.
  - [Modes](/docs/modes): Four depths of search. Pick the cheapest one that answers your question.

  - **Guides**
  - [Search the index](/docs/guides/search): Queries, filters, and how to read every result.
  - [Several queries at once](/docs/guides/multiple-queries): Up to five queries in one request, judged together in one round-trip.
  - [Structured output](/docs/guides/structured-output): Ask typed questions and get calibrated answers on every result, in the same call.
  - [Enrichments](/docs/guides/enrichments): Tone, same-story grouping, verbatim essentials and who published first — in the same call.
  - [Search a live site](/docs/guides/live-site-search): Search any site right now — its homepage, its sections and its own search box.
  - [Custom index](/docs/guides/custom-index): Search your own URLs, sitemaps and feeds with the same relevance model, modes and prices as the news index.
  - [Charts](/docs/guides/charts): Ask in plain words and get a finished chart card, with the right chart, key figures, a title that states the finding and the source of every value.
  - [Find similar coverage](/docs/guides/similar): Everything the index has about the same story as an article.
  - [Get contents](/docs/guides/contents): Metadata and short verbatim excerpts for URLs you already have.
  - [Streaming](/docs/guides/streaming): Show results as they are verified instead of waiting for the slowest article.
  - [Costs and caching](/docs/guides/cost-control): What each request costs, hard caps per request, and everything that makes repeated searches cheaper.

  - **Migrate**
  - [Migrate from Exa](/docs/migration/exa): Keep exa-py or exa-js. Change the base URL and the key.
  - [Migrate from Tako](/docs/migration/tako): Keep the Tako SDK. Change the host and the key.
  - [Migrate from Perplexity](/docs/migration/perplexity): Keep the Perplexity SDK for the Search API. Change the base URL and the key.

  - **Operations**
  - [Errors](/docs/errors): One error format everywhere, with stable codes you can program against.
  - [Rate limits and quotas](/docs/rate-limits): A limit per minute and a quota per day, both visible on every response.
- API Reference
  - [Overview](/docs/api-reference): The typesearch HTTP API, version 1: base URL, authentication, errors and versioning.

  - **Search**
  - [Search](/docs/api-reference/search): Search the index for one query, or up to five judged together.
  - [Search a live site](/docs/api-reference/site-search): Search a site right now. Returns a job, or a stream of events.
  - [Get a job](/docs/api-reference/jobs): The status and, when it finished, the result of a live site search.
  - [Find similar](/docs/api-reference/similar): Articles in the index about the same story as a URL.
  - [Get contents](/docs/api-reference/contents): Metadata and short verbatim excerpts of up to 10 URLs.

  - **Charts**
  - [Create a chart](/docs/api-reference/charts): A chart card from a query in plain words, or from your own data.
  - [Manage charts](/docs/api-reference/manage-charts): List, get, change and delete the charts of your organization. All free.
  - [Embed, image and SVG](/docs/api-reference/chart-embed): The public embed page, PNG and SVG of a chart. No key needed.

  - **Account**
  - [Get usage](/docs/api-reference/usage): Usage today and over the last 30 days, and the limits of your key.
- SDKs
  - [SDKs](/docs/sdks): Official clients for TypeScript and Python, and the SDKs you already use.
  - [TypeScript SDK](/docs/sdks/typescript): typesearch-js — the official client for TypeScript and JavaScript.
  - [Python SDK](/docs/sdks/python): typesearch — the official client for Python, sync and async.
- Integrations
  - [Integrations](/docs/integrations): Use typesearch from LangChain, the Vercel AI SDK, LlamaIndex, n8n and the Exa SDKs, with the same key and prices as the API.

  - **Agents and workflows**
  - [MCP server](/docs/integrations/mcp): Real-time news search and chart cards for Claude, Cursor, VS Code, Codex and any MCP client, with the same key and prices as the API.
  - [LangChain](/docs/integrations/langchain): News search for LangChain agents, in Python and JavaScript.
  - [Vercel AI SDK](/docs/integrations/vercel-ai-sdk): A news search tool for generateText, streamText and agents built with the Vercel AI SDK.
  - [LlamaIndex](/docs/integrations/llamaindex): News search as a tool for LlamaIndex agents and workflows.
  - [n8n](/docs/integrations/n8n): News in your n8n workflows, and as a tool for the AI Agent node.

  - **SDKs**
  - [Exa-compatible SDKs](/docs/integrations/exa-compatible): exa-py, exa-js, langchain-exa and other tools built on them, pointed at typesearch.