Vil I vise jeres SaysScore og anmeldelser i jeres eget design eller system, kan I hente dem med API'et. Det er REST og JSON, og disse kald kræver ingen nøgle.
Score og fordeling
GET https://api.trustsays.com/v1/companies/jeresfirma.dk
Svaret indeholder blandt andet:
- saysScore: jeres SaysScore.
- reviewCount: antal anmeldelser.
- distribution: antal anmeldelser med 1 til 5 stjerner.
Anmeldelser
GET https://api.trustsays.com/v1/companies/jeresfirma.dk/reviews
Svaret kommer i sider med 10 anmeldelser. Vælg side med page. Svaret fortæller også det samlede antal og antal sider. I kan filtrere med:
- stars: fx 4,5 for kun 4 og 5 stjerner.
- lang: anmeldelsens sprog, fx da.
- country: landet, fx DK.
- verified=true: kun verificerede køb.
- replied=true: kun anmeldelser med svar.
- sort: newest, helpful, rating_desc eller rating_asc.
Godt at vide
- Kald API'et fra jeres server. Det kan ikke kaldes direkte fra en browser på et andet domæne.
- Svarene bliver gemt i op til 60 sekunder, så nye anmeldelser kan være et minut om at dukke op. Hent ikke oftere end nødvendigt.
- Der findes endnu ingen SDK'er og ingen offentlig dokumentation. Se eksempler på API og udviklere.
- Svar fra jeres eget kundeserviceværktøj og emner via API kommer senere.
Hvis det ikke virker
- 404: Domænet findes ikke på TrustSays. Brug domænet uden https og www.
- Vil I bare vise stjernerne, er en widget nemmere. Se Sæt stjernerne på hjemmesiden.