OE Trust Pilot

This app will provide Trust Pilot scores and review counts for OE businesses in JSON format via an API. This information is all publically available via their Business Units API. This app periodically fetches the data and caches it so we can avoid rate limiting.

Usage

Perform a GET request to the following URL

https://oe-trust-pilot.vercel.app/api/BUSINESS_ACRONYM

Here's a list of currently supported business acronyms:

  • oegb

  • oede

  • oev

  • oeit

  • oees

  • oefr

  • oeus

For example, a GET request to the following URL:

https://oe-trust-pilot.vercel.app/api/oegb

Will return the following JSON response:

{
  "id": "56cd6cf20000ff000589530c",
  "displayName": "Octopus Energy",
  "country": "GB",
  "score": {
    "stars": 5,
    "trustScore": 4.8
  },
  "numberOfReviews": {
    "total": 229803,
    "usedForTrustScoreCalculation": 211171,
    "oneStar": 7528,
    "twoStars": 1490,
    "threeStars": 2376,
    "fourStars": 12943,
    "fiveStars": 205466
  },
  "updatedAtUTC": "2024-02-05T12:56:12.960Z",
  "acronym": "oegb"
}

Adding Reviews to the response

To add the 20 most recent 5 star reviews to the response, you can do a GET request to:

https://oe-trust-pilot.vercel.app/api/oegb?with-reviews=true

This will return the following JSON response:

{
  "id": "56cd6cf20000ff000589530c",
  "displayName": "Octopus Energy",
  "country": "GB",
  "score": {
    "stars": 5,
    "trustScore": 4.8
  },
  "numberOfReviews": {
    "total": 229803,
    "usedForTrustScoreCalculation": 211171,
    "oneStar": 7528,
    "twoStars": 1490,
    "threeStars": 2376,
    "fourStars": 12943,
    "fiveStars": 205466
  },
  "updatedAtUTC": "2024-02-05T12:56:12.960Z",
  "acronym": "oegb",
  "reviews": [
    {
      "id": "67af258d22fb70beabb1c38c",
      "consumer": {
        "name": "",
        "id": "52751cd90000640001533df3"
      },
      "businessUnit": {
        "id": "56cd6cf20000ff000589530c"
      },
      "location": null,
      "stars": 5,
      "title": "Ashley N was very helpful and was able…",
      "text": "The text of the review",
      "language": "en",
      "createdAt": "2025-02-14T13:14:21Z",
      "experiencedAt": "2025-02-14T00:00:00Z",
      "updatedAt": null,
      "isVerified": true
    }
  ]
}