Importing Existing Reviews

Moving to TestFreaks from another review system or provider does not mean you should start from zero reviews!

In most cases you can export all your previously collected product reviews or service/seller reviews and keep showing them to your customers. This page describe the process of importing all your existing reviews to TestFreaks.

Importing existing reviews from Trustpilot, Yotpot, or Lipscore

TestFreaks can easily import your existing reviews if you have been using one of the following providers:

  • Trustpilot
  • Yotpo
  • Lipscore

Export the product reviews or service reviews from your provider’s system as one or multiple CSV files.

Send the files to TestFreaks and we will help you by importing the reviews into our system.

Importing existing reviews from other systems or providers

If you have been using any other review system or provider, the following sections describes the data TestFreak need to ensure a successful import of your product reviews or service/seller reviews.

Create one or more files containing the reviews you want TestFreaks to import.

Send the files to TestFreaks and we will help you by importing the reviews into our system.

Please contact TestFreaks if you have question regarding the data format or other parts of the export/import process.

Data requirements for exported Product reviews

Field Required Description
Product ID (also known as SKU, ID, article number) Required This needs to be the same as the product ID we get in the product feed for the import to be feasible.

If the product IDs have changed or are different in the export it will not be possible to connect reviews to products. If the product IDs have changed but you can provide a separate list or another product identifier (for example GTIN), the list can be used to map the reviews to the right product.
Rating (also known as review score) Required The rating/score of the review, preferably in a 1–5 scoring system.
Review (also known as review text) Required The text part of the review. Make sure any special characters such as &, ", emojis, smileys etc. are properly escaped or formatted. The file format should be UTF-8.
Review date (also known as timestamp) Required The date when the review was added. We are able to import most formats for dates as long as the format is stable across the export.
Author (also known as alias, nickname) Required The name or chosen alias of the review author.
Review ID Best practice One unique ID per review.
Family IDs (also known as group id, main product id) Best practice Please provide a grouping ID in the export if you have product groups that already share reviews, and you wish to import the reviews with these groupings intact.
Author email Best practice Providing an email address makes it possible to contact the customer even after the import.
Author customer ID Best practice With this, possibly combined with author email, it is possible to create a customer within the portal.

Data requirements for exported Service/Seller reviews

Field Required Description
Rating (also known as review score) Required The rating/score of the review, preferably in a 1–5 scoring system.
Review (also known as review text) Required The text part of the review. Make sure any special characters such as &, ", emojis, smileys etc. are properly escaped or formatted. The file format should be UTF-8.
Review date (also known as timestamp) Required The date when the review was added. We are able to import most formats for dates as long as the format is stable across the export.
Author (also known as alias, nickname) Required The name or chosen alias of the review author.
Review ID Best practice One unique ID per review.
Author email Best practice Providing an email address makes it possible to contact the customer even after the import.

Importing existing reviews using TestFreaks API

Alternatively, it is also possible to use the TestFreaks API to create product reviews that have been collected using another system or provider.

This will likely require development of custom software on your side. Refer to the Reviews API specification for further details.

Note: It is currently not possible to create or modify a Seller Review through the API.