Single File Feed

For dealers with fewer than 10 locations

Every 15 minutes JSON XML

Quick Start Checklist

1 Host your feed at a URL endpoint or provide SFTP credentials
2 Include store location data (optional, but enables local search)
3 Include product data with storeId references for each location
4 We fetch your feed automatically every 15 minutes

Your data feed should include both store location information and product inventory details. The storeId field is a critical identifier that links products to their respective store locations. Each product must reference the correct storeId to ensure accurate inventory tracking across multiple locations.

If you don't have any physical store locations, you can skip the Store Location data. Stores without this data won't appear in local searches but will still be included in national searches.

Feed Structure

Need help with product fields?

See the Product Reference for category values, ammo fields, and reloading fields.

Your Feed File

JSON or XML

dealer Store locations

products Product catalog with inventory

How storeId Links Locations to Products:

Store: "storeId": "001"

links to

Product location: "storeId": "001", price, stock...

Complete Example

Complete Feed Example

{
  "dealer": {
    "domainName": "https://www.exampledealer.com",
    "storeLocations": {
      "location": [
        {
          "storeId": "001",
          "storeName": "Bill's Gun Shop",
          "street": "123 Main Street",
          "city": "TOWNSVILLE",
          "state": "TX",
          "zip": "12345",
          "phone": "123-456-7891",
          "hideFFLAddress": false
        }
      ]
    }
  },
  "products": {
    "product": [
      {
        "title": "GLOCK 19x Semi-Auto Pistol with Coyote Finish",
        "url": "https://examplegundealer.com/glock/19x",
        "imageUrl": "https://examplegundealer.com/images/19x.webp",
        "departmentName": "FIREARMS",
        "categoryName": "PISTOL",
        "subcategoryName": "SEMI-AUTOMATIC",
        "manufacturerName": "GLOCK",
        "model": "19x",
        "upc": "123456789012",
        "mfgNumber": "123456789012",
        "locations": {
          "location": [
            {
              "storeId": "001",
              "price": 599.99,
              "pricedBelowMAP": true,
              "addToCartForPrice": true,
              "emailForPrice": false,
              "inStock": true,
              "inStore": false,
              "eligibleForFinancing": true,
              "condition": "new",
              "shippingInfo": "19.99 over 500 ships free"
            }
          ]
        },
        "attributes": {
          "attribute": [
            {
              "attributeName": "Caliber",
              "attributeValue": "9MM"
            },
            {
              "attributeName": "Barrel Length",
              "attributeValue": "4"
            },
            {
              "attributeName": "Capacity",
              "attributeValue": "16"
            }
          ]
        }
      }
    ]
  }
}

Additional Documentation

Product Reference

Categories, ammo fields, reloading & best practices

Multi File Feed

For 10+ store locations

Need Help?