Products Feed Specification


This page lists all the attributes you need to provide in order for your items to be listed in GoToMyPrice.com. Some attributes are required for all items, some are required for certain types of items (such as apparel), and others are recommended. Failure to provide a required attribute may prevent that particular item from showing up in GoToMyPrice.com results, whereas failure to provide recommended attributes may result in items showing up less frequently. Read through the entire document to make sure your products show up on GoToMyPrice.com. Before creating your feed, choose the file format that is right for you. 

A text line indicates what fields are present in the file, separated by "|" and the order in which they follow:
  • column 1 of the file should contain SKU(if not known leave blank) In text line,
  • column 2 of the file should contain Name In text line,
  • column 3 of the file should contain Brand In text line,
  • column 4 of the file should contain Price In text line,
  • column 5 of the file should contain Color In text line,
  • column 6 of the file should contain Material In text line,
  • column 7 of the file should contain URL In text line,
  • column 7 of the file should contain Image_URL In text line,
  • column 8 of the file should contain Description In text line,
  • column 9 of the file should contain Category In text line,
  • column 10 of the file should contain Merchant(if not known leave blank) In text line,
  • column 11 of the file should contain Author In text line,
  • column 12 of the file should contain Condition In text line,
  • column 13 of the file should contain Binding In text line,
  • column 14 of the file should contain Format In text line,
  • column 15 of the file should contain Measurement In text line.
 
 
SKU: In this column you would put the product sku of the products you would like to list with GoToMyPrice.
When to include: (If not known leave blank).
Type: Alphanumeric characters
Example: dsaw243mjac
Once an item is submitted, the sku must not change when you update your data feed or be used for a different product at a later point in time.

Product SKU

Name: In this column you would put the product names of the products you would like to list with GoToMyPrice.
When to include: Required for all items.
Type: Text. Should not be longer than 100 characters.
Example: Jackson Mens Brown Boots.
We recommend you include characteristics such as color or brand in the title which differentiates the item from other products.
*Note:
 - do not include any promotional text such as "Free shipping", and do not use BLOCK CAPITALS.
 - for variant products, you are required to include the common title of the variant items.

Product Name

Brand:
When to include: Required for all items.
Type: Text.
Example: Adidas.
*Note:
 - You must not provide your store name as the brand unless you manufacture the product.

Product Brand

Price: In this column you would put the price of the product you would like to list with GoToMyPrice. Do not put any dollar signs for the price or it will be rejected from the harvest. The Price column is programmed to understand that any number put in that specific field will be the price for the product.
When to include: Required for all items.
Type: Number
Example: 14.99
*Note:
- For the US, don't include tax in the price. For all other countries, value added tax (VAT) has to be included in the price.
- The price must include a currency according to ISO 4217 Standard. - You may use decimal points for the price of your product such as 14.99.

Product Price

Color: This defines the dominant color(s) of an item.
When to include: Required for all apparel items in feeds.
Type: Text.
Example: Red.
*Note:
 When a single item has multiple colors:
  - Combine them with ‘/’ in order of prominence (dominant color first, then accent colors). For example, a red shirt with blue accents should have a color value of 'Red / Blue'. This attribute can also be used for finishes as well (e.g., 'Mahogany' vs. 'Stainless Steel').

Material: The material or fabric that a product is made out of.
When to include: Required for all apparel items that differ by material
Type: Text.
Example: Rubber.
*Note:
 Provide values that they will be able to understand.
For example, a high heel pump might have values of “Leather”, “Denim”, “Suede”, etc.

