From: Harmon <Harmon758@gmail.com>
Date: Tue, 1 Mar 2022 22:32:55 +0000 (-0600)
Subject: Replace FAQ section on API.search_tweets limitations with note
X-Git-Url: https://vcs.fsf.org/?a=commitdiff_plain;h=98d4a99851445bb80ea7b9715ab58948dc7c1cf5;p=tweepy.git

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 fdca764..3cb978c 100644
--- 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 e6e78fd..002ca62 100644
--- 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=(