Jina Search API
Official OpenAPI specification for the Jina Search API (`s.jina.ai`). Jina Search is an AI search engine that searches the open web and returns clean, LLM-friendly content directly from top search results in Markdown or structured JSON. **Key Features:** - AI-optimized web search designed specifically for LLM grounding, RAG pipelines, and autonomous AI agents. - Returns full clean Markdown content along with titles, URLs, and snippets for top ranking results. - Configurable token budgets (`X-Token-Budget`) and extraction engines (`X-Engine`). - Supports JSON output via `Accept: application/json` or raw Markdown via `text/plain`.
Connect this API to an AI agent Browse all specs
What you can do with Jina Search API via MCP
Every endpoint below becomes a governed tool your AI agent (Claude, ChatGPT, or a customer-facing VX agent) can call — with scoped permissions, sandbox testing, and audit logs.
| Method | Path | Operation | Description |
|---|---|---|---|
| POST | / |
searchWeb | Search the Web |
| GET | /{query} |
searchWebViaPath | Search the Web via Path Query |
Authentication
BearerAuth
Bearer token — sent as Authorization: Bearer <token>
Jina AI API key passed as Bearer token in Authorization header (Authorization: Bearer jina_...)
Usage guide
Jina Search API Usage Guide for AI Agents
Overview
Jina Search (s.jina.ai) performs real-time web searches and extracts full clean Markdown content for the top matching web pages.
Authentication
Authenticate by sending your Jina AI API key as a Bearer token in the Authorization header:
Authorization: Bearer jina_YOUR_API_KEY
Get an API key (1,000,000 free tokens on signup, no credit card required) at https://jina.ai.
1. Web Search via POST (Recommended for AI Agents)
Send a POST request with the query in the JSON payload:
POST https://s.jina.ai/
Authorization: Bearer jina_YOUR_API_KEY
Accept: application/json
Content-Type: application/json
{
"q": "latest quantum computing breakthroughs 2026"
}
2. Web Search via GET Path
Prepend https://s.jina.ai/ to any URL-encoded query:
GET https://s.jina.ai/latest+quantum+computing+breakthroughs
Authorization: Bearer jina_YOUR_API_KEY
Accept: application/json
3. Advanced Customization Headers
Accept: Set toapplication/jsonfor structured JSON results, ortext/plainfor raw Markdown stream.X-Token-Budget: Maximum token budget allowed for the returned search results.X-Timeout: Maximum seconds to wait for page retrieval (e.g.20).X-Respond-With: Set tono-contentto retrieve only titles and URLs without full page markdown bodies.
How to use this spec
- Create a free VX Agents account (sandbox tools included).
- Open the marketplace and connect “Jina Search API” to an agent.
- Expose it as an MCP server for Claude/ChatGPT, or chat with it directly.