Go To Top

Resources API

This resource gives navigational links to all the image resources that are available.

GET
Authentication: API Key
https://api.trustpilot.com/v1/resources/images
Parameters
No parameters required
Response
{
  "links": [
    {
      "href": "<Url for the resource>",
      "method": "<Http method for the resource>",
      "rel": "<Description of the relation>"
    }
  ]
}

This resource will output all countries known to Trustpilot, including the name of the country (in English).

GET
Authentication: API Key
https://api.trustpilot.com/v1/resources/metadata/countries
Parameters
locale, Optional String.
Specifies the language in which the 'translatedName' property is returned.
Example: ?locale=en-US

Response
{
  "countries": [
    {
      "locale": "da-DK",
      "country": "DK",
      "englishName": "Denmark",
      "countryId": "1",
      "translatedName": "Danmark"
    }
  ]
}

This resource shows you the different sizes that are available, as well as the URLs for the images. Use this resource to get the Trustpilot stars

GET
Authentication: API Key
https://api.trustpilot.com/v1/resources/images/stars/{stars}
Parameters
stars, Required Integer.
The number of stars to return images for.
Constraints: Allowed values are 0, 1, 2, 3, 4, 5
Example: …/v1/resources/images/stars/4

Response
{
  "image520x96": {
    "url": "//trustpilot.com/image.jpg",
    "width": "400",
    "height": "300"
  },
  "image130x24": {
    "url": "//trustpilot.com/image.jpg",
    "width": "400",
    "height": "300"
  },
  "image260x48": {
    "url": "//trustpilot.com/image.jpg",
    "width": "400",
    "height": "300"
  },
  "stars": 4
}

This resource gives the text representation of the stars used to represent the TrustScore as Text. For example: Excellent

GET
Authentication: API Key
https://api.trustpilot.com/v1/resources/strings/stars/{stars}
Parameters
stars, Required Integer.
The number of stars to return the text representation for.
Constraints: Allowed values are 0, 1, 2, 3, 4, 5
Example: …/v1/resources/strings/stars/4

locale, Required String.
The locale to use for the string.
Example: ?locale=da-DK

Response
{
  "locale": "en-US",
  "string": "Good",
  "stars": 4
}

This resource shows you the different sizes that are available, as well as the URLs for the images. Use this resource to get the Trustpilot icon (checkbox).

GET
Authentication: API Key
https://api.trustpilot.com/v1/resources/images/icons
Parameters
No parameters required
Response
{
  "image100x100": {
    "url": "//trustpilot.com/image.jpg",
    "width": "400",
    "height": "300"
  },
  "image560x560": {
    "url": "//trustpilot.com/image.jpg",
    "width": "400",
    "height": "300"
  },
  "image230x230": {
    "url": "//trustpilot.com/image.jpg",
    "width": "400",
    "height": "300"
  },
  "image40x40": {
    "url": "//trustpilot.com/image.jpg",
    "width": "400",
    "height": "300"
  }
}

This resource shows you the different sizes that are available, as well as the URLs for the images. Use this resource to get the Trustpilot logo.

GET
Authentication: API Key
https://api.trustpilot.com/v1/resources/images/logos
Parameters
No parameters required
Response
{
  "darkBackground": {
    "image120x18": {
      "url": "//trustpilot.com/image.jpg",
      "width": "400",
      "height": "300"
    },
    "image510x57": {
      "url": "//trustpilot.com/image.jpg",
      "width": "400",
      "height": "300"
    },
    "image510x76": {
      "url": "//trustpilot.com/image.jpg",
      "width": "400",
      "height": "300"
    },
    "image255x38": {
      "url": "//trustpilot.com/image.jpg",
      "width": "400",
      "height": "300"
    },
    "image120x14": {
      "url": "//trustpilot.com/image.jpg",
      "width": "400",
      "height": "300"
    },
    "image255x29": {
      "url": "//trustpilot.com/image.jpg",
      "width": "400",
      "height": "300"
    }
  },
  "lightBackground": {
    "image120x18": {
      "url": "//trustpilot.com/image.jpg",
      "width": "400",
      "height": "300"
    },
    "image510x57": {
      "url": "//trustpilot.com/image.jpg",
      "width": "400",
      "height": "300"
    },
    "image510x76": {
      "url": "//trustpilot.com/image.jpg",
      "width": "400",
      "height": "300"
    },
    "image255x38": {
      "url": "//trustpilot.com/image.jpg",
      "width": "400",
      "height": "300"
    },
    "image120x14": {
      "url": "//trustpilot.com/image.jpg",
      "width": "400",
      "height": "300"
    },
    "image255x29": {
      "url": "//trustpilot.com/image.jpg",
      "width": "400",
      "height": "300"
    }
  }
}

This resource will output all supported locales of the Trustpilot system, including URLs to the different Trustpilot sites.

GET
Authentication: API Key
https://api.trustpilot.com/v1/resources/metadata/locales
Parameters
translationLocale, Optional String.
Specifies the language in which the 'translatedName' property is returned.
Example: ?translationLocale=en-US

Response
{
  "defaultLocale": {
    "isDefaultForLanguage": "true",
    "countryId": 1,
    "language": "da",
    "locale": "da-DK",
    "translatedName": "Danish",
    "region": "DK",
    "businessWebApp": "https://da-dk.trustpilot.com/",
    "consumerWebApp": "http://www.trustpilot.dk/",
    "legalUrl": "http://legal.trustpilot.dk",
    "blog": "http://blog.trustpilot.com",
    "commercialUrl": "http://business.trustpilot.dk",
    "tld": "dk",
    "aboutTrustpilotUrl": "http://company.trustpilot.dk",
    "nativeName": "Dansk",
    "supportUrl": "https://support.trustpilot.com"
  },
  "locales": [
    {
      "isDefaultForLanguage": "true",
      "countryId": 1,
      "language": "da",
      "locale": "da-DK",
      "translatedName": "Danish",
      "region": "DK",
      "businessWebApp": "https://da-dk.trustpilot.com/",
      "consumerWebApp": "http://www.trustpilot.dk/",
      "legalUrl": "http://legal.trustpilot.dk",
      "blog": "http://blog.trustpilot.com",
      "commercialUrl": "http://business.trustpilot.dk",
      "tld": "dk",
      "aboutTrustpilotUrl": "http://company.trustpilot.dk",
      "nativeName": "Dansk",
      "supportUrl": "https://support.trustpilot.com"
    }
  ]
}