From: Aaron Hill <aa1ronham@gmail.com>
Date: Sat, 3 May 2014 14:56:04 +0000 (-0400)
Subject: Document API.statuses_lookup
X-Git-Url: https://vcs.fsf.org/?a=commitdiff_plain;h=fad037bc2442feb005009e402716842fbba3903e;p=tweepy.git

Document API.statuses_lookup
---

diff --git a/docs/api.rst b/docs/api.rst
index c64112e..e06b728 100644
--- a/docs/api.rst
+++ b/docs/api.rst
@@ -47,6 +47,16 @@ Timeline methods
    :param page: |page|
    :rtype: list of :class:`Status` objects
 
+.. method:: API.statuses_lookup(id, [include_entities], [trim_user], [map])
+
+   Returns full Tweet objects for up to 100 tweets per request, specified by the
+   `id` parameter.
+
+   :param id: A list of Tweet IDs to lookup, up to 100
+   :param include_entities: A boolean indicating whether or not to include [entities](https://dev.twitter.com/docs/entities) in the returned tweets. Defaults to False.
+   :param trim_user: A boolean indicating if user IDs should be provided, instead of full user information. Defaults to False.
+   :param map: A boolean indicating whether or not to include tweets that cannot be shown, but with a value of None. Defaults to False.
+   :rtype: list of :class:`Status` objects
 
 .. method:: API.friends_timeline([since_id], [max_id], [count], [page])