Resources API

Contains navigational links to all image resources

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

Get all countries known to Trustpilot

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

Get the star image resources

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 Number
The number of stars to return images for.
Constraints: Allowed values are 0, 1, 1.5, 2, 2.5, 3, 3.5, 4, 4.5, 5
Example: …/v1/resources/images/stars/4

Response

{
  "star256x48": {
    "url": "//trustpilot.com/image.jpg",
    "width": "400",
    "height": "300"
  },
  "starSvg": {
    "url": "//trustpilot.com/image.jpg",
    "width": "400",
    "height": "300"
  },
  "star128x24": {
    "url": "//trustpilot.com/image.jpg",
    "width": "400",
    "height": "300"
  },
  "stars": 4,
  "star512x96": {
    "url": "//trustpilot.com/image.jpg",
    "width": "400",
    "height": "300"
  }
}

Get the string representation of the stars

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

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

stars, Required Number
The number of stars to return the text representation for.
Constraints: Allowed values are 0, 1, 1.5, 2, 2.5, 3, 3.5, 4, 4.5, 5
Example: …/v1/resources/strings/stars/4

Response

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

Get the Trustpilot icon images

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

{
  "image230x230": {
    "url": "//trustpilot.com/image.jpg",
    "width": "400",
    "height": "300"
  }
}

Get the Trustpilot logo images

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": {
    "logo72x18": {
      "url": "//trustpilot.com/image.jpg",
      "width": "400",
      "height": "300"
    },
    "logo144x36": {
      "url": "//trustpilot.com/image.jpg",
      "width": "400",
      "height": "300"
    },
    "logoSvg": {
      "url": "//trustpilot.com/image.jpg",
      "width": "400",
      "height": "300"
    },
    "logo288x72": {
      "url": "//trustpilot.com/image.jpg",
      "width": "400",
      "height": "300"
    },
    "logo576x144": {
      "url": "//trustpilot.com/image.jpg",
      "width": "400",
      "height": "300"
    }
  },
  "lightBackground": {
    "logo72x18": {
      "url": "//trustpilot.com/image.jpg",
      "width": "400",
      "height": "300"
    },
    "logo144x36": {
      "url": "//trustpilot.com/image.jpg",
      "width": "400",
      "height": "300"
    },
    "logoSvg": {
      "url": "//trustpilot.com/image.jpg",
      "width": "400",
      "height": "300"
    },
    "logo288x72": {
      "url": "//trustpilot.com/image.jpg",
      "width": "400",
      "height": "300"
    },
    "logo576x144": {
      "url": "//trustpilot.com/image.jpg",
      "width": "400",
      "height": "300"
    }
  }
}

Get Trustpilot supported locales

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,
    "isSupportedInBusinessWebApp": false,
    "language": "da",
    "locale": "da-DK",
    "translatedName": "Danish",
    "region": "DK",
    "businessWebApp": "https://da-dk.b2b.trustpilot.com/",
    "consumerWebApp": "http://www.trustpilot.dk/",
    "legalUrl": "http://legal.trustpilot.dk",
    "blog": "http://blog.trustpilot.com",
    "businessSignupUrl": "https://signup.business.trustpilot.com/#/signup?locale=en-US",
    "commercialUrl": "http://business.trustpilot.dk",
    "tld": "dk",
    "aboutTrustpilotUrl": "http://company.trustpilot.dk",
    "nativeName": "Dansk",
    "supportUrl": "https://support.trustpilot.com"
  },
  "locales": [
    {
      "isDefaultForLanguage": true,
      "countryId": 1,
      "isSupportedInBusinessWebApp": false,
      "language": "da",
      "locale": "da-DK",
      "translatedName": "Danish",
      "region": "DK",
      "businessWebApp": "https://da-dk.b2b.trustpilot.com/",
      "consumerWebApp": "http://www.trustpilot.dk/",
      "legalUrl": "http://legal.trustpilot.dk",
      "blog": "http://blog.trustpilot.com",
      "businessSignupUrl": "https://signup.business.trustpilot.com/#/signup?locale=en-US",
      "commercialUrl": "http://business.trustpilot.dk",
      "tld": "dk",
      "aboutTrustpilotUrl": "http://company.trustpilot.dk",
      "nativeName": "Dansk",
      "supportUrl": "https://support.trustpilot.com"
    }
  ]
}