Gunfinder product data feeds: create data feed for your shop
Gunfinder is a meta search engine that helps hunters and sport shooters quickly find the desired product at the right price. If you run an online shop, Gunfinder can automatically include your offers in the search. What we need for this is a product data feed from your shop. Below you will find all the formats we support.
Known Shop Solutions
There are some ready-made shop solutions that Gunfinder can connect to with little effort.
You can find instructions for the most common shops here:
If your shop is not listed here, feel free to send us an email and we will take care of writing instructions for your shop as well.
Google Shopping
Google Shopping is a widely used format to share 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 also supports this format.
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 here.
More information about Google Shopping can be found directly from 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 equipped with this functionality through 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 you are already a member of an affiliate network with your shop, just provide us with a data feed from there.
If you are not yet a member of an affiliate network but are interested, feel free to contact our partner AdCell. We have been working successfully with AdCell for several years. AdCell is known not only for excellent customer support but also for the smooth onboarding and support of firearms dealers.
The Gunfinder Format
To get listing data into our search engine as easily as possible, we of course also offer our own format. The following table briefly describes all possible fields/attributes. Possible file formats are JSON and CSV.
Please use JSON whenever possible and only CSV in emergencies.
Attribute |
Description |
Required |
|---|---|---|
id |
sting(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 format
If you have a product data feed that does not match one of the formats listed here, we can of course still read it. However, the effort for implementation is significantly higher and can take several weeks, as an individual adjustment is required.