Trustpilots API:er – Riktlinjer för integration av företagsomdömen

Version 2.7, november 2020

Vill du bygga en integration eller en anpassad widget som visar din företagsomdömesdata? Våra integrationsriktlinjerna hjälper dig att implementera innehållet och använda Trustpilots logotyp och bilder på rätt sätt. Läs mer om dem här. 

Viktigt! Dessa riktlinjer gäller alla som har tillåtelse att använda våra API:er. Trustpilot förbehåller sig rätten att återkalla din API-åtkomst om du bryter mot dem. Om du vill vara säker på att du visar data som alltid är i linje med våra riktlinjer rekommenderar vi att du använder en av våra TrustBoxar.

Innehållskrav

Det är viktigt att du följer Trustpilots innehållskrav när du använder våra API:er. Här är några tips:

Du ska

  • Lagra din data till ditt eget backend-system, så att du kan visa omdömen eller betyg på din webbplats.
  • Visa ditt sammanlagda betyg antingen i form av ett stjärnbetyg (bild), TrustScore (siffra) eller en stjärnsymbol (text).
  • Visa ditt totala antal omdömen.
  • Indikera vilka omdömen du visar i en widget på dessa sätt: 
    • Om alla omdömen visas, visa texten "Våra senaste omdömen".
    • Om du visar omdömen efter stjärnbetyg, ska du ändra texten till "Våra X- och X-stjärniga omdömen" baserat på vilka stjärnbetyg som du valt. Till exempel, om du bara visar 5-stjärniga omdömen, visa texten "Våra 5-stjärniga omdömen".
    • Om du visar dina favoritomdömen eller taggade omdömen, visa texten "Våra favoritomdömen".
  • Länka till Trustpilot så att dina kunder kan gå in och läsa dina omdömen i sin helhet.

Du ska inte

  • Redigera ett omdömes innehåll, inkl. TrustScore, text, författare, datum, etc.
  • Visa känsliga uppgifter, såsom dina kunders e-mailadresser eller referensnummer.
  • Visa information på ett kränkande eller ärekränkande, oanständigt, illvilligt eller diskriminerande sätt.
  • Indexera omdömen för att få Rich Snippets, eller visa dem som om de vore ditt eget innehåll.
  • Dela din API-nyckel med tredjeparter som inte har att göra med din API-utveckling.

Obs: Du behöver inte visa din kategoriranking, men om du gör det måste du se till att den är korrekt.

Här är en genomgång av vår terminologi: 

Exempel på ett Trustpilot-betyg med en förklaring av terminologin

Så här visar du din sammanlagda TrustScore på rätt sätt:

Korrekt visning av en TrustScore

SEO-krav

Följ Trustpilots SEO-krav för att undvika duplicerat innehåll och försämrad placering i sökresultat.

Du ska

  • Läsa in datan dynamiskt med JavaScript från en sajt där robots.txt-filen hindrar sökmotorer från att genomsöka JavaScriptet. T.ex. genom att läsa in klientsidan dynamiskt via Trustpilots API:er på developers.trustpilot.com.
  • Använda en Iframe som inte kan genomsökas av sökmotorer. Du kan t.ex. lägga till "no-index" till din Iframe, eller fjärrinläsa dess innehåll från en webbsida där robots.txt-filen hindrar sökmotorer från genomsöka det.

Du ska inte

  • Inkludera Trustpilot-omdömen direkt i din källkod.
  • Märka upp din TrustScore för att få Rich Snippet-stjärnor på din egna webbplats. Du kan läsa mer om detta i vårt blogginlägg (på engelska) om vad Googles ändringar innebär för Trustpilots kunder.

Varumärkeskrav

Trustpilots varumärkeskrav hjälper till att öka trovärdigheten för dina omdömen, eftersom de bekräftar att omdömena kommer från en pålitlig, oberoende tredjepartskälla.

Du ska

  • Inkludera minst en Trustpilot-logotyp på varje sida som visar omdömen eller betyg.
  • Placera logotypen nära TrustScoren eller omdömena.

Du ska inte

  • Visa omdömesinnehållet som om det vore ditt eget, utan att nämna Trustpilot.

Läs vår stilguide för att lära dig mer om hur Trustpilots logotyp och stjärnbilder ska visas.

Så här visar du Trustpilots logotyp på rätt sätt:

Korrekt visning av Trustpilot-omdömen

Exempel på hur våra partners kan referera till Trustpilot när de visar sina omdömen:

Korrekt visning av Trustpilot-logotypen

API-dokumentation

Nu när du har läst våra riktlinjer är du redo att bygga din API-integration med Trustpilot. Vår API-dokumentation innehåller allt din utvecklare behöver veta.