Table of Contents

GunNabber XML Format

Introduction

This document provides a detailed reference for the XML and JSON format used by GunNabber to list products. It includes the required fields, their data types, constraints, and example values. This format is essential for ensuring that product listings are consistent and accurate across the platform.

This applies to only the GunNabber format. If you are using a feed format from another provider, you would want to reference their documentation.

We recommend that you use the GunNabber format. Use a third party format if you are providing data to multiple platforms (GunNabber, AmmoSeek, etc.) and cannot establish multiple feed formats independently for each platform. If you are only providing data to GunNabber, we recommend that you use the GunNabber format as it is the most accurate and supported format on our platform.

We are not affiliated with or endorsed by AmmoSeek, WikiArms or any third party feed providers.

Third party formats may change periodically, and we may not be able to support all of the fields that they provide.

GunNabber Product Field Reference

producttype

  • Product Types: All
  • Required: Yes
  • Data Type / Constraints: string (one of: ammunition, firearm, handgun, rifle, shotgun, part, accessory, optic, gear, brass, primers, bullets, powder, reloading, promotion)
  • Description: Type/category of the product in lower case.
  • Example: "ammunition"

name

  • Product Types: All
  • Required: Yes
  • Data Type / Constraints: string (255)
  • Description: Product name
  • Example: "Federal 9mm 115gr FMJ"

description

  • Product Types: All
  • Required: No
  • Data Type / Constraints: string (2000)
  • Description: Long-form description
  • Example: "Made to Federal's high-quality standards, American Eagle ammunition is extremely reliable handgun ammo, offered at a value price."

brand

  • Product Types: All
  • Required: No
  • Data Type / Constraints: string (50)
  • Description: Manufacturer or brand
  • Example: "Federal"

price

  • Product Types: All
  • Required: Yes
  • Data Type / Constraints: decimal ≥ 0
  • Description: Price of product
  • Example: 24.99

upc

  • Product Types: All
  • Required: No
  • Data Type / Constraints: string (12)
  • Description: UPC code. Standard 12-digit UPC code without dashes or spaces. Processed as a string to preserve leading zeros.
  • Example: 064544653426

mpn

  • Product Types: All
  • Required: No
  • Data Type / Constraints: string (100)
  • Description: Manufacturer part number
  • Example: "AE9DP"

sku

  • Product Types: All
  • Required: No
  • Data Type / Constraints: string (100)
  • Description: Seller’s stock keeping unit
  • Example: "FED-AE9DP-50"

url

  • Product Types: All
  • Required: Yes
  • Data Type / Constraints: string (2048) (valid URL) (unique)
  • Description: Link to retailer's product page. Must include https://
  • Example: "https://example.com/product/12345"

availability

  • Product Types: All
  • Required: Yes
  • Data Type / Constraints: string (25) (One of: in stock, out of stock)
  • Description: Availability info. Any value other than "in stock" or "out of stock" will be treated as "out of stock".
  • Example: "In Stock"

shippinginfo

  • Product Types: All
  • Required: No (future use)
  • Data Type / Constraints: string (125)
  • Description: Shipping details. This may include shipping costs, free shipping thresholds, or other relevant shipping information.
  • Example: "Free shipping over $100"

imageurl

  • Product Types: All
  • Required: No (future use)
  • Data Type / Constraints: string (2048) (valid URL)
  • Description: Image URL
  • Example: "https://example.com/image.jpg"

caliber

  • Product Types: ammunition, firearm, handgun, rifle, shotgun, bullets
  • Required: Yes (for product types that require it)
  • Data Type / Constraints: string (25)
  • Description: Caliber of the item
  • Example: "9mm Luger"

quantity

  • Product Types: All
  • Required: No
  • Data Type / Constraints: integer ≥ 0
  • Description: Quantity per purchase. For ammunition, this is the number of rounds per box. For Brass and primers, this is the number of pieces per box. For other items, this is the number of items being sold.
  • Example: 50

purchaselimit

  • Product Types: All
  • Required: No
  • Data Type / Constraints: integer ≥ 0
  • Description: Max units per purchase
  • Example: 5

casing

  • Product Types: Ammunition, Brass
  • Required: No
  • Data Type / Constraints: string (25)
  • Description: Case material
  • Example: "Brass"

condition

  • Product Types: All
  • Required: No
  • Data Type / Constraints: string (25)
  • Description: Item condition
  • Example: "New"

grain

  • Product Types: Ammunition, Bullets
  • Required: No
  • Data Type / Constraints: integer ≥ 0
  • Description: Bullet weight in grains
  • Example: 115

shelllength

  • Product Types: Ammunition (Shotgun)
  • Required: No
  • Data Type / Constraints: string (10)
  • Description: Shell length (shotgun)
  • Example: "2.75\""

shotsize

  • Product Types: Ammunition (Shotgun)
  • Required: No
  • Data Type / Constraints: string (10)
  • Description: Shot size
  • Example: "7.5"

minimumpurchase

  • Product Types: All
  • Required: No
  • Data Type / Constraints: integer ≥ 0
  • Description: Minimum units per order
  • Example: 10

rebate

  • Product Types: All
  • Required: No
  • Data Type / Constraints: string (50)
  • Description: Rebate details
  • Example: "$5 rebate when buying 2+"

priceperround

  • Product Types: Ammunition
  • Required: No
  • Data Type / Constraints: decimal ≥ 0
  • Description: Price per individual round. This is calculated as price / quantity and is used for comparison across different products. The provided value may be overridden during the import based on price and quantity reported. This is represended as "Each" in the UI.
  • Example: 0.24

make

  • Product Types: Firearms
  • Required: No
  • Data Type / Constraints: string (50)
  • Description: Firearm make
  • Example: "Glock"

model

  • Product Types: Firearms
  • Required: No
  • Data Type / Constraints: string (50)
  • Description: Firearm model
  • Example: "19 Gen5"

firearmtype (for compatibility with other feeds)

  • Product Types: Firearms
  • Required: No
  • Data Type / Constraints: string (50)
  • Description: Type of firearm. This is used to specify the type of firearm, such as handgun, rifle, or shotgun. This field is primarily for compatibility with other feeds and may not be required in all cases.
  • Example: "handgun"

action

  • Product Types: Firearms
  • Required: No
  • Data Type / Constraints: string (25)
  • Description: Action type
  • Example: "Semi-Automatic"

Best Practices

  • Use Valid URLs: Ensure that all URLs provided in the feed are valid and accessible.
  • Consistent Data Types: Use the specified data types for each field to ensure compatibility with our system.
  • Field Requirements: Pay attention to which fields are required and which are optional. Missing required fields may result in product listings not being processed.
  • Provide Descriptive Names Add as much detail to the product name as possible to help users identify the product easily.