Toggle sidebar

Export-endpoint

Met de Export-endpoint download je alle deelnemers en hun antwoorden van één vragenlijst in één CSV-bestand. Ideaal voor periodieke synchronisatie naar een datawarehouse of voor analyses in een spreadsheet.

Endpoint

Methode Pad Beschrijving
GET /api/v1/surveys/{survey}/export Download een CSV-export van alle uitgenodigde en gereageerde deelnemers

Een export ophalen

GET /api/v1/surveys/123/export
Authorization: Bearer <token>
Accept: text/csv

De response is een text/csv-stream. Sla deze op als bestand of stream direct in je verwerkingspijplijn.

Wat zit er in de export?

Per deelnemer een rij met:

  • Bij privé-vragenlijsten: E-mailadres en Uitgenodigd op
  • Gereageerd op
  • Per tag een kolom met de tag-waarde
  • Per vraag een kolom met het antwoord
  • Per vraag met opties (radio, checkbox, etc.) een extra Score-kolom
  • Bij matrix-vragen een aparte kolom per subvraag
  • Bij vragen met optionele toelichting een extra Toelichting-kolom
  • Bij bestand-vragen een download-link in plaats van het bestand zelf

De kolomnaam is standaard de vraagtekst, of de zelf ingestelde Handmatige export header als die is opgegeven.

Rate limiting

Deze endpoint is rate-limited (throttle: exports) om grote exports niet teveel resources te laten gebruiken. Bij overschrijding krijg je een "429 Too Many Requests". Plan exports niet vaker dan strikt nodig - bijvoorbeeld één keer per dag of per uur.

Alleen geverifieerde deelnemers

De export bevat deelnemers met status invited of responded. Niet-geïmporteerde of ongeldige deelnemers (status invalid) komen niet in de export terecht.

Verschillen met handmatige export

De handmatige export (in de admin-omgeving op de tab Deelnemers of Resultaat) gebruikt dezelfde onderliggende code en levert hetzelfde formaat. Het verschil zit puur in de aansturing:

  • Handmatig: een persoon klikt op de download-knop en slaat het bestand op.
  • API: een script of integratie haalt de export op zonder tussenkomst.

Gebruikssituaties

  • Datawarehouse: dagelijkse import van een vragenlijst-export voor langetermijn-analyses.
  • Backup: wekelijkse export voor archief- of compliance-doeleinden.
  • Doorlevering: automatisch doorsturen naar een externe partij die de data verwerkt.
  • Power BI: als alternatief voor directe API-koppeling kun je Power BI naar deze endpoint laten verwijzen.

Veelgestelde vragen

De endpoint exporteert alle deelnemers met status invited of responded. Een filter via query-parameter is niet beschikbaar - voor selectiever ophalen gebruik je de participants-endpoints.

CSV met UTF-8 encoding. Open het in Excel, Numbers, Google Sheets of laad het in een ETL-tool. Bij grote exports wordt het bestand in chunks gestreamd, dus geheugengebruik aan jouw kant blijft beperkt.

Er is geen harde limiet - de stream-aanpak handelt grote vragenlijsten aan. Voor zeer grote vragenlijsten (tienduizenden deelnemers) is het wel verstandig om je eigen verwerking ook streaming te maken.

Een download-link in de CSV. Het bestand zelf moet je apart ophalen via die link (met een geauthenticeerde request).
Blacklist