Documentation de l’API de calenda

01. L’API de Calenda en résumé

À qui s’adresse l’API de Calenda et que peut-on faire avec ?

L’API de Calenda peut être interrogée librement par toute personne ou institution cherchant des événements selon des filtres précis. Elle permet de faire des recherches avancées pour :

  • Effectuer une veille en Intégrant des événements dans vos agendas numériques, 
  • Afficher sur votre site Internet un flux d’événements sélectionnés en fonction de critères ciblés : par exemple, tous les événements ayant lieu au Campus Condorcet
  • Mener des recherches sur des problématisations propres à un champ de connaissance.

L’API de Calenda permet de récupérer les informations des événements sous forme de flux RSS ou Atom, de format intégrable à un calendrier (Ical) ou bien en Json.

Avec l’API de Calenda, il est possible de :

  • Faire des requêtes avancées : OR AND et NOT (le moteur de recherche de Calenda ne propose que l’opérateur OU)
  • Chercher des événements en fonction de mots présents dans un champ précis
  • Chercher des événements par leur localisation plus précise que sur le moteur de recherche de Calenda (niveau le plus fin : la ville) + recherche avec geonames
  • Chercher des événements par source de l’annonce (nom ou prénom ou adresse email)
  • Chercher des événements par date de publication, de mise à jour, de l’événement

Par exemple : Les annonces de la catégorie sociologie se déroulant à Lyon sauf celles du type Bourses et emploi ou Les annonces publiées en histoire et dont la source possède une adresse e-mail se terminant par @ehess.fr

Retour au sommaire

02. Comment interroger l’API de Calenda ?

Les requêtes peuvent se faire selon deux méthodes : 

Utiliser le générateur de requête 

Un générateur de requête est disponible en ligne.

Il permet de sélectionner des filtres et de renseigner les informations correspondant à votre besoin.

NB : certains champs ne sont pas entièrement à jour. Si ce dont vous avez besoin n’y figure pas, nous vous conseillons d’essayer avec la seconde méthode.

Construire une URL avec les paramètres et les variables souhaités.

Les requêtes dites « simples »

Une requête sur l’API de Calenda se fait sous la forme :

https://calenda.org/api/calendar.php?paramètre=valeur&paramètre=valeur

Par exemple, pour obtenir un flux RSS des derniers événements en sociologie se déroulant à Montpellier, il suffira d’utiliser l’URL suivante : 

http://calenda.org/api/calendar.php?place=Montpellier&category=201&alt=rss

Dans cette URL, nous avons un premier paramètre “place” avec comme valeur “Montpellier”. Il signifie que nous cherchons les événements ayant lieu à Montpellier.

Le second paramètre est “category” avec la valeur “201” qui correspond dans le thesaurus d’OpenEdition à la catégorie Histoire de l’art. Enfin, le paramètre “alt” avec la valeur “rss” indique que vous souhaitez obtenir un flux au format RSS.

La suite de la documentation décrit les différentes données pouvant être interrogées. 

Les requêtes dites « avancées »

Les requêtes avancées impliquent l’utilisation d’opérateurs bouléens : OR, AND, NOT

Une requête avancée se fait à l’aide du paramètre query, sous la forme :

https://calenda.org/api/calendar.php?query=paramètre:valeur operateur paramètre:valeur opérateur paramètre:valeur 

Dans une requête avancée, le symbole « = » doit être remplacé par « : »

Un exemple : je souhaite récupérer les annonces associées à l’EHESS OU les annonces de la catégorie sociologie se déroulant à Lyon SAUF celles du type “Bourses, prix et emploi”. La requête donnera : 

http://calenda.org/api/calendar.php?query=(partner:52 OR (category:201 AND place:*Lyon* NOT type:8))

Retour au sommaire

03. Quelles sont les requêtes possibles ?

Requête par type et catégorie d’événements

DonnéeParamètreValeurExemple de requête
type d’événementtype=>Voir la liste des identifiants pour les types d’événementsRécupérer tous les colloques et cycles de conférences : http://calenda.org/api/calendar.php?type=2,9
2  correspond aux colloques, 9 aux cycles de conférences.
catégorie et sous-catégories de l’événement
category=
Pour inclure les événements appartenant aux sous-catégories de la catégorie demandée, ajouter le paramètre suivant : withsubcategories=true
Voir la liste des identifiants pour les catégories d’événementsRécupérer tous les événements de la catégorie « Histoire culturelle » ou de la catégorie « Histoire sociale » :http://calenda.org/api/calendar.php?category=153,2

