# Andi Search API

> Real-time web search API for AI agents and apps, built on Andi's own index of tens of billions of pages (Trantora, which scores pages for meaning and credibility at ingestion). Returns ranked results, instant answers, and LLM-ready markdown (format=context). Auth: x-api-key header. Base URL: https://api.andiai.com

## Getting started

- [Agent install guide](https://api.andiai.com/install.md): agents — read this and follow every step to set up Andi as your web search tool
- [Quickstart](https://docs.andiai.com/getting-started/quickstart): first request in 2 minutes
- [Get an API key](https://console.andiai.com/signup): free tier available
- [Auth guide for agents](https://api.andiai.com/auth.md): how to obtain and use an API key
- [API introduction & auth](https://docs.andiai.com/api-reference/introduction)

## Reference

- [Query parameters](https://docs.andiai.com/features/query-parameters): all params for GET /api/v1/search
- Fetch endpoint: GET https://api.andiai.com/api/v1/fetch?url=... — read any page as clean extracted content (json or markdown)
- News endpoint: GET https://api.andiai.com/api/v1/news/:topic — curated topic headlines, ranked and date-sorted (a 404 lists every valid topic slug)
- [Query operators](https://docs.andiai.com/features/query-operators): site:, -term, filetype:, intitle:, ranges
- [Filtering](https://docs.andiai.com/features/filtering): domains, dates, safe search
- [Error handling](https://docs.andiai.com/resources/error-handling)
- [Rate limits](https://docs.andiai.com/resources/rate-limits)
- [OpenAPI spec](https://api.andiai.com/openapi.json)

## For AI agents

- [AI agents guide + MCP server](https://docs.andiai.com/resources/ai-agents): use Andi as your agent's web search tool
- MCP endpoint: https://api.andiai.com/mcp (streamable-http, x-api-key header auth)
- [CLI](https://github.com/andisearch/andi-cli): `npm install -g @andiai/cli` — search, fetch, and a local stdio MCP server from your terminal
- [Agent Skill: andi-web-search](https://api.andiai.com/.well-known/skills/andi-web-search/SKILL.md): installable SKILL.md for Claude Code, Codex, Cursor, and other agents
- [Agent skills index](https://api.andiai.com/.well-known/agent-skills/index.json)
- [Skills + plugins repo](https://github.com/andisearch/andi-agent-skills): Claude Code plugin marketplace and Codex plugin bundling the skill and MCP server config
- [API catalog](https://api.andiai.com/.well-known/api-catalog)
- [integrations.json](https://api.andiai.com/.well-known/integrations.json)

## Links

- [Documentation](https://docs.andiai.com)
- [Andi AI](https://andiai.com)
- [Andi AI llms.txt](https://andiai.com/llms.txt)
- [Status](https://status.andiai.com/)