Jina Search Foundation API

r.jina.ai を使用して URL を読み取り、その内容を取得します。

s.jina.ai でウェブを検索し、SERP を取得します

LLM から当社の API にアクセスするには、MCP サーバーとして mcp.jina.ai を追加してください

パラメータ

レート制限を高めるには API キーを追加します

より高いレート制限にアクセスするには、Jina API キーを入力してください。最新のレート制限情報については、以下の表を参照してください。もっと詳しく知る

ブラウザエンジン (品質/速度)

X-Engine

Web コンテンツを取得するために使用するブラウザエンジンを選択します。これは、コンテンツの品質、速度、完全性、アクセシビリティに影響します。もっと詳しく知る

デフォルト

コンテンツ形式

Return-Format

過剰なフィルタリングを防ぐために、応答の詳細レベルを制御できます。デフォルトのパイプラインは、ほとんどのサイトと大規模なモデル入力に対して最適化されています。

デフォルト

JSON応答

応答は JSON 形式で、URL、タイトル、コンテンツ、およびタイムスタンプ (利用可能な場合) が含まれます。検索モードでは、記述された JSON 構造にそれぞれ従う 5 つのエントリのリストが返されます。

タイムアウト（秒）

X-Timeout

ページの読み込みに要する最大待機時間です。ページの読み込みが遅い場合はこの値を増やし、シンプルで静的なページの場合はこの値を下げてください。

トークンの予算

X-Token-Budget

このリクエストで使用されるトークンの最大数を制限します。この制限を超えると、リクエストは失敗します。

ReaderLM-v2の使用

実験的

X-Respond-With

ReaderLM-v2 を使用して HTML を Markdown に変換し、複雑な構造とコンテンツを持つ Web サイトに高品質な結果を提供します。トークンを 3 倍消費します!もっと詳しく知る

抽出のみ（CSSセレクター）

X-Target-Selector

これらのCSSセレクタに一致するコンテンツのみを抽出します。例: article、.main-content、#post-body

待機中（CSSセレクター）

X-Wait-For-Selector

これらの要素が出現した後にのみコンテンツを抽出します。これは、動的に読み込まれるコンテンツに非常に便利です。

除外（CSSセレクター）

X-Remove-Selector

抽出前にこれらの要素を削除します。例: nav、footer、.sidebar、#ads

すべての写真を削除

X-Retain-Images

出力からすべての画像を削除します。これにより、画像が不要な場合のトークンの使用量を削減できます。

OpenAI引用フォーマット

X-Retain-Links

OpenAI の Web ブラウジングツール向けにリンクをフォーマットします。GPT モデルと互換性のある特別な引用マーカーを使用します。もっと詳しく知る

リンク概要セクション

X-With-Links-Summary

最後に、「ボタンとリンク」セクションを作成します。これは、下流の大規模モデルやWebエージェントがページ内を移動したり、さらなるアクションを実行したりするのに役立ちます。

なし

画像概要セクション

X-With-Images-Summary

最後に、「写真」セクションが作成されます。これにより、下流の大規模モデルはページ上のすべてのビジュアルを概観できるようになり、推論機能が向上します。

なし

ブラウザのビューポートサイズ

POST

viewport

ブラウザウィンドウのサイズを設定します。レスポンシブレイアウトとコンテンツの表示に影響します。もっと詳しく知る

転送クッキー

X-Set-Cookie

弊社の API サーバーは、URL にアクセスするときにカスタム Cookie 設定を転送できます。これは、追加の認証が必要なページに役立ちます。 Cookie を含むリクエストはキャッシュされないことに注意してください。もっと詳しく知る

画像キャプション

X-With-Generated-Alt

指定された URL にあるすべての画像にキャプションを追加し、キャプションのない画像には alt タグとして「Image [idx]: [caption]」を追加します。これにより、大規模な下流モデルは推論や要約などのアクティビティ中に画像を操作できるようになります。

プロキシサーバーを使用する

X-Proxy-Url

API サーバーはプロキシを利用して URL にアクセスできます。これは、特定のプロキシ経由でのみアクセスできるページに役立ちます。もっと詳しく知る

国別のプロキシサーバーを使用する

X-Proxy

ロケーションベースのプロキシサーバーの国コードを設定します。最適な選択には「自動」を使用し、無効にするには「なし」を使用します。

