OpenAPI Marketplace

Jina Reader API

Name: Jina Reader API
Author: linh

v1.0.0 · 2 endpoints · 2 connections · shared by linh

Official OpenAPI specification for the Jina Reader API (`r.jina.ai`). Converts any web page URL into clean, LLM-friendly Markdown format optimized for AI agents, RAG systems, and content extraction. **Key Features:** - Free and open access (no API key required for standard usage; optional Bearer key for higher limits). - Cleans boilerplate, ads, navigation, and renders JavaScript-heavy SPAs. - Supports CSS selector targeting (`X-Target-Selector`) and element removal (`X-Remove-Selector`). - Returns structured JSON with title, description, metadata, and full Markdown content.

Connect this API to an AI agent Browse all specs

What you can do with Jina Reader 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	`/`	readUrlContent	Convert Webpage to Markdown
GET	`/{url}`	readUrlViaPath	Convert Webpage via Path URL

Authentication

BearerAuth

Bearer token — sent as Authorization: Bearer <token>

Optional Jina AI API key for higher rate limit tiers. Free usage does not require authentication.

Usage guide

Jina Reader API Usage Guide for AI Agents

Overview

Jina Reader converts any URL into clean Markdown. It is completely free to use without an API key for moderate volume.

1. Extract Markdown from URL via POST (Recommended for Agents)

Send a POST request with the target URL in the JSON body:

POST https://r.jina.ai/
Content-Type: application/json
Accept: application/json

{
  "url": "https://www.anthropic.com/news"
}

Response: Returns a structured JSON object containing:

data.title: Page title.
data.description: Meta description.
data.url: Canonical URL.
data.content: Complete webpage content converted into clean, readable Markdown.

2. Direct GET Extraction

You can also prepend https://r.jina.ai/ to any target URL:

GET https://r.jina.ai/https://blog.google/technology/ai/
Accept: application/json

3. Advanced Customization Headers

X-Target-Selector: CSS selector to restrict extraction to a specific element (e.g. main or article).
X-Remove-Selector: CSS selector to remove unwanted sections (e.g. header, footer, .sidebar).
X-Timeout: Maximum seconds to wait for page load (e.g. 30).
X-No-Cache: Set to true to force a live fetch and bypass cached content.

How to use this spec

Create a free VX Agents account (sandbox tools included).
Open the marketplace and connect “Jina Reader API” to an agent.
Expose it as an MCP server for Claude/ChatGPT, or chat with it directly.