Coupon Data JSON Structure - Wildfire Support Center

Coupon Data JSON Structure

Introduction Introduction

This document provides an overview of the JSON structure used to store coupon data for various merchant websites. The JSON file contains information about coupon codes and CSS selectors used for auto-applying coupons on specific merchant websites.

Usage Usage

The JSON data is used to facilitate Wildfire Partners to deliver custom coupon codes to our extensions. The extension will retrieve this data on a regular cadence in order to include your custom coupon codes and targets into your extension. The Codes section provides a list of available coupon codes, while the Targets section provides CSS selectors for automating coupon application on websites that are not yet supported.

Wildfire Coupon Data JSON Feed: 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: Expected Fields:

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 shipping or sitewide sale)

Important Notes:

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 JSON Structure

The JSON file is organized into an object where each key represents a merchant website's domain name. The structure consists of two primary sections:

  1. Codes: This section contains an array of coupon codes associated with the merchant website.

  2. Targets (optional): This section contains an array of CSS selectors that are used to automatically apply coupons on the merchant website. The targets object is only needed if wildfire doesn’t already support this domain and auto coupon application is desired.

Example Example

Below is an example of the JSON structure:

{
  "merchant_domain_1.com": {
    "Codes": [
      {"ID": 1, "Code": "SAVE15"},
      {"ID": 2, "Code": "FREESHIP"},
      {"ID": 3, "Code": "25OFF"}
    ],
    "Targets": [
      {
        "Input": "#coupon-input",
        "Price": ".total-price",
        "Submit": ".apply-button",
        "Remove": ".remove-button",
        "Error": ".error-message",
        "Before": ".before-coupon-action"
      }
    ]
  },
  "merchant_domain_2.com": {
    "Codes": [
      {"ID": 4, "Code": "DISCOUNT4"},
      {"ID": 5, "Code": "SAVINGS5"}
    ]
  }
  // Additional merchant domains...
}

Code Section Code Section

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

Targets Section Targets Section

The Targets section for each merchant domain contains an array of target objects. Each target object consists of CSS selectors used for specific actions:

Note Note

Summary 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:

Updated 16 Jun 2026