キャッシュのバイパス

X-No-Cache

当社の API サーバーは、読み取りモードと検索モードのコンテンツを一定期間キャッシュします。このキャッシュをバイパスするには、このヘッダーを true に設定します。

キャッシュ許容値（秒）

X-Cache-Tolerance

キャッシュされたコンテンツがN秒以内に公開された場合、キャッシュされたコンテンツが受け入れられます。0に設定すると最新のコンテンツが受け入れられます（「キャッシュをバイパスする」のと同じ）。一方、値を大きくすると、キャッシュからのレスポンスの取得速度が向上します。

ページ準備時間

X-Respond-Timing

ページが完全に読み込まれたとみなされるのはいつですか? 後のタイミング方法では待機時間が長くなりますが、より動的なコンテンツをキャプチャします。

デフォルト

カスタムユーザーエージェント

X-User-Agent

ブラウザのユーザーエージェント文字列を上書きします。これは、特定のブラウザを必要とするウェブサイトや、ウェブクローラーをブロックするウェブサイトにアクセスする場合に非常に便利です。

カスタム Referer

X-Referer

HTTP Referer ヘッダーを設定します。一部のウェブサイトでは、トラフィックが想定されたソースから来ているかどうかを確認するためにこのヘッダーをチェックします。

Base64画像を保存

X-Keep-Img-Data-Url

インライン base64 でエンコードされた画像を外部 URL に変換する代わりに、Markdown 出力に保持します。

キャッシュや追跡を行わない

DNT

このリクエストが当社のサーバーでキャッシュまたは記録されないようにします。機密性の高い URL にご利用ください。

Github スタイルのマークダウン

X-No-Gfm

GFM (Github Flavored Markdown) 機能のオプトイン/アウト。

有効

ストリーミングモード

ストリーミングモードは、対象ページが大きい場合に有効で、ページが完全にレンダリングされるまでより長く待機できます。標準モードでコンテンツが不完全になる場合は、ストリーミングモードの使用をご検討ください。もっと詳しく知る

ブラウザのロケールをカスタマイズする

X-Locale

ページをレンダリングするためのブラウザーのロケール設定を制御します。多くの Web サイトは、ロケール設定に基づいて異なるコンテンツを提供します。もっと詳しく知る

Robots.txtを尊重する

X-Robots-Txt

取得前に robots.txt のルールを確認します。チェックに使用するボット名を指定してください。

iframeコンテンツを含む

X-With-Iframe

埋め込まれた iframe からコンテンツを抽出します。iframe 内にコンテンツが読み込まれるページで有効にしてください。

Shadow DOMを含む

X-With-Shadow-Dom

Shadow DOMコンポーネントからコンテンツを抽出します。Webコンポーネントを使用するページに適しています。

最終 URL をベースとして使用する

X-Base

相対 URL を解決するには、元の URL ではなく、リダイレクト後の最終的なターゲット URL を使用します。

ローカル PDF/HTML ファイル

POST

ローカルの PDF および HTML ファイルをアップロードして Reader で読み取ります。pdf と html ファイルのみサポートされます。HTML の場合は、関連する CSS/JS スクリプトをより適切に解析するために参照 URL も指定してください。

抽出前にJavaScriptを実行する

POST

コンテンツを抽出する前に、カスタムJavaScriptコードを実行してページを変更します。これは、インラインコードまたはスクリプトファイルを指すURLのいずれかです。もっと詳しく知る

見出しスタイル

X-Md-Heading-Style

マークダウンのタイトル形式を設定します (Turndown に渡されます)。

ハッシュスタイル

水平線スタイル

X-Md-Hr

マークダウンの水平罫線形式を定義します (Turndown に渡されます)。

箇条書きスタイル

X-Md-Bullet-List-Marker

箇条書きリストのマーク文字を設定します (Turndown に渡されます)。

強調スタイル

X-Md-Em-Delimiter

マークダウン強調区切り文字を定義します (Turndown に渡されます)。

強い強調のスタイル

X-Md-Strong-Delimiter

マークダウンの強い強調区切り文字を設定します (Turndown に渡されます)。

リンクスタイル

X-Md-Link-Style

マークダウンリンク形式を決定します (Turndown に渡されます)。

インライン

EUリジデンシー

実験的

有効にすると、このリクエストのインフラとデータ処理は EU 内に配置されます。

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