Aller au contenu principal
Piloterr
Retour à la bibliothèque

API arXiv Search

Recherche d'articles arXiv par mot-clé, requête d'auteur au:nom, ou identifiant. Une URL d'article renvoie 400.

Actif1 crédit = 1 requêteGET/v2/arxiv/search

Vue d'ensemble de l'endpoint

Documentation détaillée, tarifs et exemples d'utilisation.

OverviewLink to Overview

Recherche d'articles arXiv. query accepte un mot-clé, une requête de champ comme au:einstein, un identifiant tel que 2201.00978 ou cond-mat/0011267, ou une URL https://arxiv.org/search/. Une URL d'article (/abs/, /pdf/ ou /html/) renvoie 400. Passez-la à l'endpoint paper.

GET et POST utilisent les mêmes noms de paramètres. Envoyez la clé dans l'en-tête x-api-key.

QuickstartLink to Quickstart

curl -sS -H "x-api-key: YOUR_API_KEY" "https://api.piloterr.com/v2/arxiv/search?query=electron"
curl -sS -H "x-api-key: YOUR_API_KEY" "https://api.piloterr.com/v2/arxiv/search?query=au:einstein"
curl -sS -H "x-api-key: YOUR_API_KEY" "https://api.piloterr.com/v2/arxiv/search?query=2201.00978"
curl -sS -H "x-api-key: YOUR_API_KEY" "https://api.piloterr.com/v2/arxiv/search?query=electron&page=2"

ParametersLink to Parameters

Name Detail
query Chaîne obligatoire. Mot-clé, au:nom, identifiant arXiv, ou URL de recherche arxiv.org. Exemple : electron. Une URL d'article renvoie 400.
page Entier facultatif à partir de 1. Exemple : 2. Valeur par défaut : 1.

Response fieldsLink to Response fields

Name Detail
results[].arxiv_id Chaîne. Identifiant sans version, par exemple cond-mat/0011267.
results[].version Entier ou null. Le suffixe v1 en nombre.
results[].title Chaîne. Titre.
results[].authors Tableau de {name, affiliation}. affiliation est null si arXiv n'en donne pas.
results[].abstract Chaîne ou null. Résumé.
results[].primary_category Chaîne ou null. Catégorie principale.
results[].categories Tableau de chaînes.
results[].published Chaîne ou null. Première publication, UTC.
results[].updated Chaîne ou null. Dernière mise à jour, UTC.
results[].comment Chaîne ou null. Commentaire des auteurs.
results[].journal_ref Chaîne ou null. Référence de revue si le preprint est publié.
results[].doi Chaîne ou null.
results[].pdf_url Chaîne ou null. Lien PDF.
results[].url Chaîne. Page résumé.
pagination.page Entier. Page demandée.
pagination.per_page Entier. Toujours 10.
pagination.total_results Entier ou null. Un mot-clé large peut dépasser plusieurs centaines de milliers.
pagination.total_pages Entier ou null.
pagination.next Chaîne ou null. URL de la page suivante, ou null sur la dernière page et pour un identifiant seul.

PaginationLink to Pagination

Chaque page contient 10 articles. Pour electron, pagination.next vaut https://arxiv.org/search/?searchtype=all&query=electron&start=10. Rappelez l'endpoint avec page=2. Les identifiants d'une page sont uniques et la page 2 ne répète pas la page 1. next est null seulement s'il n'y a plus de page. Une requête d'identifiant renvoie cette fiche et next est null.

Use casesLink to Use cases

  • Un cahier de labo lance au:einstein chaque matin et garde les arxiv_id pour l'endpoint paper.
  • Un club de lecture pagine query=electron et conserve pdf_url. Le total d'un mot-clé large est élevé : suivez pagination.next jusqu'à null.
  • Un outil de citation envoie 2201.00978 et lit journal_ref quand le preprint a une version publiée.

Error codesLink to Error codes

Name Detail
400 Query absente, hôte autre qu'arxiv.org, ou URL d'article envoyée à search.
404 Aucun article.
401 Clé API absente.
500 L'appel arXiv a échoué.

API associées

Étendez vos capacités data avec ces outils complémentaires.

Prêt à commencer ?

Votre API de scraping web est à un clic. Commencez avec +500 crédits, sans infrastructure à gérer, sans proxies à configurer, et sans carte bancaire.

  • +500 crédits
  • Aucune carte bancaire requise
  • Tous les endpoints inclus