Partner Feed Specification v1.1

This document provides detailed instructions on how to format your product data files for import into our partner system. Adhering to these specifications ensures your products are listed correctly, updated in real-time, and displayed with accurate pricing and stock status.

Quick Summary Feed format explained here is used to import offers. Feeds should be valid CSV, XML, or JSON files. You can upload files directly or provide a dynamic URL (e.g., Google Sheets) for automatic updates.

1. Supported File Formats

We accept feeds in the following formats. CSV is recommended for the fastest processing.

CSV (Comma Separated Values) - Preferred
XML (Standard product schemas)
JSON (Array of objects) - New!
Google Sheets (Published as CSV link)

2. General Guidelines

Character Encoding: Files must be encoded in UTF-8.
Headers: Your file must include a header row (or keys for JSON) defining the data in each column.
Update Frequency: You may perform manual updates via link based on your subscription plan limits (e.g., 2 times/day).
Images: Image URLs must be direct links (ending in .jpg, .png, etc.) accessible publicly.

3. Data Specification

Below is the list of fields our system accepts. Please ensure your feed contains at least the Required fields.

Field Name	Status	Data Type	Description & Constraints
UPC/EAN	Required	String (Digits)	The Universal Product Code, EAN, or GTIN-12/13. This is the primary unique identifier for your product. Example: `082442818144`
Product Name	Required	String	The full title of the product. Include Manufacturer, Model, and Key Specs. Example: `Glock 19 Gen 5 9mm 15rd Black`
Sale Price	Required	Decimal	The current selling price. Do not include currency symbols ($). Example: `499.99`
Regular Price	Optional	Decimal	The MSRP or original price. Used to show discounts. Example: `550.00`
Product URL	Required	URL	The direct link to the product page on your website. Example: `https://store.com/glock-19`
Image URL	Recommended	URL	Direct link to the product image. Example: `https://store.com/img/g19.jpg`
Stock Status	Recommended	String	The availability status. Accepted values: `In Stock`, `Out of Stock`, `Backorder`.
Brand	Optional	String	The manufacturer of the product. Example: `Glock`
Category	Optional	String	The category or sub-category of the item. Example: `Handguns > Semi-Auto`
Shipping Cost	Optional	Decimal	Flat rate shipping cost for this item. Example: `15.00`

4. Example Feed Structures

A. CSV Format Example (Recommended)

Standard comma-separated format. Use a header row.

upc,name,price,regular_price,stock_status,product_url,image_url,brand,shipping_cost
082442818144,Glock 19 Gen5 9mm,539.00,599.00,In Stock,https://mystore.com/g19,https://mystore.com/images/g19.jpg,Glock,0.00
798681306543,Sig Sauer P365,499.99,550.00,Out of Stock,https://mystore.com/p365,https://mystore.com/images/p365.jpg,Sig Sauer,15.00

B. XML Format Example

If using XML, ensure your structure iterates over a parent "product" or "item" node.

<?xml version="1.0" encoding="UTF-8" ?>
<products>
    <product>
        <upc>082442818144</upc>
        <name>Glock 19 Gen5 9mm</name>
        <brand>Glock</brand>
        <price>539.00</price>
        <stock_status>In Stock</stock_status>
        <product_url>https://mystore.com/g19</product_url>
        <image_url>https://mystore.com/images/g19.jpg</image_url>
    </product>
</products>

C. JSON Format Example

If using JSON, ensure the file contains a single array of product objects.

[
    {
        "upc": "082442818144",
        "name": "Glock 19 Gen 5 9mm",
        "price": "539.00",
        "stock_status": "In Stock",
        "product_url": "https://mystore.com/g19",
        "image_url": "https://mystore.com/images/g19.jpg"
    },
    {
        "upc": "798681306543",
        "name": "Sig Sauer P365",
        "price": "499.99",
        "stock_status": "Out of Stock",
        "product_url": "https://mystore.com/p365",
        "image_url": "https://mystore.com/images/p365.jpg"
    }
]

5. Intelligent Column Mapping

Our system includes an Intelligent Mapper. If your feed uses different column headers (e.g., your file says "Title" instead of "Name", or "Cost" instead of "Price"), you do not need to change your file structure.

Upload your feed file or provide the direct URL.
On the next screen, you will see a mapping interface.
Select your column names from the dropdowns to match our system fields (e.g., Map your "Item Title" column to our "Product Name" field).
Click Process Feed.
The system will remember this mapping configuration for all future updates from the same URL.

6. Google Sheets Integration Guide

We support direct integration with Google Sheets, allowing you to manage inventory in a spreadsheet.

Prepare your Google Sheet with headers in the first row.
Go to File > Share > Publish to Web.
Under the "Link" tab, select the specific Sheet (Tab) you want to share.
Change the format dropdown from "Web Page" to Comma-separated values (.csv).
Click Publish and copy the generated link.
Paste this link into the "Import from URL" field in your Partner Dashboard.

Note on Updates You can trigger a manual update from this link via your dashboard. The frequency of allowed updates (e.g., 2x per day) depends on your subscription plan.