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.
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) |
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 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.