API Jina Search Foundation

Utilisez r.jina.ai pour lire une URL et récupérer son contenu

Utilisez s.jina.ai pour rechercher sur le Web et obtenir le SERP

Ajoutez mcp.jina.ai comme serveur MCP pour accéder à notre API dans les LLM

Paramètres

Ajouter une clé API pour une limite de débit plus élevée

Entrez votre clé API Jina pour accéder à une limite de débit plus élevée. Pour obtenir les dernières informations sur les limites de taux, veuillez vous référer au tableau ci-dessous.Apprendre encore plus

Lire le moteur

X-Engine

Choisissez le moteur de recherche pour récupérer le contenu de la page web. Cela affecte la qualité, la rapidité, l'exhaustivité et l'accessibilité du contenu.Apprendre encore plus

Défaut

Format du contenu

Return-Format

Vous pouvez contrôler le niveau de détail de la réponse pour éviter un filtrage excessif. Le pipeline par défaut est optimisé pour la plupart des sites Web et des entrées LLM.

Défaut

Réponse JSON

La réponse sera au format JSON, contenant l'URL, le titre, le contenu et l'horodatage (si disponible). En mode Recherche, il renvoie une liste de cinq entrées, chacune suivant la structure JSON décrite.

Délai d'attente (secondes)

X-Timeout

Délai maximal d'attente pour le chargement de la page. Augmenter ce délai pour les pages lentes, le diminuer pour les pages statiques simples.

Budget symbolique

X-Token-Budget

Limite le nombre maximal de jetons utilisés pour cette demande. Le dépassement de cette limite entraînera l'échec de la demande.

Utiliser ReaderLM-v2

Expérimental

X-Respond-With

Utilise ReaderLM-v2 pour la conversion HTML en Markdown, afin de fournir des résultats de haute qualité pour les sites Web aux structures et contenus complexes. Coûte 3x jetons !Apprendre encore plus

Extrait uniquement (sélecteur CSS)

X-Target-Selector

Extraire uniquement le contenu correspondant à ces sélecteurs CSS. Exemple : article, .main-content, #post-body

Attendre (sélecteur CSS)

X-Wait-For-Selector

Attendez que ces éléments apparaissent avant d'extraire le contenu. Utile pour le contenu chargé dynamiquement.

Exclure (sélecteur CSS)

X-Remove-Selector

Supprimez ces éléments avant l'extraction. Exemple : nav, footer, .sidebar, #ads

Supprimer toutes les images

X-Retain-Images

Supprime toutes les images du résultat. Cela réduit la consommation de jetons lorsque les images ne sont pas nécessaires.

Format de citation OpenAI

X-Retain-Links

Formate les liens pour l'outil de navigation web d'OpenAI. Utilise des marqueurs de citation spéciaux compatibles avec les modèles GPT.Apprendre encore plus

Résumé des liens

X-With-Links-Summary

Une section "Boutons & Liens" sera créée à la fin. Cela aide les LLM ou les agents Web en aval à naviguer sur la page ou à entreprendre d'autres actions.

Aucun

Section récapitulative des images

X-With-Images-Summary

Une section "Images" sera créée à la fin. Cela donne aux LLM en aval un aperçu de tous les visuels de la page, ce qui peut améliorer le raisonnement.

Aucun

Taille de la fenêtre du navigateur

POST

viewport

Définir les dimensions de la fenêtre du navigateur. Cela affecte la mise en page adaptative et la visibilité du contenu.Apprendre encore plus

Cookie de transfert

X-Set-Cookie

Notre serveur API peut transmettre vos paramètres de cookies personnalisés lors de l'accès à l'URL, ce qui est utile pour les pages nécessitant une authentification supplémentaire. Notez que les demandes contenant des cookies ne seront pas mises en cache.Apprendre encore plus

Légende

X-With-Generated-Alt

Sous-titre toutes les images à l'URL spécifiée, en ajoutant « Image [idx] : [caption] » comme balise alt pour celles qui n'en ont pas. Cela permet aux LLM en aval d'interagir avec les images dans des activités telles que le raisonnement et la synthèse.

Utiliser un serveur proxy

X-Proxy-Url

Notre serveur API peut utiliser votre proxy pour accéder aux URL, ce qui est utile pour les pages accessibles uniquement via des proxys spécifiques.Apprendre encore plus

