Utiliser l’API d’Airtable : Guide Complet (2025)

Airtable est bien plus qu’un simple tableur : son API permet d’interagir avec vos bases de données et d’automatiser de nombreux processus. Que ce soit pour récupérer, ajouter, mettre à jour ou supprimer des enregistrements, l’API d’Airtable offre une flexibilité précieuse pour les intégrations et automatisations.

Depuis le 1er février 2024, les clés d’API classiques ont été remplacées par des jetons d’accès personnels (PATs) et OAuth 2.0. Si vous utilisiez une clé API, générez un jeton d’accès ici pour continuer à utiliser l’API.

Dans cet article, nous détaillons comment exploiter pleinement l’API d’Airtable, les différentes méthodes disponibles et leurs cas d’usage.

‍

‍

#1 La structure de l'API d'Airtable

Airtable propose deux API principales, chacune répondant à des besoins spécifiques :

‍

📌 API REST (Standard API)

👉 Permet d’interagir avec les données stockées dans une base Airtable.

‍

Actions possibles :

✅ Récupérer des enregistrements

✅ Ajouter de nouveaux enregistrements

✅ Mettre à jour des enregistrements existants

✅ Supprimer des enregistrements

‍

‍

📌 API Metadata

👉 Permet d’accéder aux informations sur la structure d’une base (schéma, permissions…).

‍

Actions possibles :

✅ Lister toutes les bases accessibles

✅ Obtenir la structure des tables, champs et types de données

✅ Connaître les niveaux de permission

Quelle API utiliser ?

🔹 Si vous voulez manipuler des données (ajout, modification, suppression, récupération) → API REST

🔹 Si vous avez besoin d’explorer la structure d’une base (types de champs, permissions, vues…) → API Metadata

‍

‍

2. L’API REST d’Airtable : comment l’utiliser ?

L’API REST permet d’envoyer et de récupérer des données dans vos bases Airtable via des requêtes HTTP.

📌 Accéder à la documentation interactive

Airtable propose une documentation dynamique et personnalisée pour chaque base. Pour la consulter :

1️⃣ Ouvrez votre base Airtable.

2️⃣ Cliquez sur “Aide” en haut à droite.

3️⃣ Faites défiler la liste et sélectionnez “API Documentation”.

Vous y trouverez des exemples de requêtes adaptés à votre base, simplifiant la mise en place de vos intégrations.

‍

📌 Exemples de requêtes avec l’API REST

‍

Récupérer tous les enregistrements d’une table :

GET https://api.airtable.com/v0/YOUR_BASE_ID/YOUR_TABLE_NAME

‍

Ajoutez l’authentification avec un jeton d’accès personnel :

curl -H "Authorization: Bearer YOUR_PERSONAL_ACCESS_TOKEN" \
    https://api.airtable.com/v0/YOUR_BASE_ID/YOUR_TABLE_NAME

‍

Créer un nouvel enregistrement :

POST https://api.airtable.com/v0/YOUR_BASE_ID/YOUR_TABLE_NAME
Content-Type: application/json
Authorization: Bearer YOUR_PERSONAL_ACCESS_TOKEN

{
 "fields": {
   "Nom": "Jean Dupont",
   "Email": "jean.dupont@example.com"
 }
}

‍

Mettre à jour un enregistrement :

PATCH https://api.airtable.com/v0/YOUR_BASE_ID/YOUR_TABLE_NAME/RECORD_ID
Content-Type: application/json
Authorization: Bearer YOUR_PERSONAL_ACCESS_TOKEN

{
 "fields": {
   "Statut": "En cours"
 }
}

‍

Supprimer un enregistrement :

DELETE https://api.airtable.com/v0/YOUR_BASE_ID/YOUR_TABLE_NAME/RECORD_ID
Authorization: Bearer YOUR_PERSONAL_ACCESS_TOKEN

‍

‍

📌 Limites de l’API REST

🚨 5 requêtes par seconde et par base. En cas de dépassement, vous recevrez une erreur 429 et devrez attendre 30 secondes.

🚨 L’API REST ne permet pas d’obtenir des informations sur la structure des bases (types de champs, permissions…). Pour cela, utilisez l’API Metadata.

‍

‍

3. L’API Metadata d’Airtable : analyser la structure d’une base

L’API Metadata est utile pour récupérer des informations sur les bases, tables et champs, facilitant l’intégration et l’automatisation avancées.

📌 Exemples de requêtes avec l’API Metadata

GET https://api.airtable.com/v0/meta/bases
Authorization: Bearer YOUR_PERSONAL_ACCESS_TOKEN

‍

Obtenir le schéma des tables et champs d’une base

GET https://api.airtable.com/v0/meta/bases/YOUR_BASE_ID/tables
Authorization: Bearer YOUR_PERSONAL_ACCESS_TOKEN

‍

‍

‍

4. Authentification API : Jetons d’accès et OAuth 2.0

Depuis février 2024, Airtable n’accepte plus les anciennes clés d’API. Vous devez utiliser l’une des nouvelles méthodes d’authentification :

✅ Option 1 : Jetons d’Accès Personnels (PATs)

• Idéal pour les intégrations simples

• Facile à générer depuis ce lien

• Permet de gérer des permissions par base

Exemple d’authentification avec un PAT :

curl -H "Authorization: Bearer YOUR_PERSONAL_ACCESS_TOKEN" \
    https://api.airtable.com/v0/YOUR_BASE_ID/YOUR_TABLE_NAME

‍

✅ Option 2 : OAuth 2.0

• Obligatoire pour les applications publiques et multi-utilisateurs

• Plus sécurisé que les jetons personnels

• Documentation détaillée disponible sur le site d’Airtable