Requête par lieu de l’événement

NB: Les champs “Ville”, “Région” et “Pays” du générateur de requête s’appuient sur le répertoire de lieux Geonames, base de données géographiques gratuite et accessible par Internet sous une licence Creative Commons.

DonnéeParamètreValeurExemple de requête
Lieu de l’événement 
Il est possible d’utiliser le signe * à la place d’une partie de la chaîne de caractère recherchée. Par exemple  place=mars*pour Marseille
place=<lieu de l’événement>,<lieu de l’événement>,…
Texte libre.
Récupérer tous les événements se déroulant à Paris, Lille ou Marseille :http://calenda.org/api/calendar.php?place=Marseille,Paris,Lille
Si le nom du lieu est composé de plusieurs mots (exemple: Amérique du Nord), il est nécessaire de le mettre entre guillemets: http://calenda.org/api/calendar.php?place=”Amérique du Nord”
Précisions sur le lieu de l’événementplace_details=<details>,<details>,…
Texte libre.
Récupérer tous les événements se déroulant à l’Université Paul-Valéry de Montpellier : http://calenda.org/api/calendar.php?place=Montpellier&place_details=*Université Paul-Valéry*
Adresse de l’événementplace_address=<address>,<address>,…
Texte libre. Il est nécessaire de mettre l’adresse entre guillemets si on cherche une adresse précise.
Récupérer tous les événements se déroulant au 1 rue Victor Cousin, dans le 5ème arrondissement à Paris : http://calenda.org/api/calendar.php?postalcode=75005&place_address=”1 rue Victor Cousin”
Code postal du lieu où se déroule l’événementpostalcode=<postalcode>,…Récupérer tous les événements se déroulant dans le 16ème arrondissement de Paris : http://calenda.org/api/calendar.php?postalcode=75016
Identifiant de la ville dans la base de données Geonamesplace_id=<id>,…
Le générateur de requêtes permet de retrouver facilement quel identifiant correspondant à une ville donnée.
Voir également la liste des identifiants Geonames
Récupérer tous les événements se déroulant à Londres, Royaume-Uni (identifiant Geonames: 2643743) : http://calenda.org/api/calendar.php?place_id=2643743
Identifiant de la région dans la base de données Geonamesregion_id=<id>,…Le générateur de requêtes permet de retrouver facilement quel identifiant correspondant à une région donnée.
Voir également la liste des identifiants Geonames
Récupérer tous les événements se déroulant dans le district de Columbia aux Etats-Unis (ID Geonames 4138106) :http://calenda.org/api/calendar.php?region_id=4138106
Identifiant du pays dans la base de données Geonamescountry_id=<id>,… Le générateur de requêtes permet de retrouver facilement quel identifiant correspondant à un pays donné.
Voir également la liste des identifiants Geonames
Récupérer tous les événements se déroulant au Brésil (ID Geonames 3469034)
http://calenda.org/api/calendar.php?country_id=3469034

Requête par source de l’annonce

DonnéeParamètreValeurExemple de requête
nom complet de la source (nom de famille, prénom, ou e-mail) 
Wild card *
author=<author>,<author>,…Récupérer tous les événements proposés par Éric Duchemin ou Pierre Mercklé :http://calenda.org/api/calendar.php?author=Éric Duchemin,Pierre Mercklé
prénom de la source 
Wild card *
author_firstname=<author_firstname>,<author_firstname>,…Récupérer tous les événements proposés par Jean Lamarre ou Catherine Lamarre : http://calenda.org/api/calendar.php?author=Lamarre&author_firstname=Catherine,Jean
e-mail de la source 
Wild card *
author_email=<email>,<email>,…Récupérer tous les événements proposés par des personnes affiliées à l’Université de Provence :http://calenda.org/api/calendar.php ? author_email=*@univ-amu.fr
Partenaire d’où vient la proposition d’annoncepartner=<id>,<id>,…<id>,<id>,…
Voir la liste des partenaires et identifiants correspondants
Récupérer tous les événements proposés par le partenaire Liens-Socio : http://calenda.org/api/calendar.php?partner=49

Requête par langue de l’annonce

