Product Feed

A product feed contain details about your products. It describes how products are identified and organized into families and categories. TestFreaks uses your product feed to help you collect and display reviews in a relevant way.


Product The most specific level in your catalog. For example a black iPhone 15, 512 GB.
Family A collection of products that can share the same reviews. For example all iPhone 15 variants.
Category A product type like Mobile phones that can share review features such as asking about battery life etc.

Reviews are typically collected from order data on the Product level, and shared across all products in the same Family.

Feed format

Many companies already have a Google Merchant Product feed available. Standard ecommerce software is typically able to create a product feed in this format with minimal work.

Using a Google Merchant Product Feed is usually the best option to send your product feed to TestFreaks.

If that is not an option we also support a number of other formats. This includes Custom Product Feed formats in XML, CSV or JSON.

Supported fields

Field Description  
sku Product ID used to identify a product across the system (in APIs, website implementations, order data, etc.) Required
name Product name Required
brand or manufacturer Brand / Manufacturer name Required if not already included in the product name
url Product page location Required
image_url Product image location

JPEG or PNG images around 300x300 pixels in size
Required for review collection with images
family_id or parent_sku or item_group_id Family ID used to identify a family in APIs and website implementations Required for sharing reviews across similar products
category Product category name Required for aggregated content and category-specific questions
gtin or ean GTIN / EAN / UPC codes, with preference for GTIN-14 Required for aggregated content and Google Ads feeds
mpn or manufacturer_sku Manufacturer part number Required for aggregated content and Google Ads feeds
price The price of the product. This value can be used to determine which products to collect reviews for from a customer. The product with the highest price value will be the most prioritized for review collection. Optional
currency Currency for the price. Optional
priority The relative priority of how important review collection is for this specific product. This value can be used to determine which products to collect reviews for from a customer. The product with the highest priority value will be the most prioritized for review collection. This is similar to price but without any association to a price and a currency. Optional

Pre-existing product feeds may use different field names. The names above are guidelines for new feeds or when adding fields to existing feeds.

Example of product feed formats

Google Merchant Product Feed

If you are using Google Merchant Center to promote your products, you most likely have a product feed available. Most companies starting to use TestFreaks already have this type of feed available for other purposes.

The feed must follow the Google Merchant Product Feed specification, which is fully supported by TestFreaks and the preferred format to use for a product feed.

Custom Product Feed formats

In case it is not possible to use a Google Merchant Product Feed, TestFreaks support custom formats in XML, CSV or JSON.

XML feed example

<?xml version="1.0" encoding="UTF-8"?>
    <name>Product1 20mm Black</name>
    <category>Electronics &gt; Widgets</category>

JSON feed example

  "products": [
      "sku": "P001-02-BLK",
      "family_id": "P001",
      "brand": "ACME",
      "name": "Product1 20mm Black",
      "category": "Electronics > Widgets",
      "url": "https://retailer.example/p-001",
      "image_url": "https://retailer.example/images/300x300/p001021B.jpg",
      "mpn": "ACMEP1",
      "gtin": "00012345678905"

Feed delivery

We schedule daily fetches of your feeds and support feed URLs on http://, https://, ftp:// and sftp://.

Alternatively, you can schedule feed uploads to TestFreaks using FTP or SFTP after setting up an account with us.

For supported platforms, TestFreaks has direct integrations to access the product information. Please ask your TestFreaks contact for details.

Products API and Review Summaries API

You can use our Products API to access your product data, or the Review Summaries API to see what review information is available for each product and product family.

Checklist and best practices

Use this checklist to verify that you have considered different important aspects before starting to collect reviews with TestFreaks.

  • Is the product feed automatically updated?

  • Is the feed filtered?

    Products which are temporarily out of stock should ideally still be in the feed. Additional filtering can be done in the TestFreaks system if required.

  • Does the feed contain stable and unique product identifiers?

    This is especially important if you plan to match your product feed against syndicated data.

  • Does the feed indicate the product family/variation for all products?

  • Should some products be excluded or dealt with in a different way?

    In that case, is the data needed to make the decision included in the feed?

    This might apply to gift cards, services, products which you need to wait longer before being able to review, or items where you want to specifically ask about size fit, etc.

  • Does the product feed contain everything needed to create review invitation emails?

    This includes for example product image URLs and human readable product names.

  • Does the product feed contain the same identifiers that you intend to use in the order feeds and in display integrations?

  • Will your firewall and CDN allow TestFreaks to fetch the product feed?

    See IP addresses used by TestFreaks for more details.