Raven API

Overview

The Raven database contains search results for thousands of keywords, including the keywords you have added through your account. Every day the Raven engine captures up to 100 search results for these keywords from the three major search engines (Google, Yahoo!, and MSN Live.) Raven also compiles a database of search engine rankings for the domains and keywords you have added to your account. This data is available through Raven's REST API, and can be returned in XML or JSON format.

Common Request Parameters

key

This is your assigned API key. It must be provided on every request.

format

This can be xml or json. The XML schema is published at http://raven.sitening.net/raven-serp-schema.xml

Search Results

This request will return the top 100 search results for a particular keyword, search engine, and date.

method

search

keyword

The keyword you want results for.

date

The date you want results for.

engine

The search engine you want results for. Available values are "google", "yahoo", or "msn".

Example:

http://raven.sitening.net/api?key=YOURAPIKEY&method=search&keyword=nashville+seo&date=2007-07-09&engine=yahoo
&format=xml

Domain Rank

This request will return a list of matches for a particular domain, keyword, search engine, and date range.

method

rank

domain

The domain name you want results for. "www." prefixes are ignored.

keyword

The keyword you want results for.

start_date

The beginning of the date range.

end_date

The end of the date range.

freq

This can be either daily, weekly, or monthly. It returns the best match from within each period.

engine

The search engine you want results for. Available values are "all", "google", "yahoo", or "msn".

Example:

http://raven.sitening.net/api?key=YOURAPIKEY&method=rank&keyword=nashville+seo&domain=sitening.com
&start_date=2007-07-09&end_date=2007-08-09&freq=daily&engine=all&format=json