Gunfinder Product Data Feeds: Create a Data Feed for Your Shop
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) |
Yes |
type |
enum(buynow, auction, buynow-auction) |
No |
title |
string(255) |
Yes |
brand |
string(255) |
No |
description |
string(5000) |
No |
condition |
enum(new, used) |
Yes |
availability |
enum(in-stock, preorder, out-of-stock, limited) |
Yes |
pictures |
string[] |
No |
tags |
string[] |
No |
price |
float |
Yes |
oldPrice |
float |
No |
url |
string(500) |
Yes |
restricted |
boolean |
No |
variants |
integer(2) |
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.