Add FAQ section on API.search

diff --git a/docs/faq.rst b/docs/faq.rst
index 85b18919add0cfa407e6d57a055b0aed91ffa251..62798c6a1bd267f878c80f27bd6f536c8adc359d 100644 (file)
--- a/docs/faq.rst
+++ b/docs/faq.rst
@@ -98,6 +98,19 @@ This is because :ref:`Tweepy v4.0.0 <Version 4.0.0>` removed ``API.me``.
 
 Instead, you can use :meth:`API.verify_credentials`.
 
+Where did ``API.search`` go?
+----------------------------
+
+If you're attempting to use ``API.search`` or other :class:`API` methods from
+Tweepy v3, you might encounter an :class:`AttributeError` with Tweepy v4.
+
+This is because :ref:`Tweepy v4.0.0 <Version 4.0.0>` renamed many :class:`API`
+methods to be more consistent.
+
+For example, ``API.search`` was renamed to :meth:`API.search_tweets`. You can
+refer to the changelog / release notes and update your method invocations
+accordingly.
+
 Where did ``StreamListener`` go?
 --------------------------------