JSON : Deal Search Engine (DSE) (Rebates, Coupons, Deals)

JSON response example | DSE documentation | DSE Demo | DSE parameters

You have the flexibility to parse and output our JSON data feed. Simply submit a request to this address:


This JSON example demonstrate the JSON data feed capability provided by DataFeedFile.com

affiliate id Merchant Number:    

Request Variables

In order for you to get JSON data feed, there are some request variables that you need to submit to Datafeedfile.com JSON Service. Here is list of variable that you need to specify when requesting a JSON data feed.
affidYAffiliate id, is a unique identifier number for each affiliate account
dfftokenYYour unique DFF Token. Generate this unique DFF Token string of characters from your Affiliate Control Panel > Settings > DFF Token.
typeNfilter the deal search result to certain deal type only.
  • p or popular = show all discounts ordered by popularity
  • r or rebate = show rebates
  • c or coupon = show coupon codes
  • d or discount = show discounts
  • fs or free shipping = show free shipping
  • f or freebie = show Freebies
  • xy or buyxgety = show Buy X Get Y
  • rc = show rebate + coupon
  • rd = show rebate + discount
  • cd = show coupon + discount
keywordNfilter the deal result by certain keyword
limitNnumber of deals to show per page (make sure you set this parameter first before setting page). if not specified will default to limit = 20.
offsetNjump to offset record #.... (make sure not to use this at the same time with page)
pageNjump to certain page number. If not specified will default to page 1. Do not use this page parameter with offset because they will conflict and cancels out each other.
group_byNcontrols the grouping of deal search result.
Possible values of 'group_by' are:
  • posted_date
  • expiration_date
  • stores
  • category
  • type

When group_by is used, grouped data will be located in [grouped] array or section.
Grouped data are a subset of filtered + limited, meaning they are always filtered and limited already.
category_nameNset to certain category name, enter the full first level DFF category name such as 'Computer Hardware'. Make sure you URL encode the category name before placing it on the URL query string, for example 'Computer Hardware' should become URL Encoded to 'Computer+Hardware'.
mernumNMerchant Number, is the merchant / store number used by DataFeedFile.com to narrow search to a particular merchant only.
posted_dateNshow only deals posted / created on this date. Use MM/DD/YYYY format. make sure you encode / to %2F.
posted_last_n_daysNshow only last N number of days' deals
expire_last_n_daysNshow only deals expiring in N day(s).
dealnumNshow only this ONE deal number
compressNPut value 'gzip' to use gzip zlib compression algorithm. You must de-compress when receiving data before decoding the JSON. Compression is optional but recommended. Example: &compress=gzip
For more detailed list of options you can use go to our WIKI about DFF DSE parameters.


1. Please make sure your JSON access DFF Token is ACTIVE. To activate and generate token you must login and go to Settings > DFF Token.

2. Set the Requesting IP address of the computer / server / client that will be used to make the query. Set IP at Settings > DFF Token.

3. Generate dfftoken variable. You must go to Settings > DFF Token to generate an JSON access DFF Token and use this in the dfftoken variable.

< Back to DataFeedFile.com