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) 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 note all json feed urls will redirect to the most recent generated snapshot file wildfire regenerates these snapshots every few 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 "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 6wkymsrifcea6pj0gyr3j 1 example https //www wildlink me/data/\[\[application id]]/stand down policy/1 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 merchant sample json response "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" }, merchant rate sample json responses merchant rate ##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" } active domain sample json response \[ { "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" } } 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 { "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 "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 { "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 { "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 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 walkthrough of creating an offer wall 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