Coupon Data JSON Structure

6 min

Wildfire Coupon Data JSON Feed:

Available coupon data is located at the Wildfire Coupon JSON feed:https://www.wildlink.me/data/APPLICATION_ID/coupon/VERSION

Ensure APPLICATION_ID is your application ID & VERSION is the version of the feeds you wish to invoke. This data feed includes coupon codes and promotions for many of our merchant partners.

Expected Fields:

ID and Merchant ID: ID is the unique identifier for the coupon or promotion, and the Merchant ID is the associated merchant reference for the coupon/promo.

Description: Contains details about the offer or promotion. In some cases, the coupon code may also appear in this field. Some merchants do not provide structured or consistent descriptions, especially for coupon-based offers.

For Wildfire-built products: Wildfire handles this on behalf of our partners.

For partner-built products: partners may need to normalize or clean up descriptions before displaying them in the UI.

Code: When provided, this field contains the coupon code entered at checkout to apply the discount.

Note: This field may sometimes be blank or show null.

For Wildfire-built products: Wildfire handles this on behalf of our partners.

For Partner-built products: Use the table below to determine how to interpret offer data

Scenario	Code Field	Description Field	Action Required
Code only in description	Blank or null	Contains code	Extract code from description
Code in both fields	Contains code	Contains code	Use Code Field (preferred source)
No code provided	Blank or null	No code listed	No code required; discount applies automatically (e.g. free shiping or sitewide sale)

Countries: List of country codes where the merchant indicates the coupon can be used.

May include "International"

May be null if not specified

Important Notes:

The Wildfire coupon feed is not filtered by country

The JSON feed does not include a direct coupon-to-country relationship

For Wildfire-built products: Wildfire manages country filtering

For Partner-built products: Partners must control which coupons are displayed by count

Languages: While Network Merchants sets the applicable countries for offer codes, they can still pass coupons available for that country in different languages. For partner-built products, partners must manage the display of applicable language.

i.e: A network merchant can pass US coupons & promos, but that does not mean eligible coupons are exclusively in English. The eligible US coupons can be in French or Spanish, etc.

Exclusions: Some merchants explicitly list restrictions or exclusions (e.g., brands, categories, regions).More commonly, eligibility details are included within the Description field

Start Date / End Date: Defines when the coupon is valid.

May include future start dates (“coming soon” promotions)

May include expired promotions

Some merchants use very long end dates (e.g., year 3000) to indicate no expiration

For Wildfire-built products: Wildfire manages validity filtering

For Partner-built products: Partners must display only currently valid coupon

Feed Regeneration Cadence: Wildfire regenerates coupon data approximately every 6 hours. Plan caching and refresh logic accordingly to ensure accurate and timely offers.

JSON Structure

Example

Below is an example of the JSON structure:

  {
    "ID": 4772901,
    "Description": "simplycodes website exclusive 15% off discount for all products, which already began and will be permanent.",
    "Code": "SIMPLYCODES15",
    "MerchantID": 98124,
    "Countries": null,
    "Exclusions": "Do not bid our brand keywords for PPC",
    "StartDate": "2023-09-05T00:00:00Z",
    "EndDate": "2050-12-31T00:00:00Z",
    "Disabled": false
  },
  {
    "ID": 4772896,
    "Description": "BestRealDoll influencer promotion 12% Off for all products, which already began and will be permanent.",
    "Code": "Alec",
    "MerchantID": 98124,
    "Countries": null,
    "Exclusions": "Do not bid our brand keywords for PPC",
    "StartDate": "2023-03-30T00:00:00Z",
    "EndDate": "2050-12-31T00:00:00Z",
    "Disabled": false
  },
  {
    "ID": 4772893,
    "Description": "BestRealDoll influencer promotion 10% Off for all products, which already began and will be permanent.",
    "Code": "Lara",
    "MerchantID": 98124,
    "Countries": null,
    "Exclusions": "Do not bid our brand keywords for PPC",
    "StartDate": "2023-03-28T00:00:00Z",
    "EndDate": "2050-12-31T00:00:00Z",
    "Disabled": false
  },
  {
    "ID": 4772890,
    "Description": "theporndata Website Exclusive 15% Off Discount.",
    "Code": "TPD15",
    "MerchantID": 98124,
    "Countries": null,
    "Exclusions": "Do not bid our brand keywords for PPC",
    "StartDate": "2023-09-05T00:00:00Z",
    "EndDate": "2050-12-31T00:00:00Z",
    "Disabled": false
  },
  {
    "ID": 4772889,
    "Description": "kotag discount website exclusive 15% off discount for all products, which already began and will be permanent.",
    "Code": "KBRDX1",
    "MerchantID": 98124,
    "Countries": null,
    "Exclusions": "Do not bid our brand keywords for PPC",
    "StartDate": "2024-04-12T00:00:00Z",
    "EndDate": "2050-12-31T00:00:00Z",
    "Disabled": false
  },

Code Section

The Codes section for each merchant domain contains an array of coupon objects. Each coupon object consists of:

ID: A unique identifier for the coupon.

Code: The actual coupon code.

Note

This JSON structure is adaptable and can be extended to accommodate additional merchant domains as needed.

It is essential to keep this JSON file updated with the latest coupon codes and target selectors to ensure proper functionality across various merchant websites.

Summary

Wildfire's coupon data feed is raw data and may contain expected anomalies. This raw data provides all Wildfire partners with the maximum number of savings opportunities to present to their users. For Wildfire-built products, these nuances are handled on behalf of our partners.

For partner-built products, partners must manage the following:

Extract specific coupon code patterns from descriptions

Refine dates shown to users; Specifically for the no-expiration date codes and promos

Handling Countries; Specifically, the translation of eligible coupons from non-official languages to the official language, if desired.