Jina Search Foundation API

Use r.jina.ai to read a URL and fetch its content

Use s.jina.ai to search the web and get SERP

Add mcp.jina.ai as your MCP server to use our APIs in LLMs

Parameters

Add API Key for Higher Rate Limit

Enter your Jina API key to access a higher rate limit. For latest rate limit information, please refer to the table below.Learn more

Browser Engine (Quality/Speed)

X-Engine

Choose the browser engine for fetching the webpage content. This affects the quality, speed, completeness, accessibility of the content.Learn more

Default

Content Format

Return-Format

You can control the level of detail in the response to prevent over-filtering. The default pipeline is optimized for most websites and LLM input.

Default

JSON Response

The response will be in JSON format, containing the URL, title, content, and timestamp (if available). In Search mode, it returns a list of five entries, each following the described JSON structure.

Timeout (seconds)

X-Timeout

Maximum time to wait for page load. Increase for slow pages, decrease for simple static pages.

Token Budget

X-Token-Budget

Limits the maximum number of tokens used for this request. Exceeding this limit will cause the request to fail.

Use jina-ocr-v1

X-Respond-With

Uses jina-ocr-v1 to convert images to Markdown, delivering high-quality results on pages and documents with complex structure and content. Costs 40× more tokens!Learn more

Pagination

X-Page

The page to process. Focuses on the specified page of a multi-page document, and only applies when a document such as a PDF is being processed.

Extract Only (CSS Selector)

X-Target-Selector

Only extract content matching these CSS selectors. Example: article, .main-content, #post-body

Wait For (CSS Selector)

X-Wait-For-Selector

Wait until these elements appear before extracting content. Useful for dynamically loaded content.

Exclude (CSS Selector)

X-Remove-Selector

Remove these elements before extraction. Example: nav, footer, .sidebar, #ads

Remove All Images

X-Retain-Images

Strip all images from the output. Reduces token usage when images are not needed.

OpenAI Citation Format

X-Retain-Links

Format links for OpenAI's web browsing tool. Uses special citation markers compatible with GPT models.Learn more

Links Summary Section

X-With-Links-Summary

A "Buttons & Links" section is added at the end. This helps downstream LLMs and web agents navigate the page or take further actions.

None

Images Summary Section

X-With-Images-Summary

An "Images" section will be created at the end. This gives the downstream LLMs an overview of all visuals on the page, which may improve reasoning.

None

Browser Viewport Size

POST

viewport

Set browser window dimensions. Affects responsive layouts and content visibility.Learn more

Forward Cookie

X-Set-Cookie

Our API server can forward your custom cookie settings when accessing the URL, which is useful for pages requiring extra authentication. Note that requests with cookies will not be cached.Learn more

Image Caption

X-With-Generated-Alt

Captions all images at the specified URL, adding 'Image [idx]: [caption]' as an alt tag for those without one. This allows downstream LLMs to interact with the images in activities such as reasoning and summarizing.

Use a Proxy Server

X-Proxy-Url

Our API server can utilize your proxy to access URLs, which is helpful for pages accessible only through specific proxies.Learn more

Use a Country-Specific Proxy Server

X-Proxy

Set country code for location-based proxy server. Use 'auto' for optimal selection or 'none' to disable.

Bypass Cached Content

X-No-Cache

Our API caches URL contents for a certain amount of time. Set it to true to ignore the cached result and fetch the content from the URL directly.

Cache Tolerance (seconds)

X-Cache-Tolerance

Accept cached content if younger than N seconds. Set to 0 for fresh content (same as Bypass Cache), or higher values to allow faster responses from cache.

Page Ready Timing

X-Respond-Timing

When to consider a page fully loaded. Later timings wait longer but capture more dynamic content.

Default

Custom User-Agent

X-User-Agent

Override the browser User-Agent string. Useful for accessing sites that require specific browsers or block crawlers.

Custom Referer

X-Referer

Set the HTTP Referer header. Some sites check this to verify traffic comes from expected sources.

Preserve Base64 Images

X-Keep-Img-Data-Url

Keep inline base64-encoded images in markdown output instead of converting them to external URLs.

Do Not Cache or Track

DNT

Prevent this request from being cached or logged on our servers. Use for sensitive URLs.

GitHub Flavored Markdown

X-No-Gfm

Opt in/out features from GFM (GitHub Flavored Markdown).

Enabled

Stream Mode

Stream mode is beneficial for large target pages, allowing more time for the page to fully render. If standard mode results in incomplete content, consider using Stream mode.Learn more

Customize Browser Locale

X-Locale

Control the browser locale to render the page. Lots of websites serve different content based on the locale.Learn more

Respect robots.txt

X-Robots-Txt

Check robots.txt rules before fetching. Specify which bot name to use for the check.

Include iframe Content

X-With-Iframe

Extract content from embedded iframes. Enable for pages with content loaded in iframes.

Include Shadow DOM

X-With-Shadow-Dom

Extract content from Shadow DOM components. Enable for pages using web components.

Use Final URL as Base

X-Base

Resolve relative URLs using the final destination URL after redirects, instead of the original URL.

Local PDF/HTML file

POST

Use Reader on local PDF and HTML files by uploading them. Only PDF and HTML files are supported. For HTML, also specify a reference URL so related CSS/JS scripts can be parsed correctly.

Run JavaScript Before Extraction

POST

Execute custom JS to modify the page before content extraction. Can be inline code or a URL to a script file.Learn more

Heading Style

X-Md-Heading-Style

Sets markdown heading format (passed to Turndown).

Hash Style

Horizontal Rule Style

X-Md-Hr

Defines markdown horizontal rule format (passed to Turndown).

Bullet Point Style

X-Md-Bullet-List-Marker

Sets bullet list marker character (passed to Turndown).

Emphasis Style

X-Md-Em-Delimiter

Defines markdown emphasis delimiter (passed to Turndown).

Strong Emphasis Style

X-Md-Strong-Delimiter

Sets markdown strong emphasis delimiter (passed to Turndown).

Link Style

X-Md-Link-Style

Determines markdown link format (passed to Turndown).

Inline

EU Residency

Experimental

When enabled, infrastructure and data processing for this request are located within the EU.

curl "https://r.jina.ai/https://www.example.com"