DonnéeParamètreValeurExemple de requête
Langue principale de l’annonce. Code à la norme ISO 639-1lang_main=<code_langue>,…
Voir la liste officielle des codes langues ISO 639-1
Toutes les annonces dont la langue principale est le  portugais : http://calenda.org/api/calendar.php?lang_main=pt
Langue secondaire de l’annonce. Code à la norme ISO 639-1lang_sec=<code_langue>,… 
Voir la liste officielle des codes langues ISO 639-1
Toutes les annonces dont la langue secondaire est l’anglais : http://calenda.org/api/calendar.php?ang_main=en

Requête par contenu de l’annonce

DonnéeParamètreValeurExemple de requête
Titre de l’annoncetitle=<title>Récupérer toutes les annonces dont le titre contient « Bourdieu » : http://calenda.org/api/calendar.php?title=Bourdieu
Résumé de l’annoncesummary=<summary>Récupérer toutes les annonces dont le résumé contient « mouvements sociaux » : http://calenda.org/api/calendar.php?summary=%22mouvements%20sociaux%22
Texte de l’annoncecontent=<content>Récupérer toutes les annonces dont le texte contient « Plan urbanisme construction architecture » : http://calenda.org/api/calendar.php?content=%22Plan%20urbanisme%20construction%20architecture%22

Requête par date

Les valeurs utilisées dans les champs dates sont décodées par la fonction php strtotime(), ce qui autorise l’utilisation des intervalles de temps.

ex. : « +1 month », « 2009-02-01 », « -3 days », « next sunday », « now », « today »…

DonnéeParamètreValeurExemple
date minimum de publication de l’annoncepublished-min=<date>Récupérer toutes les annonces publiées depuis hier : http://calenda.org/api/calendar.php?published-min=yesterday
date maximum de publication de l’annoncepublished-max=<date>Récupérer toutes les annonces qui ont été publiées jusqu’au 25 mai 2010 : http://calenda.org/api/calendar.php?published-max=2010-05-25
Date minimum de mise à jour de l’annonceupdated-min=<date> 
Date maximum de mise à jour de l’annonceupdated-max=<date> 
date minimum de l’événementstart-min=<date>Récupérer tous les événements commençant dans deux jours ou plus : http://calenda.org/api/calendar.php?start-min=+2 days
date maximum de l’événementstart-max=<date>Récupérer tous les événements commençant dans 3 mois ou moins : http://calenda.org/api/calendar.php?start-max=+3 months

Exemples de requêtes

Flux souhaitéRequête correspondante
Les derniers cycles de conférences de la catégorie « pensée » (id 25)https://calenda.org/api/calendar.php?type=9&category=25
Les appels à contribution et offres de bourses, prix et emploi en sociologie du travail (id 91) avec une date limite dans les 30 jours qui suiventhttps://calenda.org/api/calendar.php?type=1,8&category=91&start-min=today&start-max=+30 days&orderby=start&sortorder=asc
Les derniers colloques et journées d’études en sociologie urbaine (234) et études urbaines (249) https://calenda.org/api/calendar.php?type=2,6&category=234,249
Tous les prochains événements se déroulant à Lyonhttps://calenda.org/api/calendar.php?place=Lyon*&start-min=today&orderby=start&sortorder=asc&singleevents=false
Tous les prochains événements en sociologie (id17) se déroulant à Marseillehttps://calenda.org/api/calendar.php?category=17&place=Marseille*&start-min=today&orderby=start&sortorder=asc
Les événements à venir avec pour partenaire L’EHESS (id partenaire 52) + événements à venir (sauf bourses, prix et emploi) en sociologie à Lyonhttps://calenda.org/api/calendar.php?query=(partner:52 OR (category:17 AND place:Lyon* NOT type:8))&start-min=today&orderby=start&sortorder=asc
Les dernières annonces publiées en études urbaines (249) qui sont aussi en histoire (20)https://calenda.org/api/calendar.php?query=(category:249 AND category:20)
Les annonces dont la source est Pierre Mercklé ou Igor Martinache + celles se déroulant à l’ENS-LSHhttps://calenda.org/api/calendar.php?query=(author:Pierre Mercklé,Igor Martinache OR (place_details:ENS-LSH*))
Les annonces publiées en histoire et dont la source possède une adresse e-mail se terminant par @ehess.frhttps://calenda.org/api/calendar.php?category=20&author_email=*@ehess.fr
Les flux RSS des catégories Afrique (36) et Amérique (37) rassemblés, avec leurs sous-catégorieshttps://calenda.org/api/calendar.php?category=36,37&withsubcategories=true&alt=rss&max-results=10

