Already a user? Login

Getting started with the API

The JRank API uses a very simple method of requesting search results. To query your context in JRank, use an HTTP GET on the following URL, making sure to replace [API key] with your API key and [query] with your query.[API key]&q=[query]

The parameters key and q are the only parameters that are required for JRank to return anything meaningful. You can also tell JRank to return certain pages of results, and change how many results are on each page. A list of the parameters are show below:

Your API key for the context you wish to search.
You can search multiple contexts by repeating the key parameter like "&key[]=context1&key[]=context2", where context1 is the key to the first context you wish to include, context2 is the second, and so on.
The search query
Limit the search results to this number (default: 10, max: 1000)
Start with this search result (default: 0)

Changing the output type

By default, JRank will return your results in HTML format. However, when programming with the API, it's usually much easier to manage data when represented in a more structured format, such as XML or JSON. To specify the format of the data JRank returns, specify the format as you would a regular filename. For example:

What does the data mean?

The same type of data is returned by both the JSON, HTML, and XML formats. Below are the fields you have access to, as well as what each of them mean. At the most basic level are search results data. Each result has the fields url, title, and content. In addition to the search results, there is additional data that describe the results, called metadata. Things like the available page numbers, next, previous, and current pages, or even the query words.

Page number of the previous page
Previous page's first result
Page number of the next page
Next page's first result
Page number of the current page
Current page's first result
Total number of pages available
Total search results that were found
Total returned search results
Maximum number of results that will be shown
Number of search results per page
Number of seconds taken to perform this search
Query string that was submitted
List of words that were parsed from the query string
Pairs of page numbers and start indexes for each set of pages
Each search result entry, with url, title, and description fields