Utiliser un serveur proxy spécifique à un pays

X-Proxy

Définissez le code pays pour le serveur proxy basé sur la localisation. Utilisez « auto » pour une sélection optimale ou « aucun » pour désactiver.

Contourner le cache

X-No-Cache

Notre serveur API met en cache le contenu des modes Lecture et Recherche pendant un certain temps. Pour contourner ce cache, définissez cet en-tête sur true.

Tolérance du cache (secondes)

X-Cache-Tolerance

Accepter le contenu mis en cache s'il date de moins de N secondes. Définir sur 0 pour du contenu récent (équivalent à « Ignorer le cache »), ou sur des valeurs plus élevées pour permettre des réponses plus rapides du cache.

Délai de chargement de la page

X-Respond-Timing

Quand considérer une page comme entièrement chargée ? Les mesures ultérieures impliquent un temps d’attente plus long, mais permettent de capturer davantage de contenu dynamique.

Défaut

Agent utilisateur personnalisé

X-User-Agent

Modifiez la chaîne User-Agent du navigateur. Utile pour accéder aux sites nécessitant des navigateurs spécifiques ou bloquant les robots d'exploration.

Référent personnalisé

X-Referer

Configurez l'en-tête HTTP Referer. Certains sites le vérifient pour s'assurer que le trafic provient bien des sources attendues.

Préserver les images Base64

X-Keep-Img-Data-Url

Conservez les images encodées en base64 directement dans le code Markdown au lieu de les convertir en URL externes.

Ne pas mettre en cache ni suivre

DNT

Empêcher la mise en cache ou l'enregistrement de cette requête sur nos serveurs. À utiliser pour les URL sensibles.

Markdown à saveur Github

X-No-Gfm

Fonctionnalités d'activation/désactivation de GFM (Github Flavored Markdown).

Activé

Mode flux

Le mode flux est avantageux pour les grandes pages cibles, ce qui laisse plus de temps à la page pour s'afficher complètement. Si le mode standard génère un contenu incomplet, envisagez d’utiliser le mode Stream.Apprendre encore plus

Personnaliser les paramètres régionaux du navigateur

X-Locale

Contrôlez les paramètres régionaux du navigateur pour afficher la page. De nombreux sites Web proposent un contenu différent en fonction des paramètres régionaux.Apprendre encore plus

Respectez robots.txt

X-Robots-Txt

Vérifiez les règles du fichier robots.txt avant de récupérer les données. Spécifiez le nom du robot à utiliser pour la vérification.

Inclure le contenu iframe

X-With-Iframe

Extraire le contenu des iframes intégrées. Activer cette fonction pour les pages dont le contenu est chargé dans des iframes.

Inclure Shadow DOM

X-With-Shadow-Dom

Extraire le contenu des composants Shadow DOM. Activer pour les pages utilisant des composants web.

Utiliser l'URL finale comme base

X-Base

Résolvez les URL relatives en utilisant l'URL de destination finale après les redirections, au lieu de l'URL d'origine.

Fichier PDF/HTML local

POST

Utilisez Reader sur vos fichiers PDF et HTML locaux en les téléchargeant. Ne prend en charge que les fichiers PDF et HTML.

Exécuter JavaScript avant l'extraction

POST

Exécutez du code JS personnalisé pour modifier la page avant l'extraction du contenu. Il peut s'agir de code intégré ou d'une URL pointant vers un fichier script.Apprendre encore plus

Style de titre

X-Md-Heading-Style

Définit le format de titre Markdown (transmis à Turndown).

Style haschisch

Style de règle horizontale

X-Md-Hr

Définit le format de la règle horizontale de démarque (transmis à Turndown).

Style à puces

X-Md-Bullet-List-Marker

Définit le caractère marqueur de la liste à puces (transmis à Turndown).

Style d'emphase

X-Md-Em-Delimiter

Définit le délimiteur d'emphase Markdown (transmis à Turndown).

Style à forte emphase

X-Md-Strong-Delimiter

Définit le délimiteur d'emphase fort Markdown (transmis à Turndown).

Style de lien

X-Md-Link-Style

Détermine le format du lien Markdown (transmis à Turndown).

En ligne

Résidence dans l'UE

Expérimental

Lorsque cette option est activée, l'infrastructure et le traitement des données de cette requête sont situés dans l'UE.

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