[twitter] add 'search-stop' option (#8173)

and rename 'pagination-search' to 'search-pagination'

docs/configuration.rst

@@ -5631,22 +5631,6 @@ Description
     Logout and retry as guest when access to another user's Tweets is blocked.
 
 
-extractor.twitter.pagination-search
------------------------------------
-Type
-    ``string``
-Default
-    ``"cursor"``
-Description
-    Selects how to paginate over search results.
-
-    ``"cursor"``
-        Use ``cursor`` values provided by the API
-    ``"id"`` | ``"max_id"`` | ``"tweet_id"``
-        Update the ``max_id`` search query parameter
-        to the Tweet ID value of the last retrieved Tweet.
-
-
 extractor.twitter.pinned
 ------------------------
 Type
@@ -5743,6 +5727,34 @@ Description
     will be taken from the original Tweets, not the Retweets.
 
 
+extractor.twitter.search-pagination
+-----------------------------------
+Type
+    ``string``
+Default
+    ``"cursor"``
+Description
+    Selects how to paginate over search results.
+
+    ``"cursor"``
+        Use ``cursor`` values provided by the API
+    ``"max_id"`` | ``"maxid"`` | ``"id"``
+        Update the ``max_id`` search query parameter
+        to the Tweet ID value of the last retrieved Tweet.
+
+
+extractor.twitter.search-stop
+-----------------------------
+Type
+    ``integer``
+Default
+    * ``3`` if `search-pagination <extractor.twitter.search-pagination_>`__ is set to ``"cursor"``
+    * ``0`` otherwise
+Description
+    Selects how many empty search result batches
+    to receive before stopping.
+
+
 extractor.twitter.timeline.strategy
 -----------------------------------
 Type

docs/gallery-dl.conf

@@ -812,13 +812,14 @@
             "include"     : ["timeline"],
             "locked"      : "abort",
             "logout"      : true,
-            "pagination-search": "cursor",
             "pinned"      : false,
             "quoted"      : false,
             "ratelimit"   : "wait",
             "relogin"     : true,
             "replies"     : true,
             "retweets"    : false,
+            "search-pagination": "cursor",
+            "search-stop" : "auto",
             "size"        : ["orig", "4096x4096", "large", "medium", "small"],
             "text-tweets" : false,
             "tweet-endpoint": "auto",