Wildfire APIs
Getting to know the Wildfire JSON Data Feeds
20min
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) walkthrough of creating an offer wall references step 1 https //storage googleapis com/wildli step 2 https //storage googleapis com/wildli step 3 https //storage googleapis com/wildli 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 types of wildfire json feeds merchant rate commission rate data for all merchants, including exclusions example https //www wildlink me/data/\[\[application id]]/merchant rate/1 coupon promotions, coupon codes and related metadata working with wildfire coupon data docid\ ja2byx6fk44e3vc7rekjm 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 merchants and domains docid\ dqtk9k9qdr e76dt0g9zy 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 example https //www wildlink me/data/\[\[application id]]/merchant/1 category merchant category tree example https //www wildlink me/data/\[\[application id]]/category/1 featured merchant 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 https //www wildfire corp com/contact us stand down policy 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 docid\ y2vt5fdrdef7tyncqe gs 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 frequently asked questions 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 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) walkthrough of creating an offer wall references step 1 https //storage googleapis com/wildli step 2 https //storage googleapis com/wildli step 3 https //storage googleapis com/wildli 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 types of wildfire json feeds merchant rate commission rate data for all merchants, including exclusions example https //www wildlink me/data/\[\[application id]]/merchant rate/1 coupon promotions, coupon codes and related metadata working with wildfire coupon data docid\ ja2byx6fk44e3vc7rekjm 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 merchants and domains docid\ dqtk9k9qdr e76dt0g9zy 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 example https //www wildlink me/data/\[\[application id]]/merchant/1 category merchant category tree example https //www wildlink me/data/\[\[application id]]/category/1 featured merchant 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 https //www wildfire corp com/contact us stand down policy 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 docid\ y2vt5fdrdef7tyncqe gs 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 frequently asked questions 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 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