Now Serving Canadian Local Content Via Yellow API

Romin Irani, September 17th, 2010

Yellow CanadaDevelopers looking to access Canadian local search content in their applications have their tasks made much easier now, thanks to Yellow API, a new service in beta from YellowPages.ca.

The API aims to provide access to one of the largest business and people databases in Canada. The API, which currently provides access to local business and dealer data, is intuitively designed. To search for any local information, you need to specify the “What” and the “Where” in the request parameters. This is best illustrated by a diagram shown below from their official site. These two parameters can be combined in various ways to search for local listings.

The current methods exposed for local data are FindBusiness, GetBusinessDetails, FindDealer. The API is REST based over HTTP with response data formats provided in either XML or JSON.

An example call to find all Barbers in Canada is given below:

http://api.yellowapi.com/FindBusiness/?what=barber&where=Canada&fmt=XML&pgLen=10&apikey=yourkey&UID=123456789

When you register an application to use with the API, you are given a Sandbox API key which can be used immediately. If you plan to launch your application, you can then request for a Production Key. The current Sandbox API rates are low i.e. 1 call per second up to a maximum of 100 calls per day only. The Production rate limits are much higher at 2 calls per second upto a maximum of 5000 calls per day.

Yellow API has provided a glimpse in future datasets that it plans to expose. These include person search, deals and coupons, ratings and reviews, and classifieds. The deals and coupons, if and when it is exposed, will provide developers a chance to create cool applications that would serve the local Canadian community.

Both comments and pings are currently closed.

2 Responses to “Now Serving Canadian Local Content Via Yellow API”

September 20th, 2010
at 12:01 am
Comment by: A Rainbow of APIs: Orange, Yellow, Green

[...] week we added a Canadian yellow pages service to our directory. It’s called, simply, Yellow API, which made us wonder: what other colors [...]

March 13th, 2011
at 1:03 am
Comment by: ProgrammableWeb – My Articles – September 2010 » iRomin

[...] Now Serving Canadian Local Content Via Yellow API [...]

Follow the PW team on Twitter

ProgrammableWeb
APIs, mashups and code. Because the world's your programmable oyster.

John Musser
Founder, ProgrammableWeb

Adam DuVander
Executive Editor, ProgrammableWeb. Author, Map Scripting 101. Lover, APIs.