Replace FAQ section on API.search_tweets limitations with note

Replace FAQ section on API.search_tweets limitations with note in method documentation

diff --git a/docs/faq.rst b/docs/faq.rst
index fdca76430de6ce734807f2ccb5198b8eba5534eb..3cb978cf4390a25027e18af3301878a065ec153d 100644 (file)
--- a/docs/faq.rst
+++ b/docs/faq.rst
@@ -59,19 +59,6 @@ Why am I getting an inconsistent number of / not getting 3200 Tweets for a speci
 
 https://twittercommunity.com/t/inconsistent-tweet-retrieval/150635
 
-Why am I getting no results or not all the results from :meth:`API.search_tweets`?
-----------------------------------------------------------------------------------
-
-Twitter's standard search API only "searches against a sampling of recent
-Tweets published in the past 7 days."
-
-If you're specifying an ID range beyond the past 7 days or there are no results
-from the past 7 days, then no results will be returned.
-
-See Twitter's documentation on the standard search API for more information:
-https://developer.twitter.com/en/docs/twitter-api/v1/tweets/search/overview
-https://developer.twitter.com/en/docs/twitter-api/v1/tweets/search/api-reference/get-search-tweets
-
 Tweepy v4
 =========
 

diff --git a/tweepy/api.py b/tweepy/api.py
index e6e78fd2041c4108c08ec0b4f8b9d858c7c7e476..002ca624d2fd20b18d89c3be55e6ed9b0c59ec96 100644 (file)
--- a/tweepy/api.py
+++ b/tweepy/api.py
@@ -1218,6 +1218,18 @@ class API:
         API is not meant to be an exhaustive source of Tweets. Not all Tweets
         will be indexed or made available via the search interface.
 
+        .. note::
+
+            Twitter's standard search API only "searches against a sampling of
+            recent Tweets published in the past 7 days."
+
+            If you're specifying an ID range beyond the past 7 days or there
+            are no results from the past 7 days, then no results will be
+            returned.
+
+            See `Twitter's documentation on the standard search API`_ for more
+            information.
+
         .. note::
 
             In API v1.1, the response format of the Search API has been
@@ -1285,6 +1297,8 @@ class API:
         References
         ----------
         https://developer.twitter.com/en/docs/twitter-api/v1/tweets/search/api-reference/get-search-tweets
+
+        .. _Twitter's documentation on the standard search API: https://developer.twitter.com/en/docs/twitter-api/v1/tweets/search/overview
         """
         return self.request(
             'GET', 'search/tweets', endpoint_parameters=(