Exports
Extractions en masse pour des volumes qu'il serait déraisonnable de parcourir page par page. Un export est asynchrone : vous le demandez, nous le construisons, et vous récupérez le fichier quand il est prêt.
/v1/api/exportsexports:createLister les exports
Exports récents de votre organisation, du plus récent au plus ancien.
Statuts uniquement. Les liens de téléchargement n'y figurent pas : en générer un par ligne signerait une URL pour chaque export que vous avez jamais fait, sur un appel dont vous vouliez probablement seulement les statuts. Demandez l'export lui-même pour obtenir un lien.
https://api.skautik.com/v1/api/exports
GET /v1/api/exports HTTP/1.1
Host: api.skautik.com
Authorization: Bearer sk_live_…/v1/api/exportsexports:createDemander un export
Mettez en file une extraction en masse du catalogue.
Accepte les mêmes filtres que l'endpoint de liste. Renvoie immédiatement un export en attente ; abonnez-vous à export.completed plutôt que d'interroger en boucle. Notez qu'un jeu de champs restreint peut ne pas faire l'aller-retour : réinjecter un export dans un import demande les colonnes qu'un import exige, dont external_id et type, alors omettez des champs pour l'analyse et non pour un réimport.
Champs du corps
| Nom | Type | Description |
|---|---|---|
formatobligatoire | enum | Format de sortie. Parquet est nommé dans le schéma et n'est pas implémenté ; le demander est refusé plutôt que suivi d'un fichier corrompu. ndjson | csv exemple : ndjson |
filters | object | Les mêmes clés que celles acceptées par l'endpoint de liste. exemple : {"property_type": "apartment", "price_max": 60000000} |
fields | array | Restreindre les colonnes. À omettre pour la fiche complète. exemple : ["id", "title", "price", "address"] |
Corps de la requête
{
"format": "ndjson",
"filters": { "city": "Berlin", "status": "active" },
"fields": ["external_id", "price", "living_area_sqm", "address_city"]
}Réponse
{
"data": {
"id": "exp_74c0ab",
"status": "pending",
"format": "ndjson",
"created_at": "2026-08-12T10:04:00Z"
}
}https://api.skautik.com/v1/api/exports
POST /v1/api/exports HTTP/1.1
Host: api.skautik.com
Authorization: Bearer sk_live_…
Content-Type: application/json
{
"format": "ndjson",
"filters": { "city": "Berlin", "status": "active" },
"fields": ["external_id", "price", "living_area_sqm", "address_city"]
}/v1/api/exports/{export_id}exports:createRécupérer un export
Statut, et l'URL de téléchargement une fois prêt.
Les URL de téléchargement sont signées et expirent une heure après leur émission ; elles sont générées à chaque requête plutôt que stockées, redemandez-en donc une si elle expire. Le fichier lui-même est conservé sept jours ; après quoi l'export figure toujours dans votre historique sans lien, l'objet ayant été balayé.
Paramètres de chemin
| Nom | Type | Description |
|---|---|---|
export_idobligatoire | string | Identifiant de l'export. exemple : exp_74c0ab |
Réponse
{
"data": {
"id": "exp_74c0ab",
"status": "completed",
"format": "ndjson",
"record_count": 1284,
"byte_size": 4821004,
"download_url": "https://exports.skautik.com/exp_74c0ab.ndjson?sig=…",
"expires_at": "2026-08-12T11:12:00Z"
}
}https://api.skautik.com/v1/api/exports/{export_id}
GET /v1/api/exports/exp_74c0ab HTTP/1.1
Host: api.skautik.com
Authorization: Bearer sk_live_…