Trusted Shops Reviews API

Overview

This API endpoint allows you to retrieve reviews from Trusted Shops. Here are some important things to know:

  • The Trustedshops API returns 20 reviews per request.
  • The order in which reviews are returned is by descending date(from newest to oldest).
  • You can get all reviews from a single place by using the offset parameter.

Endpoint

GET https://wextractor.com/api/v1/reviews/trustedshops

Parameters

Parameter Required Description Example
auth_token Required Your API token for authentication. Once you register to Wextractor you can extract this key from your account's setting page. -
id Required A textual identifier that uniquely identifies a place in Trustedshops. This identifier can be taken from the url of the software in Trustedshops. For example, if the url for the place in Trustedshops is https://www.trustedshops.de/bewertung/info_XE7514EB99116CA91B437017DF7324FAF.html the identifier is XE7514EB99116CA91B437017DF7324FAF XE7514EB99116CA91B437017DF7324FAF
offset Optional This parameter defines the result offset. It skips the given number of reviews. It's used for pagination. (e.g., 0 (default) is the first page of results, 20 is the 2nd page of results, 40 is the 3rd page of results, etc.). 20

Example Request

https://wextractor.com/api/v1/reviews/trustedshops?id=XE7514EB99116CA91B437017DF7324FAF&auth_token=your_auth_token&offset=0

Example Response


