What is an XML Feed?
In order to list your products, AmmoSeek needs a data feed (in XML or JSON format) which describes all of your in-stock products (all supported product types should be in a single feed; see below).
A data feed is simply a text file that described each individual item's data. It should reside on a web server where we can access it at any time. For example: http://yourdomain.com/xmlfeed.php (for live feeds) or http://yourdomain.com/xmlfeed.xml (for feeds generated at least every 5 minutes). (NOTE: These are just examples. The URL/filename/extension is not important, only the content of the feed and the accuracy/timeleness of the data).
As you develop your feed, you can use our Feed Tester to verify that things look correct.
Supported Product Types (What Products Are Accepted?)
Ammunition
Magazines
Guns
Bullets
Brass
Primers
Powder
Reloading Misc
Feed Refresh Requirements
Summary:
Must update at least every 5 minutes.
Should return a response within 90 seconds.
Real-time or near-real-time updates are strongly preferred.
Required Fields for Every Product
Summary:
Product title
Direct product URL
Price
Brand
Caliber
Number of rounds or units
Product type (
<type>)In-stock indication
Additional fields for ammo (e.g., casing, condition, purchase limits)
Optional but Recommended Fields
Summary:
<grains><shot_size><shell_length><upc>,<mpn><rebate><minpurchase><purchaselimit>
Ammo-Specific Considerations (Special Rules for Ammunition Listings)
Summary:
Casing must be indicated if not brass.
Condition (
new,remanufactured, etc.) required if not factory-new.Special rules for shotgun ammo, bulk discounts, and purchase limits.
Bulk Variants and Quantity Handling (Managing Product Variants)
Summary:
Limit to three variations per product.
Each variant must be a separate record.
Clear price/round calculations for each quantity level.
Formatting Requirements
Summary:
Use
<![CDATA[]]>for special characters.One product per
<product>tag.Escape XML special characters properly.
Use only supported
<type>values.
Feed File Layout
Summary:
Single feed for all supported product types.
Must include retailer domain in
<productlist>tag.Example XML blocks provided (will include snippets on your site).
Example XML for:
a 50-round box of .38 Special
a 400-round case of .308 Marlin Express
250 rounds of 12 Gauge 2 3/4" OO-Buck shotgun shells
a 5-pack of 12 Gauge 2-3/4" Lead Rifled Slugs
<productlist retailer="yoursiteURL.com">
<product>
<type>ammunition</type>
<title><![CDATA[.38 Special Federal LE Tactical Hydra-Shok 147gr. 50rds +P+ HP]]></title>
<brand><![CDATA[Hornady]]></brand>
<caliber><![CDATA[38 Special]]></caliber>
<url><![CDATA[http://yoursiteURL.com/products/item12345.html]]></url>
<upc>054041163255</upc>
<grains><![CDATA[110]]></grains>
<price><![CDATA[21.99]]></price>
<rebate><![CDATA[3.00]]></rebate>
<numrounds><![CDATA[50]]></numrounds>
<shot_size><![CDATA[]]></shot_size>
<shell_length><![CDATA[]]></shell_length>
<purchaselimit>10</purchaselimit>
<condition>new</condition>
<casing>brass</casing>
</product>
<product>
<type>ammunition</type>
<brand><![CDATA[Remington]]></brand>
<caliber><![CDATA[308 Marlin Express]]></caliber>
<title><![CDATA[Remington 308 Marlin Express 150 Grain Case of 400]]></title>
<url><![CDATA[http://yoursiteURL.com/products/item23456.html]]></url>
<upc>054041163255</upc>
<grains><![CDATA[150]]></grains>
<price><![CDATA[429.99]]></price>
<numrounds><![CDATA[400]]></numrounds>
<shot_size><![CDATA[]]></shot_size>
<shell_length><![CDATA[]]></shell_length>
<purchaselimit></purchaselimit>
<condition>new</condition>
<casing>brass</casing>
</product>
<product>
<type>ammunition</type>
<brand><![CDATA[Hornady]]></brand>
<caliber><![CDATA[12 GAUGE]]></caliber>
<title><![CDATA[Hornady TAP LightMagnum 12 Gauge 2 3/4" 00 Buckshot Case of 250]]></title>
<url><![CDATA[http://yoursiteURL.com/products/item34567.html]]></url>
<upc>054041163255</upc>
<grains><![CDATA[]]></grains>
<price><![CDATA[249.99]]></price>
<numrounds><![CDATA[250]]></numrounds>
<shot_size><![CDATA[OO]]></shot_size>
<shell_length><![CDATA[2 3/4"]]></shell_length>
<purchaselimit></purchaselimit>
<condition>new</condition>
</product>
<product>
<type>ammunition</type>
<brand><![CDATA[Brenneke]]></brand>
<caliber><![CDATA[12 GAUGE]]></caliber>
<title><![CDATA[Brenneke USA Black Magic Short Magnum 12 Gauge 2-3/4" Lead Rifled Slug Box of 5]]></title>
<url><![CDATA[http://yoursiteURL.com/products/item45678.html]]></url>
<upc>054041163255</upc>
<grains><![CDATA[]]></grains>
<price><![CDATA[9.79]]></price>
<numrounds><![CDATA[5]]></numrounds>
<shot_size><![CDATA[slug]]></shot_size>
<shell_length><![CDATA[2 3/4"]]></shell_length>
<purchaselimit></purchaselimit>
</product>
</productlist>
Hosting and Availability
Summary:
Feed must be accessible via public URL.
Should always be up-to-date and return valid data.
What Will Disqualify Your Listing?
Summary:
No combo packs, no LE-only/membership-only items.
No backorders, in-store-only items, or muzzleloaders.
Must list all available products of a given type (not a sample).
Update Intervals & Syncing (How Often Should You Sync?)
Summary:
Flat files: regenerate every 5 min.
Dynamic scripts: must respond quickly.
Our system fetches feeds every 3 minutes.
Need Help? (Feed Setup Assistance)
Summary:
Lists trusted developers and plugins (e.g. WooCommerce plugins, external agencies).
Mention limitations of unsupported plugins (like DataFeedWatch, FeedGeni).
Offer contact form or support email.