Calling the API

You can call the Bizo API using the following URL format:

http://api.bizographics.com/v2/[method].[format]

e.g.

http://api.bizographics.com/v2/profile.json

Bizo API key

The Bizo API requires an api key to be passed as part of the request query string, using the api_key parameter.

To request an API key, please contact us at: api-support@bizo.com

Domain restrictions

The API methods meant for "online" use are also restricted by your website domain. They can only be used on a page served by that domain. These methods are:

• profile
• taxonomy

Signed API calls

Some API methods have additional security enabled for offline use. These methods are:

• classify
• classifyWithProfile
• decodeCookies
• usage

In addition to an api_key parameter, these methods require an oauth style signature to be included as part of the request. This signature can be generated using a standard oauth client library. The consumer-key is your api key, and the consumer-secret is a shared secret that will be provided along with your api key.

An example signed request to the classify method, assuming an api key of "abc" and a shared secret of "xyz" would look something like this:

http://api.bizographics.com/v2/classify.xml?apikey=abc&title=vp&oauthsignature=ZgDOuFIaRCOTfJKn2nK4KLXKOA4%3D&oauthconsumerkey=abc&oauthversion=1.0&oauthsignaturemethod=HMAC-SHA1&oauthtimestamp=1267483880&oauth_nonce=-2684461089957865351

Client signature libraries

Please visit the oauth website to locate a 3rd party client libary capable of generating an oauth signature in many different programming lanugages.

For Java or Scala, we recommend oauth-signpost.