List Parameters
List parameters available to all list resources.
| Name | Required | Description |
| page | optional | page number of the result set. (default: 1, max: 10) |
| perpage | optional | limit number of results per page. (default: 10, max: 100) |
| offset | optional | offset from which to start the results, should be set to last_offset parameter returned in the previous page. |
| mintime | optional | earliest date/time to restrict a result set. unix-timestamp format. ( Note - search.json can be used with either "window" or "mintime" and/or "maxtime" but not both. Using "window" as well as "mintime"/"maxtime" can provide 0 or incorrect results) |
| maxtime | optional | most recent date/time to restrict a result set. unix-timestamp format. (Note - search.json can be used with either "window" or "mintime" and/or "maxtime" but not both. Using "window" as well as "mintime"/"maxtime" can provide 0 or incorrect results) |
| nohidden | optional | toggles hiding of duplicate results. default is 1, which means no results are hidden. nohidden=0 will return unique results only |
| allow_lang | optional | Language filter which lets you specify the languages you would like to see results in. Currently supports ja, zh, ko and en. Option also takes a comma separated list of languages. |
| family_filter | optional | Filters all content containing profanity. Should be set to 1 |
Examples:
http://otter.topsy.com/search.json?q=New+York&page=2&offset=24
This query will fetch the second page of a search for "New York" and return a json object.
http://otter.topsy.com/search.json?q=New+York&perpage=25
This query will fetch the first 25 results of a search for "New York" and return a json object.
The number of pages is limited to 10 but many URLs have 1000+ tweets which with results per page limited to 50 will mean more than half tweets are un-retrievable. Is there a way to address this?
How can I invert the order of results?
tokymon: In /search mintime considers all tweets newer than mintime. It's possible there are new tweets about URLs that had firstpost_date before mintime. In /searchdate, mintime refers to firstpost_date.
I think order option is not working.
How do i retreive all tweets? (in case if results exceed 1000+). For a keyword like tom+jerry i am getting following response,
a indicates there are 92701 results - though i would want to get all of them i am more interested in getting atleast 25% of those results. With page parameter as 10 and results per page 100 - i can go upto 1000 - how can i get remaining results?
Use a moving time window. Read the last time in the response and use that to appropriately set mintime and maxtime.