Achtung: Your browser is outdated. Please note that Gunfinder may not work properly in some places. You should update your browser as soon as possible. Learn more here!
List item

Gunfinder Product Data Feeds: Create a Data Feed for Your Shop

Updated on July 14, 2026

Gunfinder is a meta search engine that helps hunters and sport shooters quickly find the product they're looking for at the right price. If you run an online shop, Gunfinder can automatically import your listings into the search. All we need is a product data feed from your shop. Below you'll find all the formats we support.

Known Shop Solutions

There are several ready-made shop solutions that Gunfinder can connect to with minimal effort.
Guides for the most common shops can be found here:

If your shop isn't listed here, feel free to send us an email and we'll make sure to write a guide for your shop too.

Google Shopping

Google Shopping is a widely used format for sharing product data with Google. Many shop solutions like JTL or Shopware already support this format out of the box, or can easily be extended with a plugin. That's why Gunfinder supports this format too.
So if your shop already supports Google Shopping, the easiest option is to provide us with a data feed in this format. We accept both XML and CSV.
More information about Google Shopping can be found directly on Google.

Idealo

Idealo is a well-known price comparison engine. Many shop solutions like JTL or Shopware already support the Idealo format out of the box, or can easily be extended with a plugin. That's why Gunfinder supports this format too.
So if your shop already supports the Idealo format, the easiest option is to provide us with a data feed in this format.

Affiliate Networks

By default, Gunfinder can also read the file formats of the most common affiliate networks. So if your shop is already a member of an affiliate network, just send us a data feed from there.

If you're not yet a member of an affiliate network but are interested in joining one, feel free to get in touch with our partner AdCell. We've been working successfully with AdCell for several years. AdCell stands out not only for its excellent customer support, but also for the smooth onboarding and ongoing support of firearms retailers.

The Gunfinder Format

To make it as easy as possible to get your listing data into our search engine, we of course also offer our own format. The table below gives a brief description of all available fields/attributes. Supported file formats are JSON and CSV.
Please use JSON whenever possible, and only fall back to CSV as a last resort.

Attribute

Description

Required

id

string(100)
A unique identifier that identifies the listing in your system.

Yes

type

enum(buynow, auction, buynow-auction)
Type of the listing. A regular shop will always have the type `buynow`. If the type is not specified, we assume `buynow`.

No

title

string(255)
Title of the listing.

Yes

brand

string(255)
Brand name of the listing.

No

description

string(5000)
Description text of the listing.

No

condition

enum(new, used)
Condition of the listing.

Yes

availability

enum(in-stock, preorder, out-of-stock, limited)
Availability of the listing in the shop.

Yes

pictures

string[]
An array of URLs pointing to images of the listing.

No

tags

string[]
An array of possible tags for this listing. In most cases, you can simply use the names of the categories this product is assigned to in your shop.

No

price

float
Price of the listing in decimal notation.

Yes

oldPrice

float
If this is a discounted listing, the original price can be provided here.

No

url

string(500)
The URL to the listing in the shop.

Yes

restricted

boolean
`true` if this is a listing that requires an acquisition permit (EWB). `false` in all other cases.
If this attribute is not provided, we will try to make a determination based on the other available information.

No

variants

integer(2)
A positive number indicating how many variants of this listing exist.

No

Here is a simple description of the format in TypeScript:

interface GunfinderDataItemProps {
  id: string;
  type?: 'buynow' | 'auction' | 'buynow-auction';
  title: string;
  brand?: string;
  description: string;
  condition: 'new' | 'used';
  availability: 'in-stock' | 'preorder' | 'out-of-stock' | 'limited';
  pictures?: string[];
  tags?: string[];
  price: number;
  oldPrice?: number;
  url: string;
  restricted?: boolean;
  variants?: number;
}

const data: GunfinderDataItemProps = [{ ... }, ...];

Non-Standard Formats

If you have a product data feed that doesn't match any of the formats listed here, we can of course handle that too. However, the implementation effort is considerably higher and may take several weeks, as it requires a custom integration.

Was this article helpful?
Thanks for your feedback!
Need more help? Contact Support

You might also like