Getting to know the Wildfire JSON Data Feeds
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).
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.
Commission rate data for all merchants, including exclusions. Example: https://www.wildlink.me/data/[[APPLICATION_ID]]/merchant-rate/1
Promotions, coupon codes and related metadata. Working with Wildfire Coupon Data. Example: https://www.wildlink.me/data/[[APPLICATION_ID]]/coupon/1
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: Merchants and Domains Example: https://www.wildlink.me/data/[[APPLICATION_ID]]/active-domain/1
Merchant info/metadata including logos, lifestyle/featured images, categories, serviceable countries, merchant score, and special feature restriction flags. Example: https://www.wildlink.me/data/[[APPLICATION_ID]]/merchant/1
Merchant category tree Example: https://www.wildlink.me/data/[[APPLICATION_ID]]/category/1
Wildfire curated list of merchant IDs that are top brands. Example: https://www.wildlink.me/data/[[APPLICATION_ID]]/featured-merchant/1 The featured merchant feed is not generated for all applications. If you require this feed for your application, please contact us.
Browser extensions are subject to stand-down policy compliance and Google SERP decoration policies. Example: https://www.wildlink.me/data/[[APPLICATION_ID]]/stand-down-policy/1 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:
- "Domains" contains the list of redirect domains. If a user is redirected through one of these, the browser extension must stand-down.
- "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
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.
- 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
- 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
- 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.
- Q: Which time zone do the JSON feeds use? A: All JSON feeds with date references use UTC.
- 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.
- 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.
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).
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.
Commission rate data for all merchants, including exclusions. Example: https://www.wildlink.me/data/[[APPLICATION_ID]]/merchant-rate/1
Promotions, coupon codes and related metadata. Working with Wildfire Coupon Data. Example: https://www.wildlink.me/data/[[APPLICATION_ID]]/coupon/1
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: Merchants and Domains Example: https://www.wildlink.me/data/[[APPLICATION_ID]]/active-domain/1
Merchant info/metadata including logos, lifestyle/featured images, categories, serviceable countries, merchant score, and special feature restriction flags. Example: https://www.wildlink.me/data/[[APPLICATION_ID]]/merchant/1
Merchant category tree Example: https://www.wildlink.me/data/[[APPLICATION_ID]]/category/1
Wildfire curated list of merchant IDs that are top brands. Example: https://www.wildlink.me/data/[[APPLICATION_ID]]/featured-merchant/1 The featured merchant feed is not generated for all applications. If you require this feed for your application, please contact us.
Browser extensions are subject to stand-down policy compliance and Google SERP decoration policies. Example: https://www.wildlink.me/data/[[APPLICATION_ID]]/stand-down-policy/1 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:
- "Domains" contains the list of redirect domains. If a user is redirected through one of these, the browser extension must stand-down.
- "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
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.
- 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
- 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
- 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.
- Q: Which time zone do the JSON feeds use? A: All JSON feeds with date references use UTC.
- 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.
- 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.
