--- title: Getting to know the Wildfire JSON Data Feeds slug: article/bbiw-getting-to-know-the-wildfire-json-data-feeds description: Learn how to create an engaging offer wall using Wildfire JSON feeds with this helpful document. It provides a step-by-step walkthrough, references, and a comprehensive explanation of the various types of feeds, including merchant-rate, coupon, and more. docTags: WX-732KZOub96_R0NW2HX createdAt: 2022-08-04T17:30:23.000Z --- Wildfire provides data in easy to use, regularly refreshed JSON feeds about its merchants, offers, & coupons. These data feeds can be used to create custom user experiences (i.e. offer walls). # JSON Feeds Overview All URLs are in the format of `https://www.wildlink.me/data/[[APP_ID]]/[[TYPE]]/[[VERSION]]` where `APP ID` is the application ID, `TYPE` is one of the types described below and `VERSION` is the data format version. The only version is 1 for all these feeds. :::hint{type="warning"} **Note**: All JSON Feed URLs will redirect to the most recent generated snapshot file. Wildfire regenerates these snapshots every \~6 hours. As a result, it's important to not reference the snapshot but rather the JSON feed. A snapshot file URL will look like the following: `https://storage.googleapis.com/wildlink/cloud-db/1/[[APPLICATION_ID]]/merchant-rate/en-US-2025-04-17T022504.424.model.json` Whereas a JSON feed will look like this: `https://www.wildlink.me/data/[[APPLICATION_ID]]/merchant-rate/1` ::: # Types of Wildfire JSON Feeds | JSON FEED (TYPE) | Description | Version | Example | | --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------- | ------------------------------------------------------------------------------------ | | **merchant-rate** | Commission rate data for all merchants, including exclusions. | 1 | Example: `https://www.wildlink.me/data/[[APPLICATION_ID]]/merchant-rate/1` | | **coupon** | Promotions, coupon codes and related metadata. | 1 | Example: `https://www.wildlink.me/data/[[APPLICATION_ID]]/coupon/1` | | **active-domain** | Active merchant domains (domains may be many to one in relation to merchant). More information about working with the Wildfire active domain feed can be found here | 1 | Example: `https://www.wildlink.me/data/[[APPLICATION_ID]]/active-domain/1` | | **merchant** | Merchant info/metadata including logos, lifestyle/featured images, categories, serviceable countries, merchant score, and special feature restriction flags.   | 1 | Example: `https://www.wildlink.me/data/[[APPLICATION_ID]]/merchant/1`
**** | | **category** | Category tree of where a merchant falls. Ex: Health & Beauty, Sports, Electronics | 1 | Example: `https://www.wildlink.me/data/[[APPLICATION_ID]]/category/1` | | **featured-merchant** | Wildfire curated list of merchant IDs that are top brands. The featured merchant feed is not generated for all applications. If you require this feed for your application, please [contact us](https://www.wildfire-corp.com/contact-us). | 1 | Example: `https://www.wildlink.me/data/[[APPLICATION_ID]]/featured-merchant/1`
| | **stand-down-policy** | Required if you are using our API's to build your own Browser Extension. Browser extensions are subject to stand-down policy compliance and Google SERP decoration policies.The stand-down-policy feed provides arrays of data related to honoring the affiliate network policies to avoid marketing to users that are already affiliated with another publisher:
1. "Domains" contains the list of redirect domains.  If a user is redirected through one of these, the browser extension must stand-down.
2. "Params" contains the list of query parameters.  If a user is redirected through a URL containing one of these parameters, the browser extension must stand-down.
More information about stand down policies can be found here: [Stand-Down Policy Compliance](docId:6WKYMsrIFCEA6Pj0GYR3j)
| 1 | Example: `https://www.wildlink.me/data/[[APPLICATION_ID]]/stand-down-policy/1` | :::hint{type="info"} **Note**: The stand-down-policy JSON feed may include other sections like "Serp" and "LostAttribution" but these don't apply to API implementations like offer walls. They only apply to browser extensions. **Also note**: Extension Launchpad references all the stand-down-policies and uses them to automatically comply with stand down policies. ::: ![](https://api.archbee.com/api/optimize/wthfaKSfl2GjN63-tET7T/ly5gmXD0pL5O-tZ7yllvk_json-feeds-erd-selection.png) :::ExpandableHeading ### Merchant Sample JSON Response ```javascript **"ID": 5481548, ** "Name": "Ray-Ban", "PaysNewCustomersOnly": false, "ShareAndEarnDisabled": false, "SERPInjectionDisabled": false, "BrowserExtensionDisabled": false, ** "Categories": [ { "ID": 1, "Name": "Clothing & Apparel", "ParentID": 0 }, { "ID": 45, "Name": "Accessories", "ParentID": 1 }, { "ID": 22, "Name": "Health & Beauty", "ParentID": 0 }, { "ID": 182, "Name": "Contacts & Glasses", "ParentID": 22 }, { "ID": 72, "Name": "Sunglasses", "ParentID": 45 }, { "ID": 175, "Name": "Personalized gifts", "ParentID": 12 }, { "ID": 12, "Name": "Gifts", "ParentID": 0 }, { "ID": 70, "Name": "Jewelry", "ParentID": 45 } ], ** "Countries": [ "CA", "GU", "PR", "US", "BR", "AU", "NZ" ], ** "Images": [ { "ID": 1811, "Kind": "LOGO", "Ordinal": 1, "ImageID": 1811, "URL": "https://storage.googleapis.com/wl-image/36f4e7993efd03ac5c66740ff53014f5eeb2d0fc", "Width": 200, "Height": 200 }, { "ID": 34489, **"Kind": "FEATURED", "Ordinal": 1, "ImageID": 34489, "URL": "https://storage.googleapis.com/wl-image/b477545b612fa22ab564fe9993f0f4d0d763c05d", "Width": 660, "Height": 380 }, { "ID": 46435, "Kind": "FEATURED", "Ordinal": 1, "ImageID": 46435, "URL": "https://storage.googleapis.com/wl-image/ac21cfba44be418cef4588d595d95d461f11a48b", "Width": 660, "Height": 380 }, { "ID": 46464, "Kind": "LOGOTRANSPARENT", "Ordinal": 1, "ImageID": 46464, "URL": "https://storage.googleapis.com/wl-image/7eb484c5a90e219d1857896af05efaf711c0e4b3", "Width": 560, "Height": 232 }, { "ID": 3699, "Kind": "LOGORECT", "Ordinal": 20, "ImageID": 3699, "URL": "https://storage.googleapis.com/wl-image/d9e3110870180dc36584a130ed4457d5380acc3b", "Width": 260, "Height": 200 } ], ** "Score": 0.257258, ** "PrimaryCategoryID": 72, "URL": "https://www.ray-ban.com/usa" }, ``` ::: :::ExpandableHeading ### Merchant Rate Sample JSON Responses Merchant Rate ```javascript ##Multiple Rates per Merchant## { "100196": [ { "ID": 199860, "Name": "New Customer Purchase (Excluding Gift Cards or Purchase with Restricted Promo Code)", "Kind": "PERCENTAGE", "Amount": "2" }, { "ID": 321505, "Name": "Returning Customer Purchase (Excluding Gift Cards or Purchase with Restricted Promo Code)", "Kind": "PERCENTAGE", "Amount": "2" }, { "ID": 364990, "Name": "New Customer Purchase (Excluding Gift Cards or Purchase with Restricted Promo Code)", "Kind": "PERCENTAGE", "Amount": "15" } ], "100199": [ { "ID": 69399, "Name": "Online Purchase (Excluding Duplicate Orders)", "Kind": "PERCENTAGE", "Amount": "25" } ] "100208": [ { "ID": 69393, "Name": "Sports Equipment", "Kind": "PERCENTAGE", "Amount": "3.85" }, { "ID": 69396, "Name": "Technology", "Kind": "PERCENTAGE", "Amount": "1.54" }, { "ID": 69397, "Name": "Online Purchase", "Kind": "PERCENTAGE", "Amount": "4.61" }, ## Flat Rate ## { "ID": 318426, "Name": "Subscription Purchase", "Kind": "FLAT", "Amount": "30", "Currency": "USD" }, ## EXCLUSIONS ## { "ID": 193568, "Name": "Juliana Products, Reserve Products, Santa Cruz Products, Cannondale Products, Gazelle Products, or Cervelo Products Purchase", "Kind": "PERCENTAGE", "Amount": "0" } ``` ::: :::ExpandableHeading ### Active-Domain Sample JSON Response ```javascript [ { "ID": 5834, ** "Domain": "verizon.com", "Merchant": { ## Key to Join from Merchant Table## "ID": 6738, "Name": "Verizon", ** "MaxRate": { "Kind": "FLAT", "Amount": "100", "Currency": "USD" } } }, { "ID": 5513127, "Domain": "philo.com", "Merchant": { "ID": 6739, "Name": "Philo", "MaxRate": { "Kind": "FLAT", "Amount": "20", "Currency": "USD" } } }, { "ID": 5783, "Domain": "89thandmadison.com", "Merchant": { "ID": 6744, "Name": "89th + Madison", "MaxRate": { "Kind": "PERCENTAGE", "Amount": "6" } } }, { "ID": 5784, "Domain": "525america.com", "Merchant": { "ID": 6745, "Name": "525 America", "MaxRate": { "Kind": "PERCENTAGE", "Amount": "5" } } ``` ::: :::ExpandableHeading ### Coupon Sample JSON Response Our Coupon Feed is a Raw JSON Feed. Recommended Approach is a caching and normalization layer to ensure a clean front end UI experience. **Typical Response: ** ```javascript { "ID": 4787950, "Description": "20% off Our Best Selling Relief Rub with Emu Oil and 2000mg CBD.", "Code": "F464G6PF", "MerchantID": 162205, "Countries": null, "Exclusions": "N/A", "StartDate": "2023-04-12T04:00:00Z", "EndDate": "2050-12-31T05:00:00Z", "Disabled": false }, { "ID": 4793934, "Description": "Customers can get 10% off for their first order at SUNNY SHOWER.", "Code": "NEW10", "MerchantID": 153529, "Countries": null, "Exclusions": "This coupon can only be used once per person, and it cannot be used in conjunction with other discounts", "StartDate": "2023-11-02T04:00:00Z", "EndDate": "2028-12-31T05:00:00Z", "Disabled": false }, ``` Expect to see a non-english response such as: ```javascript "ID": 5454164, "Description": "Haz que tu escapada de septiembre sea aún más especial con The Excellence Collection y disfruta de un descuento exclusivo del 5 % utilizando el código promocional que te ofrecemos.\n \n Ya sea que planees una escapada romántica solo para adultos o unas vacaciones familiares inolvidables, descubre hermosas playas, estancias de lujo, una oferta gastronómica excepcional y experiencias memorables en los hoteles de The Excellence Collection.\n \n Hoteles participantes:\n \n - Beloved Playa Mujeres\n - Excellence Playa Mujeres\n - Finest Playa Mujeres\n - Excellence Riviera Cancun\n - Excellence Oyster Bay\n - Excellence El Carmen Punta Cana\n - Excellence Punta Cana\n - Finest Punta Cana Terms and Conditions: - Oferta válida para reservas durante septiembre de 2026.\n - Oferta válida para estancias desde septiembre de 2026 hasta febrero de 2027.", "Code": "VIP5", "MerchantID": 193292, "Countries": null, "Exclusions": "", "StartDate": "2026-09-01T10:59:15Z", "EndDate": "2026-09-30T23:59:59Z", "Disabled": false }, ``` You will also encounter "sales" - Promos with no code. Or instances where the code is nested in the description ```javascript { "ID": 5467427, "Description": "Famous Cigars Sampler Spotlight: Get this 20 count All Wrapped Up Cigar Sampler for only $99.95 - that's 53% off - Shop now.", "Code": "", "MerchantID": 5477679, "Countries": null, "Exclusions": "", "StartDate": "2026-09-11T04:00:00Z", "EndDate": "2026-09-18T03:59:00Z", "Disabled": false }, ``` Lastly, you should expect to handle "Always valid" sales and codes. Typically Merchants send discounts that never expire with a year 3000 end date. ```javascript { "ID": 1788955, "Description": "Shop at lionenergy.com and get 10% off your order! Use code PJ10 at checkout.", "Code": "PJ10", "MerchantID": 113605, "Countries": null, "Exclusions": "no", "StartDate": "2021-11-02T00:00:00Z", "EndDate": "3000-01-04T00:00:00Z", "Disabled": false }, ``` ::: # Frequently Asked Questions 1. **Q:** **Do the JSON feed files have the same content as the Wildfire API?** **A: **All merchant data and metadata, except for commission data, device creation and vanity URL creation, is shared with WF partners via JSON feeds. These feeds are updated about every six hours. [More Documentation about the API can be found here ](https://documenter.getpostman.com/view/24961/RWgqVyV2) 2. **Q: Does downloading the JSON feed require authentication?** **A:** No, just make sure you’re using your specific JSON feed with your client application number embedded in the link. This application ID and credentials will be provided to you by the Client Success during the onboarding process. For example: `https://www.wildlink.me/data/[[CLIENT_APPLICATION_ID_HERE]]/merchant-rate/1` 3. **Q: If I set up a batch to pull the data, what are the recommended times or frequency?** **A: **Once per 24 hrs is usually sufficient. Merchants don't update their rates, coupons, etc. very often. Coupons data is the most quick to change so if you'd like to ensure you have the most recent data you may wish to pull it every six hours. 4. **Q: Which time zone do the JSON feeds use?** **A:**  All JSON feeds with date references use UTC. 5. **Q:** **In the merchant rate feeds, if a rate is not represented as a percentage, is it in a currency format?** **A: **There are two kinds of rates in the merchant-rate feed - `PERCENTAGE` and `FLAT` . Where a commission rate is a flat payout, that value is US Dollar (USD), Euro (EUR), Canadian Dollar (CAD), etc as represented by the “Currency” value in the JSON response for each rate. 6. **Q: Can I download JSON feeds just once?** **A**: While it's fine to cache JSON feed data (i.e. our list of merchants) the data does change frequently and it's appropriate to refresh (re-download) it at a regular interval. Though merchants rarely ever change their name, new merchants come online and go offline (i.e. suspend their affiliate program) all the time. Similarly, merchants regularly change their commission rates, coupons, etc.. By regularly requesting the JSON feeds you can ensure you have an up-to-date representation of our merchant programs. # Walkthrough of creating an offer wall ::embed[]{url="https://youtu.be/Sw_5db7QNRw"} ## References - Step 1 : [https://storage.googleapis.com/wildli...](https://www.youtube.com/redirect?event=video_description\&redir_token=QUFFLUhqbk54emp4d2xiQ1pzNnpQc3B3VTZldmFXNnJKQXxBQ3Jtc0ttLVYyWXNoSld5SEppdU1QNEcxWDJLbjZwYjdRcVlHYXZqWmozcVBLYW14Ri1DNk4tb0dIQVI4am9rWC1tVE1rT2FmOWpPLU1HUXpzX01ObjJzakd2WmphQjdtUkhTUDdac2JzamhjOGFURFFHVnhwdw\&q=https%3A%2F%2Fstorage.googleapis.com%2Fwildlink%2Fweb%2Fsupport%2Fofferwall-example%2Fstep1.php\&v=Sw_5db7QNRw) - Step 2 : [https://storage.googleapis.com/wildli...](https://www.youtube.com/redirect?event=video_description\&redir_token=QUFFLUhqbmZNcF9GcHJXNmV0WmphbjBVNTljSEN5dWQ0QXxBQ3Jtc0tud1ZfUk5fVDdPUFJFNUFScGZmNFY1T294dHNEay1la1FnWGc5TTlIMW5ramhTam0tcWtfbXJadXVURTQtTEg2bVR4OW1ESmkxLTFnenVQZ3lXYW1wQ0EwSWZMLWI4Q0J6QWRfVGFqRGNrTWNxX2hBdw\&q=https%3A%2F%2Fstorage.googleapis.com%2Fwildlink%2Fweb%2Fsupport%2Fofferwall-example%2Fstep2.php\&v=Sw_5db7QNRw) - Step 3 : [https://storage.googleapis.com/wildli...](https://www.youtube.com/redirect?event=video_description\&redir_token=QUFFLUhqbTRjaDFMRjFoTUxzVTdMZEJ3MlBqbldJejRnd3xBQ3Jtc0tsMjhpaUpMS0VicXFxRlppVEdHbTFWMFkwUkgxLUhxQTB0RDVYUFJLNmtpUmFLTW9jZ3hzRWNEeDNYVTFUWFVXZk5mNWpJbmt5VjhHUkQ4a0F0Wi0xaXF0cFVyMGd1bDR2NTQ2N3FkMWQ2QUxPUFNMTQ\&q=https%3A%2F%2Fstorage.googleapis.com%2Fwildlink%2Fweb%2Fsupport%2Fofferwall-example%2Fstep3.php\&v=Sw_5db7QNRw) #