Document API.statuses_lookup

diff --git a/docs/api.rst b/docs/api.rst
index c64112e28f4a98cf679f622e04f89605a5036e0b..e06b72874bb53591eaf3e5d3012f97aec0475a69 100644 (file)
--- 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])