Retour au sommaire

04. Comment se présentent les résultats des requêtes ?

Plusieurs formats de sortie possibles  

Valeur du paramètreDescriptionType MIME
atomFlux au format atom (valeur par défaut)application/atom+xml
jsonFlux au format Javascript Object Notation (json)application/json
Phps [format obsolète]Sortie au format php (php serialized array)text/plain
rssFlux au format xml RSS 2.0application/xml
icalSortie au format Icalendar (pour les agenda électroniques : google agenda, outlook, lightning…)text/calendar

Organisation du flux envoyé en réponse

DonnéeParamètreValeurExemple
Le nombre maximum d’annonces affichées dans les résultatsmax-results=<nombre>Récupérer la liste des 5 dernières annonces :http://calenda.org/api/calendar.php?max-results=5
Début de l’index (commence à 0) des résultats retournés, utilisable pour de la pagination (défaut : 0)first-index=<nombre>Afficher les annonces à partir de la mille-unième annonce :http://calenda.org/api/calendar.php?first-index=1000  
Ordre des résultatsorderby=<order>published (défaut) : date de publication de l’annonce start : prochaine date de l’événement (ou dernière date si événement passé) Trier les annonces par date de publication de l’annonce : http://calenda.org/api/calendar.php?orderby=published Trier les annonces par date de l’événement : http://calenda.org/api/calendar.php?orderby=start
Sens de tri des résultatsSortorder=<sort>ascending/ascend/asc/adescending/descend/desc/d (défaut)Dernières annonces validées (l’annonce la plus récente apparaît en premier) : http://calenda.org/api/calendar.php?sortorder=ascending published – desc : dernières mises en ligne ~ flux rss (dernières validées en premier)start – asc : événements à venir (ordre calendrier) 
Liste des champs à afficher dans les résultatsFields=<field>,<field>,…Voir Liste des champsCe paramètre n’affecte que les formats Atom et Json. 
Si ce paramètre est omis, les champs par défaut seront retournés.
Si ce paramètre est utilisé, seuls les champs explicitement requis seront retournés.
Indiquer si les événements sur plusieurs dates doivent être répétés (false) ou s’ils doivent inclure toutes les dates en un seul événement (true)défaut : true)Singleevents=<bool>http://calenda.org/api/calendar.php?singleevents=false
Les événements sur 2 jours apparaîtront deux fois dans le flux, les événements sur 3 jours apparaîtront 3 fois, etc.
Exécuter la requête en incluant les sous-catégories (défaut : false)withsubcategories=<bool>La requête http://calenda.org/api/calendar.php?category=17&withsubcategories=true affichera les annonces classées dans la catégorie « Sociologie » ou ses sous-catégories (étude des genres,  sociologie de la culture, etc.)
La requête http://calenda.org/api/calendar.php?category=17&withsubcategories=false affichera les annonces classées en « Sociologie », mais pas celles classées dans les sous-catégories de « Sociologie »
Retourner les événements « À la une » uniquement (défaut : false)Highlights=       <bool> 

Formes des résultats de la requête

DonnéeParamètreValeurs possiblesExemple
Champs à afficher dans les résultatsfields=<field>,<field>,…Voir Liste des champs 
Format de la réponsealt=<format>Liste des valeurs possibles alt=ical renverra un flux au format Ical, qu’on peut intégrer dans des agendas électroniques (Google Agenda, Lightning..)
Langue de restitution des annonces: langue dans laquelle les annonces seront affichées, si cette langue est disponible. Si la langue n’est pas disponible, la langue par défaut sera renvoyée.lang=<lang>Liste des codes langue ISO 639-1lang=en renverra les champs en anglais, s’ils sont disponibles. S’il ne sont pas disponibles en anglais, la langue par défaut sera renvoyée.
Par exemple, pour l’annonce «As Ciências de Polícia nos Finais do Antigo Regime: da teoria às práticas», qui possède le titre alternatif anglais «Police Science at the End of the Old Regime. From theory to practice» ainsi qu’une traduction de son résumé en anglais : le titre et le résumé seront affichés en anglais dans le flux, si le paramètre “lang=en” est utilisé. 
En revanche, si aucun paramètre n’est utilisé, ou si le paramètre “lang=pt” est utilisé, le titre et le résumé apparaîtront en portugais, qui est la langue par défaut de l’annonce.
Il est important de noter que les titres et résumés ne sont pas systématiquement traduits, utiliser ce paramètre “lang” peut donc générer des flux mélangeant différentes langues.
Pour obtenir un flux uniquement dans une langue

