ginatrapani/ThinkUp — pull request #1614 by ecucurella (2013-05-28 18:00:34+00:00)
Title: Post api twitter saved searches

# Post API
* We have added a **new type** for POST API named **keyword_posts** to get posts that contain a saved search keyword

* We have **refactor** the previous version in old pull request https://github.com/ginatrapani/ThinkUp/pull/1518 to take keyword and network on query string

Keyword Posts
=============
Gets posts from saved search that contains a keyword.

**API call type slug:** ``keyword_posts``

**Example Keyword Usage:** ``api/v1/post.php?type=keyword_posts&keyword=mwc2013&network=twitter``
**Example Hashtag Usage:** ``api/v1/post.php?type=keyword_posts&keyword=%23conselldeguerra&network=twitter``

==================
Required arguments
==================

* **keyword** and **network**

The keyword that posts contain to retrieve and save.
The network where posts have been searched and saved.

==================
Optional Arguments
==================

* **order_by**

The column to order the results by. Defaults to chronological order ("date").

* **direction**

The direction to order the results in. Can be either DESC or ASC. Defaults to DESC.

* **count**

The number of results to display from this API call. Defaults to 20. If you supply something that is
not a valid number, this argument will revert to its default value of 20. For performance reasons, the maximum
number of posts the ThinkUp API returns per call is 200.

* **page**

The page of results to display for this API call. Defaults to 1. When you get to the end of the pages of results,
API calls will just return empty JSON. No error is generated.

* **include_entities**

Whether or not to include `Tweet Entities `_ in the output. Defaults
to false. This argument can be set to true by making it equal to either **1**, **t** or **true**.

* **trim_user**

If set to true, this flag strips the user part of the output to just the user's ID and nothing else. Defaults to
false. This argument can be set to true by making it equal to either **1**, **t** or **true**.

Powered by Televisió de Catalunya / Universitat Illes Balears - SOCIALMEDIA PROJECT - CEN-20101037 - This contribution has been kindly sponsored by the Centro para el Desarrollo Tecnológico Industrial within the Programa de Investigación Nacional Español CENIT. - http://www.cenitsocialmedia.es/