Buzzzy - A Search Engine for Buzz.

Buzzzy Search API

Overview

The Buzzzy Search API allows you to integrate search results from Buzzzy into your own website or application. The API is accessed via a REST interface, with JSON and XML data formats supported.

Join the Buzzzy API Group and let us know what you think!

Rate Limiting

The default rate limit for calls to the REST API is 250 per 60 minute period. The REST API is limited by ip address, and should the limit be exceeded the API will generate an error.

Search

Returns Buzz's matching a specified query.

URL:

http://buzzzy.com/api/search.format

Formats:

json, xml

HTTP Method:

GET

Parameters:

q - search query

values:: urlencoded string
required:: true
default:: -
example:: http://buzzzy.com/api/search.xml?q=iphone

page - search results page number

values:: unsigned integer
required:: false
default:: 1
example:: http://buzzzy.com/api/search.xml?q=iphone&page=2

sort - sort results by relevance or date descending order.

values:: date
required:: false
default:: relevance
example:: http://buzzzy.com/api/search.xml?q=iphone&sort=date

timeline - restrict results to specific time period.

values:: Day, Hour, Week
required:: false
default:: All
example:: http://buzzzy.com/api/search.xml?q=iphone&timeline=Day

source - restrict results to single or multiple sources feeding into Google Buzz. Multiple sources should by delimited by a vertical line |

values:: urlencoded string
required:: false
default:: All
example:: http://buzzzy.com/api/search.xml?q=iphone&source=Buzz|Google+Reader

lang - restrict results to a specific language. See list of languages on Buzzzy.com

values:: urlencoded string
required:: false
default:: All
example:: http://buzzzy.com/api/search.xml?q=iphone&lang=Japanese

callback - JSONP callback method

values:: name of your callback function
required:: false
default:: null
example:: http://buzzzy.com/api/search.json?q=iphone&callback=myCallback

Error Messages

An example of an error message returned by the Buzzzy API

JSON

{"header":{"status":false,"requests_remaining":219,"query":""}}

XML

<?xml version="1.0"?>
<response>
<header>
  <status>0</status>
  <requests_remaining>218</requests_remaining>
  <query><![CDATA[]]></query>
</header>
</response>