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

By adding the query parameter with-reviews=true to https://oe-trust-pilot.vercel.app/api/BUSINESS_ACRONYM, the response will include the 20 most recent 5 star reviews for the business unit you are requesting data for, making the response look the following:

{
  "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
    }
  ]
}