Coupon Datafeed

Access clean, vetted promotional content via our coupon API.

Coupon Endpoint

API Method

All API calls are made using the GET HTTP method.

API Authentication

Your API token is your Feeds4 authentication token that is passed to our service via the API url. The curly brackets shown are not part of your token and are used for display purposes only.

Base URL:

https://api.feeds4.com/v2/coupons/

Append your API token: Here is how to authenticate with the Feeds4 API:

https://api.feeds4.com/v2/coupons/?token={API TOKEN}

API Recordset

How many coupon records returned by our service depends on the recordset parameter. There are three accepted coupon recordset inputs: test (default), increment and all.

  • test – returns 10 results and is used primarily for testing.
  • increment – returns all results since your last request.
  • all – returns all results matching your request.
https://api.feeds4.com/v2/coupons/?token={API TOKEN}&recordset=test
https://api.feeds4.com/v2/coupons/?token={API TOKEN}&recordset=increment
https://api.feeds4.com/v2/coupons/?token={API TOKEN}&recordset=all

API Data Structure

Coupon data delivered by our coupon API is returned with one of two data structures, XML (default) or JSON.  Our coupon API can be configured to return XML or JSON using the response parameter.

All data returned in either data structure can be parsed using any programming language.

https://api.feeds4.com/v2/coupons/?token={API TOKEN}&response=xml
https://api.feeds4.com/v2/coupons/?token={API TOKEN}&response=json

API Response – XML

Here is an example request in XML:

https://api.feeds4.com/v2/coupons/?token={API TOKEN}&response=xml

XML Response: Below you will find an example coupon API response from our server.

<coupons>
<item>
<id></id>
<merchant></merchant>
<merchantid></merchantid>
<offer></offer>
<restriction></restriction>
<url></url>
<code></code>
<startdate></startdate>
<enddate></enddate>
<category></category>
<dealtype></dealtype>
<holiday></holiday>
<network></network>
<rating></rating>
<country></country>
<logo></logo>
<website></website>
<domain></domain>
<lastmodified></lastmodified>
</item>
</coupons>

API Response – JSON

Here is an example request in JSON:

https://api.feeds4.com/v2/coupons/?token={API TOKEN}&response=json

JSON Response: Below you will find an example coupon API response from our server.

{"data":[{"id":"","merchant":"","merchantid":"","offer":"","restriction":"","url":"","code":"","startdate":"","enddate":"","category":"","dealtype":"","holiday":"","network":"","rating":"","country":"","logo":"","website":"","domain":"","lastmodified":""}]}