2 Quickstart

You can get started with the Adility API via our Quickstart guide. Here you can execute a few simple API calls without signing up for an account.

Hello, Offers!

The Adility is a database of offers. You can use offers from the database via our API and build anything, the next Foursquare or Groupon. Here three examples of applications:

  • Daily Deal Site. You can run a daily deal site featuring offers from the Adility (read more in the article The Adility for daily deal sites).
  • Mobile Application. Build a mobile application displaying offers to users based on their location (the article The Adility for mobile applications will explain details).
  • Map Application. You could show offers on a map in a browser (find ideas in the article The Adility for map applications).

Whatever your application does you can use offers from the Adility to monetize your audience. The Adility API provides a number of filters you can use while querying offers. Below you can find a couple of examples. 

NOTE: In these examples we use "demo" API key. But in your application you should use your own API key which you can find in your developer account at http://www.adility.com.

Example 1
Get offers in your area with radius 10 miles. Replace 30305 in the query with your zip code.
curl -k -X GET -H "Content-Type: application/xml" -H "Accept: application/xml" -H "X-ADILITY-API-KEY: demo" 'http://testapi.adility.com/distribution/beta/offers?radius=10&postal_code=30305'


Example 2
Get offers from restaurants sorted by price
curl -k -X GET -H "Content-Type: application/xml" -H "Accept: application/xml" -H "X-ADILITY-API-KEY: demo" 'http://testapi.adility.com/distribution/beta/offers?postal_code=30305&radius=25&sort_by=price+asc'


Example 3
Get deals (offers of deal type) in Boston, MA within 20 miles radius from city center, sorted by price.
curl -k -X GET -H "Content-Type: application/xml" -H "Accept: application/xml" -H "X-ADILITY-API-KEY: demo" 'http://testapi.adility.com/distribution/beta/offers?city=boston&state_code=ma&radius=20&types=deal&sort_by=price+asc'


Example 4
Get nationwide offers for USA.
curl -k -X GET -H "Content-Type: application/xml" -H "Accept: application/xml" -H "X-ADILITY-API-KEY: demo" 'http://testapi.adility.com/distribution/beta/offers?country_code=US'

Sample Apps

There's a sample application written in Ruby that demonstrates submission API workflow. You can fork it on github:

Next Step: Submission API.

Comments