A review source is a DataHub source with a data type of Review. It works the same way as a product source: connect it in DataHub and Vendably handles the import and ongoing sync. Reviews then flow into Trust automatically, where they go through moderation and can be displayed.
Vendably supports API connections to Trustpilot, Reviews.io, Yotpo, Judge.me, and Google Business Profile, as well as file sources for any review data in CSV or JSON format.
For an overview of how DataHub sources work, see Connect a product source to DataHub.
What you need before connecting
For API provider connections:
- The provider account identifier for your business. This varies by provider: Trustpilot uses a business unit ID, Reviews.io uses a merchant ID, and so on. You will find this in your provider account settings.
- Any API credentials the provider requires (API key, secret, or token). Check your provider's developer or integration settings.
For file sources:
- The review file itself (CSV or JSON), or the URL or FTP/SFTP location where Vendably can fetch it on a schedule.
- The file must contain at minimum a rating value per review.
Connect in Vendably
- In the main navigation, go to DataHub then Sources.
- Click Add source.
- Select your review provider from the list (Trustpilot, Reviews.io, Yotpo, Judge.me, Google Business Profile) or select File import for a CSV/JSON review file.
- Set the data type to Review.
- Enter the provider account identifier or the file location, plus any required credentials.
- Click Connect. Vendably validates the connection and begins the initial import.
Vendably uses a built-in mapping template for each supported provider to map the provider's review fields to Vendably's standard review schema. For generic CSV/JSON file sources, select the closest template and adjust the field mapping as needed.
What Vendably ingests per review
For each review, Vendably ingests:
- Rating, title, and review content
- Author name and verified purchase status
- The product the review relates to, matched by GTIN, SKU, or product reference
- Submitted date and language
- Source URL (the canonical link back to the review on the provider platform)
What happens after connecting
After the initial import, Vendably syncs the review source on the standard scheduled pull interval, the same as other DataHub sources. New reviews from the provider appear in the next scheduled sync.
Reviews flow into Trust automatically once imported. In Trust, reviews go through moderation before they are surfaced. You do not need to take any further action in DataHub once the source is connected and syncing.
Troubleshooting
Reviews not importing: confirm the provider account identifier (business unit ID, merchant ID, or equivalent) and API credentials are correct and still active. Provider API keys can expire or be rotated; check your provider account and update the credentials in the source settings if needed.
Reviews not linking to products: Vendably matches reviews to products using GTIN, SKU, or a product reference. If reviews import but do not attach to any products, confirm that the review feed from your provider includes one of those identifiers and that the values match the identifiers in your product catalogue. See Connect a product source to DataHub for how product identifiers are imported.
File source not updating: confirm that the file URL or FTP/SFTP location is reachable from outside your network and that the credentials have not changed. Also check that the file format and column structure match the mapping template you selected when setting up the source.