Debug

DonnéeParamètreValeurExemple
Ajouter des informations de debug dans le flux.
Cela renvoie le flux dans le type MIME “text/plain” (texte brut). 
Au format Atom, cela permet de renvoyer également des informations complémentaires sur la requête faite à la base de données, son temps d’exécution, le niveau d’authentification, et l’adresse IP à partir de laquelle la requête a été effectuée. 
debug=<bool> (true ou false)
Valeur par défaut: false
Un flux ICAL des dernières annonces à la une, en mode debug : https://calenda.org/api/calendar.php?highlights=true&alt=ical&debug=true
Un flux Atom d’une catégorie inexistante (48898866), en mode debug : https://calenda.org/api/calendar.php?category=48898866&debug=true 

Si vous rencontrez des difficultés persistantes lors de l’utilisation de l’API, vous pouvez nous contacter à l’adresse calenda@openedition.org

Pensez à nous fournir des informations détaillées sur la requête que vous essayez d’effectuer, avec les messages d’erreur éventuels que vous avez rencontrés. 

Dans la mesure du possible, pensez également à nous communiquer les informations présentes votre flux en mode debug au format Atom, contenues dans les balises <ca:debug>.

Retour au sommaire

05. Annexes

Liste des champs affichés selon le format de sortie

x = information disponible dans le flux

* = information retournée par défaut

Les formats permettant de récupérer le plus d’informations sont Atom, phps, et json.

Pour récupérer tous les champs disponibles, utiliser le paramètre field=all. Voir la section “Organisation du flux envoyé en réponse” pour plus de détails sur la manière de récupérer les différents champs.

Valeur du paramètreDescriptionAtomRSSIcalphpsjson
ididentifiant unique de l’annonce*x*x*x*x*x*
urladresse url permanente sur Calenda *x*x*x*x*x*
startprochaine date de l’événement (ou dernière date si l’événement est passé) *x*x*x*
titletitre *x*x*x*x*x*
subtitlesous-titre *x*x*x*
summaryrésumé *x*x*x*x*x*
author (author_name, author_email)nom et e-mail de la source *x*x*x*
type (type_id, type_name)id et nom du type *x*x* (nom) x*x*
category (category_id, category_name)id et nom de la catégorie principale *x*x*x*
keywordsmots clés *x*x*x*
place (place, place_details)ville et précision *x*x* (ville)x* (ville)x*x*
validator (validator_name, validator_email)prénom et nom du validateur et son e-mail *x*x*x*x*
publisheddate de publication (format ISO 8601) *x*x*x*x*
partners [id, name]liste des partenaires sélectionnésxxx
files [name, url]liste des fichiersxxx
dates [date]liste des dates *x*x*x*
contacts [name, email, address]liste des contactsxxx
secondary_categories [id, name]liste des catégories secondaires *x*x*x*
updateddate de mise à jour de l’annoncex*xx
lang_mainlangue principale de l’annonce (code ISO 639-1)xxx
lang_seclangue secondaire de l’annonce (code ISO 639-1)xxx

Liste des types Calenda et identifiants correspondants 

TypeNuméro d’identifiant correspondant
Appel à contribution40
Colloque41
Séminaire42
Informations diverses44
Journée d’étude45
Appel d’offres46
Bourse, prix et emploi47
Cycle de conférences48
École d’été*294004

*Les écoles d’été ont été ajoutées à Calenda en 2014, ce type a donc un identifiant différent des premiers types.

Liste des catégories Calenda et identifiants correspondants 

