OneRiot’s Search API
Welcome to OneRiot’s search API. Please find links to the related documentation above. New to the API is RiotWise, a way for publishers of quality content to reach users of realtime web applications, and a way for developers of those applications to monetize in a manner that also adds direct value to their users.
______________________________________________________________________________________
RiotWise
Based on OneRiot’s realtime search technology, the idea behind RiotWise is to match users to fresh, relevant content from our partners in realtime.
The service is grounded on the premise that users of realtime web apps are primarily trying to find out what’s going on right now for a particular topic. RiotWise serves up links to web pages from a content network that helps users find out what’s going right now. It directly matches the user’s intent – in other words, it adds value to the users’ experience; it helps them do what they are trying to do.
In lab testing, we’ve seen high Click Through Rates (CTRs) on RiotWise. Additionally, click throughs are highly qualified, and well targeted. The user clicking is trying to find out what’s going on right now for a particular topic, and they are being served links to content from quality publishers that exactly addresses that topic. This provides a great experience for the user, and a great audience for the content provider.
RiotWise is built from the ground up to be distributed across the realtime web. Any third party app will be able to grab a relevant content feed, serve it up to users in realtime, and get paid. Now remember, the content being served is fresh, high quality and relevant to the users. It’s totally in sync with the needs of the user of a realtime web app – which is great for distribution partners. They can now monetize by serving content that is useful to their users and adds value to their overall service. This is how to monetize on the realtime web.
______________________________________________________________________________________
The information available through the OneRiot Realtime Search API closely matches the information we present on OneRiot.com. Given a query, our API will return relevant realtime results. The default sorting for results is by PulseRank, OneRiot’s algorithm for realtime relevance.
The OneRiot Realtime Search API is currently accessible only through pre-approved IP addresses. For this reason, you must request access via e-mail.
Users of the API must have their clients (e.g. toolbar, application, website, etc.) send requests to their own servers, which then forwards them to us. For information on forwarding requests and caching results, check out squid-cache.
Please note: OneRiot also provides additional integration options beyond our Search API, including OneRiot’s Trending Topics Feed, Simple Web Search Interface, and more. For more information regarding these options, contact us.
OneRiot API documentation is delivered in four sections:
Search Request
Search requests are made by performing an HTTP GET request for a URL of the form.
Learn more
Search Response Formats
Though the vocabulary used in search responses is consistent across formats, the specific syntax differs. The following section describes those specifics based upon the value of the format request parameter. Learn more
Search Response Vocabulary
Search responses contain the same information whether formatted as JSONP or XML, and hence use the same vocabulary.
Learn more
Examples
Learn more