Twendly API

Welcome to the Twendly API. Feel free to incorporate this in your site and other mashups, in return we would love a link back to Twendly. There are no formal limits around usage at this time, however we ask that you exercise common sense and don't overload the server with excessive queries.

Please note that both the Search and Profile API are heavily cached, so repeated querying will not vary the result.

If you have any questions, comments, or just want to share what you've achieved with the data, we'd love to hear from you via the contact link on this page.

#1. Search

Returns a list of top ranked users. For the moment, we're limiting to return only the top 10.

URL

http://twendly.com/api/search.json

Formats

json

Parameters

Example queries

Response

A list of dictionaries of rank, user twitter name, relevancy and last 12 month's activities. 

[
    {"rank":1,
    "user":"TimBull",
    "relevancy":45,
    "history":[0,0,0,4,12,23,18,20,21,25,31,28]},
    ...  
]

#2: User profile

Returns a list of searches the requested user appears in.

URL

http://twendly.com/api/user.json

Formats

json

Parameters

You can either query using twitter username or id. If both are given, username will be used.

  • screen_name: user's twitter screen name,like TimBull.
  • user_id: user's twitter id, like 118266355.

Example queries:

Response

A list of dictionaries of ranking and the search term. . 

[
    {"rank":1,
    "search":"lotus connection", },
    ...  
]