{
  "totals": {
    "review_count": 64
  },
  "reviews": [
    {
      "id": "46c6cb42febbca8c6dd9c1d8b7b0755f",
      "text": "einfack einkaufen, snelle lieferung zu Danemark, sch\u00f6n eingepackt.\r\nVielen dank",
      "reviewer": "marianne a.",
      "rating": "5",
      "datetime": "2021-02-02 14:17:00"
    },
    {
      "id": "9eb5080349346f1584c9d1da3ac60341",
      "text": "Ich kaufe praktisch alles f\u00fcr die encaustic nur hier.",
      "reviewer": "",
      "rating": "5",
      "datetime": "2021-02-01 13:05:00"
    },
    {
      "id": "c446d11e6d94f5e11da0ad9f2b319835",
      "text": "Schnell und super wie immer",
      "reviewer": "",
      "rating": "5",
      "datetime": "2021-01-23 15:20:00"
    },
    {
      "id": "10d6cdacdec82518c45819c465da94fa",
      "text": "Sehr schnelle Lieferung, Ware vollst\u00e4ndig und in bester Qualit\u00e4t.  Sehr gerne wieder mit Creativ Point.",
      "reviewer": "Birgit F.",
      "rating": "4",
      "datetime": "2021-01-23 14:00:00"
    },
    {
      "id": "f3e4fd39b19176bb6d9fca6d8e1dfa97",
      "text": "Kaufe gern bei Ihnen. Gute Auswahl. Einwandfreie Ware. Die Anlieferung k\u00f6nnte etwas schneller sein, aber am Ende bin ich immer zufrieden",
      "reviewer": "Martina G.",
      "rating": "4",
      "datetime": "2021-01-23 07:08:00"
    },
    {
      "id": "a27dd13700565b467031dc84d355214a",
      "text": "Lieferung erfolgt prompt. Die Wachse kann ich nur empfehlen",
      "reviewer": "maria g.",
      "rating": "5",
      "datetime": "2021-01-21 10:27:00"
    },
    {
      "id": "fbac3779af73595ef6217efd5b79433f",
      "text": "bin wie immer von der Schnelligkeit und dem Service beindruckt, Danke",
      "reviewer": "",
      "rating": "5",
      "datetime": "2021-01-18 07:38:00"
    },
    {
      "id": "46b2ca1fe12b304315e1c9a4abdc63f8",
      "text": "Eine unwahrscheinlich schnelle Bearbeitung der Bestellung mit zus\u00e4tzlichen tollen Hinweisen.",
      "reviewer": "",
      "rating": "5",
      "datetime": "2021-01-16 18:11:00"
    },
    {
      "id": "11fbbb22a471926fed17454ede1c8900",
      "text": "Die Lieferung wie immer schnell und gut verpackt. Hier bestelle ich sehr gerne",
      "reviewer": "Petra M.",
      "rating": "5",
      "datetime": "2021-01-13 18:05:00"
    },
    {
      "id": "e5ad72f98d097944512ca1fccc9bb5f7",
      "text": "Schnelle Abwicklung, prima Ware.",
      "reviewer": "",
      "rating": "5",
      "datetime": "2021-01-13 14:08:00"
    },
    {
      "id": "8a9264f6e21d12c5238fb3f0fd5f5904",
      "text": "Super geklappt",
      "reviewer": "Wolfgang B.",
      "rating": "5",
      "datetime": "2021-01-13 11:47:00"
    },
    {
      "id": "5c5626bb1ec5afdc80f07115a1de87c8",
      "text": "produkte und lieferung tadellos!",
      "reviewer": "Harald W.",
      "rating": "5",
      "datetime": "2021-01-02 12:14:00"
    },
    {
      "id": "a4e2d86ef073a693f5cb423fc32b64cf",
      "text": "Schnelle und prompte Lieferung!",
      "reviewer": "Ursula M.",
      "rating": "5",
      "datetime": "2020-12-13 11:01:00"
    },
    {
      "id": "7350e888ad177690adf06f297bbf56e9",
      "text": "Bei euch einkaufen macht Spa\u00df. Au\u00dferdem wurde so schnell geliefert, dass ich in Ruhe noch meine Encaustik-Weihnachtskarten gestalten kann.\r\nDanke auch an Frau Strauch, dass sie angerufen hat, weil Sticker in Gold nicht mehr vorr\u00e4tig waren und wir uns problemlos auf Silber einigen konnten.\r\nDanke f\u00fcr das kleine Geschenk.",
      "reviewer": "Helga S.",
      "rating": "5",
      "datetime": "2020-12-06 16:11:00"
    },
    {
      "id": "29658c3f75a2b9d3203b18b794aab5e9",
      "text": "Sehr gute Qualit\u00e4t. Schnelle Lieferung. Einfach perfekt.",
      "reviewer": "Lothar K.",
      "rating": "5",
      "datetime": "2020-11-26 21:06:00"
    },
    {
      "id": "c91487a13022b70661e5ba21c2ce56c6",
      "text": "Alles schnell und super gut gelaufen",
      "reviewer": "",
      "rating": "5",
      "datetime": "2020-11-13 06:52:00"
    },
    {
      "id": "1f1b8ae146f3538d3897cddd89c994c9",
      "text": "Danke f\u00fcr die sehr gute Zusammenarbeit Frau Jaroschinski :-)\r\nSeit ca. 12 Jahren bin ich bei Ihnen Kundin und es ist immer wieder sch\u00f6n Sie und unsere fanstatische Encautic-Akademie Weilheim, Herrn Kussmaul und vor allem der gro\u00dfartigen K\u00fcnstlerin Monika Romer per\u00f6nlich zu begr\u00fc\u00dfen. Bestellungen sind stets bestens bearbeitet und R\u00fcckfragen sehr angenehm gekl\u00e4rt. Allen viel Gesundheit Ilona Kohn",
      "reviewer": "Ilona K.",
      "rating": "5",
      "datetime": "2020-11-08 15:07:00"
    },
    {
      "id": "c1a066ca65a519ba4187f547acbeae2b",
      "text": "Service und Lieferung top",
      "reviewer": "",
      "rating": "5",
      "datetime": "2020-10-30 09:58:00"
    },
    {
      "id": "c46254a5d7e043cf0bd0628ba436a351",
      "text": "Ich bin sehr zufrieden mit dem Einkauf.",
      "reviewer": "Anita K.",
      "rating": "5",
      "datetime": "2020-10-26 11:52:00"
    },
    {
      "id": "ba1a4595308d155c535435a52d90c6c2",
      "text": "Tolle Auswahl",
      "reviewer": "Andrea M.",
      "rating": "5",
      "datetime": "2020-10-12 15:39:00"
    }
  ]
}

Error Codes

Status Code Error Type Description
400 InvalidRequest The request parameters are invalid or missing
401 Unauthorized Invalid or missing API key
403 Forbidden Your account is out of credits
429 RateLimitExceeded You've exceeded the API rate limit(10 requests per second)
500 ServerError An unexpected error occurred on our servers. In these cases we recommend to retry the request for a couple of times. If the error subsists you can reach us to open a ticket.