CatégorieNuméro d’identifiant correspondant
1914-1918320
1918-1939321
1939-1945322
1945 – 1989324
1989 à de nos jours323
Afrique328
Afrique australe335
Afrique centrale334
Afrique de l’Est333
Afrique Subsaharienne332
Afrique du nord329
Afrique noire331
Âges de la vie210
Algérie330
Amérique latine337
Amériques336
Anthropologie culturelle215
Anthropologie politique216
Anthropologie religieuse217
Anthropologie sociale214
Approches biographiques287
Approches de corpus, enquêtes, archives297
Archéologie293
Architecture282
Asie344
Asie centrale350
Asie du Sud-Est353
Balkans369
Bas Moyen Âge311
Belgique356
Brésil341
Canada343
Cartographie, imagerie, SIG288
Centre362
Chine349
Cône sud340
Criminologie202
Démographie203
Développement économique237
Digital humanities298
Droit251
Économie236
Économie politique240
Édition électronique272
Éducation283
Égypte ancienne308
Épistémologie290
Épistémologie & histoire de la géographie225
Épistémologie et méthodes286
Époque  moderne312
Époque contemporaine317
Espace, société et territoire226
Espaces327
Esprit et Langage259
Est363
États-Unis342
Ethnologie, anthropologie213
Étude des genres205
Études des sciences254
Études du politique241
Études urbaines258
Études visuelles280
Europe354
Europe centrale et orientale370
Extrême Orient347
France358
Génocides et massacres245
Géographie218
Géographie : politique, culture et représentation227
Géographie appliquée et aménagement219
Géographie rurale223
Géographie urbaine221
Gestion239
Guerres, conflits, violence244
Haut Moyen Âge310
Histoire culturelle277
Histoire de l’Art278
Histoire de l’éducation284
Histoire des femmes233
Histoire des religions301
Histoire des sciences255
Histoire du droit252
Histoire du travail234
Histoire économique229
Histoire économique et sociale228
Histoire et sociologie de la presse274
Histoire et sociologie des médias275
Histoire et sociologie du livre273
Histoire grecque305
Histoire industrielle230
Histoire intellectuelle262
Histoire politique243
Histoire romaine306
Histoire rurale231
Histoire sociale235
Histoire urbaine232
Historiographie291
Identités culturelles281
Îles irlandaises et britanniques372
Information270
Institutions politiques250
Italie366
Japon348
Langage267
Linguistique268
Littératures269
Méditerranée355
Méthodes de traitement et de représentation294
Méthodes qualitatives296
Méthodes quantitatives295
Mexique et Amérique centrale338
Midi364
Migrations, immigrations, minorités220
Monde germanique368
Monde indien351
Monde oriental307
Monde persan352
Mondes russes et soviétiques371
Mouvements politiques et sociaux247
Moyen Âge309
Moyen-Orient346
Nature, paysage et environnement222
Nord361
Océanie374
Ouest360
Patrimoine279
Pays andins339
Pays baltes et scandinaves373
Péninsule ibérique367
Pensée260
Périodes302
Philosophie261
Philosophie des sciences257
Politiques et actions publiques249
Préhistoire304
Préhistoire et antiquité303
Proche-Orient345
Prospectives325
Provence365
Psychanalyse265
Psychisme264
Psychologie266
Région parisienne359
Relations internationales246
Religions299
Représentations276
Révolution française316
Sciences auxiliaires de l’Histoire292
Sciences cognitives263
Sciences de l’éducation285
Sciences de l’information271
Sciences politiques242
Sociétés200
Sociologie201
Sociologie de la consommation207
Sociologie de la culture211
Sociologie de la santé209
Sociologie des religions300
Sociologie des sciences256
Sociologie du droit253
Sociologie du travail204
Sociologie économique212
Sociologie politique248
Sociologie urbaine208
Sport et loisirs206
Suisse357
Systèmes, modélisation, géostatistiques224
Travail, emploi238
Vie de la recherche289
XIXe siècle318
XVIe siècle313
XVIIe siècle314
XVIIIe siècle315
XXe siècle319
XXIe siècle326

Liste des identifiants Geonames

Une liste à jour des pays et de leurs identifiants Geonames, avec des données complémentaires (code ISO, coordonnées géographiques, etc.), est disponible au format txt http://download.geonames.org/export/dump/countryInfo.txt 

Un fichier compressé contenant les données Geonames de tous les pays (y compris villes, régions, etc.) est également disponible au téléchargement à l’adresse suivante : http://download.geonames.org/export/dump/allCountries.zip (fichier compressé > 290 Mo; fichier décompressé > 1,2 Go)

