feat: add support for markdown output (output=md param)

Author: adarshdigievo

README.md

@@ -79,6 +79,26 @@ Documentation is [available on Read the Docs](https://serpapi-python.readthedocs
 
 Change history is [available on GitHub](https://github.com/serpapi/serpapi-python/blob/master/HISTORY.md).
 
+### HTML and Markdown output formats
+
+Searches return JSON as a `SerpResults` object by default. To receive HTML, set `output` to `html`. To receive Markdown, set `output` to `md`:
+
+```python
+html = client.search({
+    "engine": "google",
+    "q": "coffee",
+    "output": "html",
+})
+
+markdown = client.search({
+    "engine": "google",
+    "q": "coffee",
+    "output": "md",
+})
+```
+
+HTML and Markdown responses are returned as plain Python strings.
+
 ## Basic Examples in Python
 
 ### Search Bing

serpapi/core.py

@@ -32,7 +32,7 @@ def __repr__(self):
         return "<SerpApi Client>"
 
     def search(self, params: dict = None, **kwargs):
-        """Fetch a page of results from SerpApi. Returns a :class:`SerpResults <serpapi.client.SerpResults>` object, or unicode text (*e.g.* if ``'output': 'html'`` was passed).
+        """Fetch a page of results from SerpApi. Returns a :class:`SerpResults <serpapi.client.SerpResults>` object for JSON responses, or unicode text for HTML and Markdown responses.
 
         The following three calls are equivalent:
 
@@ -53,7 +53,7 @@ def search(self, params: dict = None, **kwargs):
 
         :param q: typically, this is the parameter for the search engine query.
         :param engine: the search engine to use. Defaults to ``google``.
-        :param output: the output format desired (``html`` or ``json``). Defaults to ``json``.
+        :param output: the output format desired (``html``, ``json``, or ``md``). Defaults to ``json``.
         :param api_key: the API Key to use for SerpApi.com.
         :param **: any additional parameters to pass to the API.
 
@@ -81,7 +81,7 @@ def search_archive(self, params: dict = None, **kwargs):
 
         :param search_id: the Search ID of the search to retrieve from the archive.
         :param api_key: the API Key to use for SerpApi.com.
-        :param output: the output format desired (``html`` or ``json``). Defaults to ``json``.
+        :param output: the output format desired (``html``, ``json``, or ``md``). Defaults to ``json``.
         :param **: any additional parameters to pass to the API.
 
         **Learn more**: https://serpapi.com/search-archive-api

serpapi/models.py

@@ -92,6 +92,10 @@ def from_http_response(cls, r, *, client=None):
         Otherwise, the raw text (as a properly decoded unicode string) is returned.
         """
 
+        content_type = r.headers.get("Content-Type", "").split(";", 1)[0].lower()
+        if content_type in {"text/html", "text/markdown"}:
+            return r.text
+
         try:
             cls = cls(r.json(), client=client)