Open gegevens
Onze cijfers staan open
Elk reviewplatform houdt zijn gegevens achter een aanmelding. Dat heeft een prijs: je kunt niets natrekken, en dus is elk verhaal over betrouwbaarheid iets dat je moet geloven. Bij ons haal je de cijfers zelf op, zonder sleutel en zonder account.
Wat je kunt ophalen
Vier adressen, allemaal met een gewone GET en zonder sleutel. Antwoorden zijn JSON en worden een uur gecacht.
- GET /api/v1/open
- Een beschrijving van deze route, in het antwoord zelf. Documentatie die ergens anders staat loopt achter zodra iemand iets wijzigt; deze loopt mee.
- GET /api/v1/open/stats
- De totalen van het platform: bedrijven, gepubliceerde reviews en hoeveel er na een besluit van een pagina zijn gehaald.
- GET /api/v1/open/companies?page=1
- Alle openbare bedrijven, honderd per bladzijde, met cijfer, aantal reviews, branche en plaats. Op volgorde van aanmelding en niet op cijfer: een ranglijst waarvan wij de volgorde bepalen hoort hier niet.
- GET /api/v1/open/companies/{slug}
- Eén bedrijf, met daarbij wat er van zijn pagina is weggehaald en met welke reden, hoe het met zijn klachten afliep, en hoeveel van zijn uitnodigingen tot een review leidden.
Meteen proberen
curl https://klantreviews.online/api/v1/open/statsWat er niet in staat, en waarom
- Geen reviewteksten. Die staan op de bedrijfspagina en zijn daar te lezen. Ze hier in bulk uitleveren maakt van deze route een manier om een archief van andermans woorden aan te leggen.
- Geen namen van schrijvers en geen adressen. Een naam bij een review is iets anders dan een naam in een bestand dat iedereen kan downloaden.
- Duizend verzoeken per uur per afzender. Ruim voor wie de hele lijst doorbladert, krap genoeg dat één script de dienst niet voor de rest opeet.
- Vrij te gebruiken, ook zakelijk, met bronvermelding naar klantreviews.online. Wij vragen er niets voor en je hoeft je niet te melden.