Plusieurs fichiers dump des données Geonames sur les villes sont également disponibles sur le site de Geonames :

Liste des codes langue ISO 639-1

Une liste à jour des codes langues ISO 639-1 est disponible sur le site de la bibliothèque du Congrès, avec leurs codes équivalents à la norme ISO 639-2: https://www.loc.gov/standards/iso639-2/php/code_list.php 

Code langue ISO 639-1Nom de la langue
aaAfar
abAbkhaze
aeAvestique
afAfrikaans
akAkan
amAmharique
anAragonais
arArabe
asAssamais
avAvar
ayAymara
azAzéri
baBachkir
beBiélorusse
bgBulgare
bhBihari
biBichelamar
bmBambara
bnBengali
boTibétain
brBreton
bsBosnien
caCatalan
ceTchétchène
chChamorro
coCorse
crCri
csTchèque
cuVieux-slave
cvTchouvache
cyGallois
daDanois
deAllemand
dvMaldivien
dzDzongkha
eeEwe
elGrec moderne
enAnglais
eoEspéranto
esEspagnol
etEstonien
euBasque
faPersan
ffPeul
fiFinnois
fjFidjien
foFéroïen
frFrançais
fyFrison
gaIrlandais
gdÉcossais
glGalicien
gnGuarani
guGujarati
gvMannois
haHaoussa
heHébreu
hiHindi
hoHiri motu
hrCroate
htCréole haïtien
huHongrois
hyArménien
hzHéréro
iaInterlingua
idIndonésien
ieOccidental
igIgbo
iiYi
ikInupiak
ioIdo
isIslandais
itItalien
iuInuktitut
jaJaponais
jvJavanais
kaGéorgien
kgKikongo
kiKikuyu
kjKuanyama
kkKazakh
klGroenlandais
kmKhmer
knKannada
koCoréen
krKanouri
ksCachemiri
kuKurde
kvKomi
kwCornique
kyKirghiz
laLatin
lbLuxembourgeois
lgGanda
liLimbourgeois
lnLingala
loLao
ltLituanien
luLuba-katanga
lvLetton
mgMalgache
mhMarshallais
miMaori de Nouvelle-Zélande
mkMacédonien
mlMalayalam
mnMongol
moMoldave
mrMarathi
msMalais
mtMaltais
myBirman
naNauruan
nbNorvégien Bokmål
ndSindebele
neNépalais
ngNdonga
nlNéerlandais
nnNorvégien Nynorsk
noNorvégien
nrNrebele
nvNavajo
nyChichewa
ocOccitan
ojOjibwé
omOromo
orOriya
osOssète
paPendjabi
piPali
plPolonais
psPachto
ptPortugais
quQuechua
rmRomanche
rnKirundi
roRoumain
ruRusse
rwKinyarwanda
saSanskrit
scSarde
sdSindhi
seSame du Nord
sgSango
siCingalais
skSlovaque
slSlovène
smSamoan
snShona
soSomali
sqAlbanais
srSerbe
ssSwati
stSotho du Sud
suSoundanais
svSuédois
swSwahili
taTamoul
teTélougou
tgTadjik
thThaï
tiTigrigna
tkTurkmène
tlTagalog
tnTswana
toTongien
trTurc
tsTsonga
ttTatar
twTwi
tyTahitien
ugOuïghour
ukUkrainien
urOurdou
uzOuzbek
veVenda
viVietnamien
voVolapük
waWallon
woWolof
xhXhosa
yiYiddish
yoYoruba
zaZhuang
zhChinois
zuZoulou

Liste des partenaires et identifiants correspondants

Avertissement : Plusieurs partenariats sont obsolètes ou ne sont plus sélectionnés de manière fiable au quotidien de la modération. 

PartenaireIdentifiantDescription
GIS études africaines233058
TEI224195
Université de Provence220731
Liens-socio49
Université d’Aix-Marseille51
Ecole des hautes études en sciences sociales52
Institut des sciences humaines et sociales (CNRS)53
Université d’Avignon et des Pays de Vaucluse54
Université de Nice Sophia Antipolis55
Centre interdisciplinaire d’études et de recherches sur l’Allemagne (CIERA)61

Cette documentation a été initialement rédigée par Jean-Baptiste Bertrad en 2012 puis adaptée, mise à jour et publiée en 2025 par Céline Guilleux. Elle a été relue par Emma Fanget.