1. YellowAPI A brief introduction to the API from the Yellow Pages

2. What is it?

3. What is YellowAPI? Allows developers to access 1.5 million Canadian business listings All listings are located with their latitude and longitude Free to use If you develop a successful app the Yellow Pages will pay you Currently in Beta

4. How can I use it?

5. YellowAPI Basics Register to use Granted two API keys: Sandbox API Key (development) Live API Key To begin with only Sandbox key will be activated Once your application is complete Yellow Pages will review it and activate the live key Calls to API rate limited but limit is negotiable Some restrictions on how data is used

6. API Architecture REST architecture All methods accessed via GET Responses returned as XML (default) or JSON Four methods currently available: FindBusiness GetBusinessDetails FindDealer GetTypeAhead

7. API Methods

8. Findbusiness What Where search ‘What’ can be a category, business name or anything in between ‘Where’ can be passed in two ways: Place (e.g. Guelph, ON) Lat/Lon point. If place is passed as Lat/Lon each result is returned with distance to search point calculated and in order from closest to furthest Results returned in chunks of 40 by default

9. GetBusinessdetails Method still being finalised Provides full details on an individual business Data available ranges from address, opening hours to adverts, videos and logos Need a listing id (retrieved from FindBusiness) to call this method

10. Finddealer Used to return a list of all dealers/franchises for a business Listing can be a ‘parent’ or ‘child’ listing if it falls into this category FindBusiness will indicate if a listing is/has a parent

11. Gettypeahead Method not yet available Used to return suggestions based on what a user has typed Can return suggestions for what or where For example, if a user enters ‘res’ for what ‘restaurant’ could be returned, along with other suggestions

12. Where can I find out more?

13. YellowAPI resources Check out http://www.yellowapi.com Full documentation on the API, support forums, app gallery and SDK’s in many languages Lots of support available from Yellow Pages staff Big plans for future of API including deals/offers and reviews

14. What kind of apps can I build with it?

15. Thanks Feel free to contact me: Twitter: JCook21 Email: jeremycook0@gmail.com Blog: http://jeremycook.ca Rendezview: http://rendezview.ca Twitter: Rendezviewapp Yellow API: http://www.yellowapi.com