Summize Search API

You can use our API to integrate Summize search results with your own apps, clients, and readers. Check out these great examples of apps utilizing our API.

We serve two flavors of our Search API: Atom and JSON.

Atom API

You can grab the search results for any query as a standard Atom feed. For example, this is the Atom feed for the query twitter.

To construct a request URL, simply append your URL-encoded query to our Atom service URL:

http://summize.com/search.atom?q=<query>

You can use any of our search operators in your query. Here are a few examples:

• Find tweets containing a word: http://summize.com/search.atom?q=twitter
• Find tweets from a user: http://summize.com/search.atom?q=from%3Aalexiskold
• Find tweets to a user: http://summize.com/search.atom?q=to%3Atechcrunch
• Find tweets referencing a user: http://summize.com/search.atom?q=%40mashable
• Find tweets containing a hashtag: http://summize.com/search.atom?q=%23haiku
• Combine any of the operators together: http://summize.com/search.atom?q=movie+%3A%29

Alternatively, if you perform a search on our site, you can click the Feed for this query link in the sidebar to obtain its Atom feed URL. You can also use the advanced search page to easily incorporate any search operators.

The API also supports the following optional URL parameters:

• lang: restricts tweets to the given language, given by an ISO 639-1 code. E.g., http://summize.com/search.atom?lang=en&q=devo
• rpp: the number of tweets to return per page, up to a max of 100. E.g., http://summize.com/search.atom?lang=en&q=devo&rpp=15
• since_id: returns only tweets with status ids greater than the given id.

JSON API

The JSON API works exactly like the Atom API, but returns the results in JSON format. For example, this is the JSON response for the query twitter.

To construct a request URL, append your URL-encoded query to our JSON service URL:

http://summize.com/search.json?q=<query>

The JSON API also supports an additional URL parameter:

• callback: if supplied, the response will use the JSONP format with a callback of the given name. E.g., http://summize.com/search.json?callback=foo&q=twitter

Talk to Us

Please with feedback and feature requests. If you integrate our API with your own application, why not include one of these stylish "Powered by Summize" badges:

what you're up to so we can check it out!