Twingly logoTwingly Analytics API

This is a commercial blog search API. To get an API key and gain access to the Twingly Analytics API, or to learn more, please contact sales@twingly.com.

Information

Twingly Analytics API enables full text blog search capabilities through an XML-based HTTP API. To post search queries through the API an API key must be given.
Below is a form that can be used to test the API. It builds an URL that is used to call the API.
The URL has the following structure:
http://api.twingly.com/analytics/Analytics.ashx?key=[API key]&searchpattern=[search]&ts=[from timestamp]&tsTo=[to timestamp]&documentlang=[ISO language code]&xmloutputversion=[version]
The result is an XML-document with data about each blog post matching the searchpattern. The blog posts are by default returned in date order starting with the newest. A most 1000 blog posts are returned for any given query.

For instructions on how to use the search language, please refer to the help section.

Testing form

API key (required)


Search pattern (required)
  eg. Primelabs AND Twingly

Document Language
  A ISO twoletter languagecode, eg. sv

Timestamp
  eg. 2007-05-01 12:00:00

Timestamp To
  eg. 2007-05-01 13:00:00

Output version
  0 - old format, 1 - current version (no blogrank), 2 - current version (with blogrank)

Notes

NOTE! To get TwinglyRank sorting, add sort:twinglyrank to your query. The default sorting is by date.
NOTE! There is now a new version of the xml ouput. If no xmloutputversion is given in the call, the old xml output is used. It is recommended to use the new output.

Java Client API (beta)

A client API written in Java can be downloaded here: twingly-java-api.zip. the zip file contains a JAR-file and the documentation. The documentation can be found online here