[twitter] add 'search-results' option (#8613)

docs/configuration.rst

@@ -6333,6 +6333,20 @@ Description
         to the Tweet ID value of the last retrieved Tweet.
 
 
+extractor.twitter.search-results
+--------------------------------
+Type
+    ``string``
+Default
+    ``"latest"``
+Description
+    Determines the target of search results.
+Supported Values
+    * ``"top"``
+    * ``"media"``
+    * ``"latest"`` | ``"live"``
+
+
 extractor.twitter.search-stop
 -----------------------------
 Type

docs/gallery-dl.conf

@@ -880,6 +880,7 @@
             "retweets"    : false,
             "search-limit": 20,
             "search-pagination": "cursor",
+            "search-results"   : "latest",
             "search-stop" : "auto",
             "size"        : ["orig", "4096x4096", "large", "medium", "small"],
             "text-tweets" : false,