Exporte
Massenauszüge für Mengen, die seitenweise durchzugehen unvernünftig wäre. Ein Export läuft asynchron: Sie fordern ihn an, wir bauen ihn, und Sie holen die Datei, wenn sie fertig ist.
/v1/api/exportsexports:createExporte auflisten
Letzte Exporte Ihrer Organisation, neueste zuerst.
Nur Status. Downloadlinks sind hier nicht enthalten: einen je Zeile zu erzeugen hieße, für jeden je erstellten Export eine URL zu signieren, bei einem Aufruf, von dem Sie vermutlich Status wollten. Holen Sie den Export selbst, um einen Link zu erhalten.
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:createEinen Export anfordern
Einen Massenauszug des Bestands in die Warteschlange stellen.
Nimmt dieselben Filter wie der Listen-Endpunkt. Kommt sofort mit einem ausstehenden Export zurück; abonnieren Sie export.completed, statt abzufragen. Beachten Sie, dass ein eingeschränkter Feldsatz nicht unbedingt zurückläuft: Einen Export in einen Import zurückzuspeisen braucht die Spalten, die ein Import verlangt, darunter external_id und type. Lassen Sie Felder also für Auswertungen weg, nicht für einen erneuten Import.
Felder im Rumpf
| Name | Typ | Beschreibung |
|---|---|---|
formaterforderlich | enum | Ausgabeformat. Parquet ist im Schema benannt und nicht umgesetzt; danach zu fragen wird abgelehnt, statt mit einer beschädigten Datei beantwortet zu werden. ndjson | csv Beispiel: ndjson |
filters | object | Dieselben Schlüssel, die der Listen-Endpunkt annimmt. Beispiel: {"property_type": "apartment", "price_max": 60000000} |
fields | array | Spalten einschränken. Für den vollständigen Datensatz weglassen. Beispiel: ["id", "title", "price", "address"] |
Rumpf der Anfrage
{
"format": "ndjson",
"filters": { "city": "Berlin", "status": "active" },
"fields": ["external_id", "price", "living_area_sqm", "address_city"]
}Antwort
{
"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:createEinen Export abrufen
Status, und die Download-URL, sobald er bereit ist.
Download-URLs sind signiert, verfallen eine Stunde nach Ausgabe und werden je Anfrage erzeugt statt gespeichert; fragen Sie also erneut, wenn eine abläuft. Die Datei selbst wird sieben Tage aufbewahrt; danach erscheint der Export weiterhin in Ihrem Verlauf, ohne Link, weil das Objekt entfernt wurde.
Pfadparameter
| Name | Typ | Beschreibung |
|---|---|---|
export_iderforderlich | string | Exportkennung. Beispiel: exp_74c0ab |
Antwort
{
"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_…