Exportaciones
Extracciones masivas para volúmenes que sería irrazonable recorrer por páginas. Una exportación es asíncrona: la pides, la construimos y recoges el archivo cuando está listo.
/v1/api/exportsexports:createListar exportaciones
Exportaciones recientes de tu organización, de la más nueva a la más antigua.
Solo estados. Los enlaces de descarga no se incluyen aquí: generar uno por fila firmaría una URL para cada exportación que hayas hecho nunca, en una llamada de la que probablemente solo querías estados. Pide la exportación concreta para obtener un enlace.
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:createSolicitar una exportación
Pon en cola una extracción masiva del catálogo.
Acepta los mismos filtros que el endpoint de listado. Devuelve de inmediato una exportación pendiente; suscríbete a export.completed en lugar de consultar en bucle. Ten en cuenta que un conjunto de campos reducido puede no ser reversible: volver a meter una exportación en una importación necesita las columnas que exige una importación, entre ellas external_id y type, así que omite campos para analizar, no para reimportar.
Campos del cuerpo
| Nombre | Tipo | Descripción |
|---|---|---|
formatobligatorio | enum | Formato de salida. Parquet aparece nombrado en el esquema y no está implementado; pedirlo se rechaza en lugar de responderse con un archivo corrupto. ndjson | csv ejemplo: ndjson |
filters | object | Las mismas claves que acepta el endpoint de listado. ejemplo: {"property_type": "apartment", "price_max": 60000000} |
fields | array | Restringe las columnas. Omítelo para la ficha completa. ejemplo: ["id", "title", "price", "address"] |
Cuerpo de la petición
{
"format": "ndjson",
"filters": { "city": "Berlin", "status": "active" },
"fields": ["external_id", "price", "living_area_sqm", "address_city"]
}Respuesta
{
"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:createObtener una exportación
Estado, y la URL de descarga una vez esté lista.
Las URL de descarga van firmadas y caducan una hora después de emitirse, y se generan en cada petición en lugar de almacenarse, así que vuelve a pedirla si una expira. El archivo se conserva siete días; después la exportación sigue apareciendo en tu historial sin enlace, porque el objeto ya se ha barrido.
Parámetros de ruta
| Nombre | Tipo | Descripción |
|---|---|---|
export_idobligatorio | string | Identificador de la exportación. ejemplo: exp_74c0ab |
Respuesta
{
"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_…