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.
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"
| 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. |
| 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. |
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.
- 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.
| 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é. |