JSON : Merchants / Stores List

Wiki Documentation : List of Parameters : Live Demo

To get a JSON formated list of your selected list of merchants at DFF, just do an HTTP (POST or GET) request to the following address:


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

Affiliate ID:    

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 Web Services. Here is list of variable that you need to specify when requesting a JSON data feeds.
affidYAffiliate ID, is a unique identifier number for each DFF affiliate account
dfftokenYYour unique DFF Token. Generate this unique DFF Token string of characters from your Affiliate Control Panel > Settings > DFF Token.
keywordNSearch Keyword Phrase, is the keyword(s) you would like to perform the search against merchant name.
sortNChange the sort order of search result. Default is 'name' which sorts ascending by merchant / store name. The rest of the sort options are name=MERNAME, number=MERNUM, product=PRODUCTS_COUNT, random=RANDOM ORDERING
cat1numN1st Level Category Number, is the category number to filter and show only merchants from that particular category
flNfl stands for first letter. Specifying this parameter will filter the search result to only show merchants with the specified first letter (not case sensitive). Example: fl=A will output only merchant names staring with A, such as Apple.
retcatNretcat stands for return category array. Return category array with result or not? To enable set to 1. By default retcat is turned off. Example: retcat=1
retdealNretdeal stands for return deal array. Return deal array with result or not? To enable set to 1. By default retdeal is turned off. Example: retdeal=1
retflNretfl stands for return first letter array. Return first letter array with result or not? To enable set to 1. By default retfl is turned off. Example: retfl=1
limitNnumber of merchants 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)
ret_limited_onlyNreturns only limited search results according to the quantity of limit parameter. By setting this field to 1 or Y will tell the web service not to return the filtered array, but still return stats and limited arrays. Defaults to off (nothing set / blank). However if the 'filtered' array returns more than 100 records, the 'filtered' will be empty and 'limited' will be automatically used and limited to 100 records.
pageNjump to certain page number. If not specified will default to page 1.
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

Usage Notes

1. Do to the fact that this web-service may return thousands of merchant records and TONS of data, we have automatically limit amount of records returned. If at any given time your query result exceed 100 records, this web service will automatically limit result to 100 records only and make the results available in the 'limited' array.


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 token and use this in the dfftoken variable.

< Back to DataFeedFile.com