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 20, 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.

Supported Shop Solutions

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

If your shop isn't listed here, feel free to send us an email and we'll take care of writing 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 equipped with this functionality through a plugin. That's why Gunfinder supports this format too.
The easiest way, if your shop already supports Google Shopping, is to provide us with a data feed in this format. We accept both XML and CSV.
For more information about Google Shopping, visit Google directly.

Idealo

Idealo is a well-known price comparison engine. Many shop solutions such as JTL or Shopware already support the Idealo format out of the box, or can easily be equipped with this functionality via a plugin. That's why Gunfinder also supports this format.
The easiest way — if your shop already supports the Idealo format — 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, simply provide us with 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 reach out to 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 its smooth onboarding and ongoing support of firearms retailers.

The Gunfinder Format

To get listing data into our search engine as easily as possible, we of course offer our own format as well. 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 the listing is discounted, the original price can be provided here.

No

url

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

Yes

restricted

boolean
`true` if the listing requires an acquisition permit (EWB). `false` in all other cases.
If this attribute is not provided, we will attempt 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 one of the formats listed here, we can of course handle that too. However, the implementation effort is significantly higher and can take several weeks, as a custom integration is required.

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

You might also like