URL: In this column you would put the URL for the product you would like to list with GoToMyPrice. The URL inserted would be the URL of the product. Each product should have a unique URL that should take you to the specific product page on your site.
When to include: Required for all items.
Type:URL (this must include the http:// portion) Example: http://www.yoursitename.com/search.aspx?id=10120
*Note:
 - All your URLs must link directly to webpages about your products without pop ups. We don't allow landing pages requiring sign ups, passwords, or direct links to files/email addresses.
 - The URL is located on the top of the product page in the address bar on your browser.
 - Tracking IDs may be included in the URL.
 - The URL must not redirect or forward to a location external to your site.
 - The URL must start with 'http://' or 'https://'
 - Any symbols used must be replaced by URL encoded entities (e.g. comma = %2C).
 - The user is sent to this URL when your item is clicked on Product Search. We also refer to this as the landing page. It must point to a page showing the exact item the user was looking at.

Product URL

Image_URL: In this column you would put the URL for the product you would like to list with GoToMyPrice. The URL inserted would be the URL of the product. Each product should have a unique URL that should take you to the specific product page on your site.
When to include: Required for all items.
Type:URL. (Must start with 'http://' or 'https://'.)
Example: http://www.yoursitename.com/image.jpg
Formatting:
 - The accepted image formats are GIF, JPG (or JPEG), PNG, BMP, and TIF and the file extensions for these images should correspond to their format.
 - Any symbols used within the image URL must be replaced by URL encoded entities (e.g. comma = %2C).
*Note:
 - If you have no image for your item, you cannot submit the item.

Product Image URL

Description: In this column you would put the description of the products you would like to list with GoToMyPrice. Include only information relevant to the item, but be comprehensive since we use this text to find your item.
When to include: Required for all items.
Type: Text
To put in the description you would need to copy the product description of the product you would like to list with GoToMyPrice. Include only information relevant to the item, but be comprehensive since we use this text to find your item. We recommend you submit around 200 characters, but you can submit up to 250 characters. The whole description of the product is not necessary. Description field should contain information about the product and should be at least 20 characters. If you must use commas in your description field, then you may simply put the description in quotation marks or save the data feed as .txt file.
*Note:  - do not include any promotional text such as "Free shipping", do not use BLOCK CAPITALS, and do not include a description of your store.

Product Description

Category: In this column you would put the category name of the products you would like to list with GoToMyPrice. When putting in the Category path, please be specific as possible.
When to include: Required for all items.
Type: Predefined values from GoToMyPrice’s list of product categories
Example: Books & Magazines > Crafts/Hobbies Books > Cooking, Food & Wine Books
Make sMake sure in the "Category Field" you put the most specific category on your website the product belongs to. For example if the product is in the "Boots" category make sure you specify if it's for men or women. Categories trees are recommended (Example: Women's Footwear > Boots )
(Example: If you're a company selling baby car seats, you would have to put it in the category called Car Seats.)
Please be as specific as possible Baby & Kids > Baby Travel Gear > Car Seats.
*Note:
 - We recommend to use the full path of the category tree on your site (i.e. "Baby & Kids > Baby Travel Gear > Car Seats")
 - Any category from GoToMyPrice’s list of categories must include the full path. For example, 'Furniture > Bedroom Furniture > Beds' is an acceptable value, but 'Beds' is not. This attribute only accepts values that are predefined by GoToMyPrice’s list of categories.

Manufacturer: column you would put the manufacturer names of the products you want to list with GoToMyPrice.
When to include: Required for all items.
Type: Text
The Manufacturer column can only contain the manufacturer name. For better results in our listings use a short name for the Manufacturer (example: Sony would show up more often than Sony Electronics Inc.)

Author: column you would put the manufacturer names of the products you want to list with GoToMyPrice.
When to include: Required for all items.
Type: Text
The Manufacturer column can only contain the manufacturer name. For better results in our listings use a short name for the Manufacturer (example: Sony would show up more often than Sony Electronics Inc.)

Condition: column you would put the condition or state of the item.
When to include: Required for all items.
Type: Three predefined values accepted:
 - 'new'
 - 'used'
 - 'refurbished'
*Note:
There are only three accepted values:
 - 'new': The product is brand-new and has never been used. It's in its original packaging which has not been opened.
 - 'refurbished': The product has been restored to working order. This includes, for example, remanufactured printer cartridges.
 - 'used': If the two previous values don't apply. For example, if the product has been used before or the original packaging has been opened or is missing.

Binding: column you would put the type of binding for Books
When to include: Required for all items in Books category.
Type: Four predefined values accepted:
 - Hardcover
 - Paperback
 - Large Print Board
 - Book School & Library Binding

Format: column you would put the type of format for Books, Video, DVD
When to include: Required for all items in Books, Video, DVD.
Type: predefined values accepted:
 - Paper
 - HardCover
 - Other
 - CD
 - DVD
 - VHS
 - DVD
 - VHS
 - LaserDisc

Measurement: column you would put the measurement of the products you want to list with.
When to include: Required for all items.
Type: Text


For any questions regarding creating the GoToMyPrice product data feed, please e-mail us at support@gotomyprice.com