add domains and contacts

Author: vlad-outscraper

README.md

@@ -80,6 +80,15 @@ result = api_client.google_play_reviews(
     'com.facebook.katana', reviewsLimit=20, language='en')
 ```
 
+## Emails & Contacts Scraper
+
+```python
+from outscraper import ApiClient
+
+api_client = ApiClient(api_key='SECRET_API_KEY')
+result = api_client.emails_and_contacts(['outscraper.com'])
+```
+
 ## Responses examples
 
 Google Maps (Places) response example:
@@ -320,3 +329,62 @@ Google Play Reviews response example:
   ]
 ]
 ```
+
+Emails & Contacts Scraper response example:
+```json
+[
+    {
+      "query": "outscraper.com",
+      "domain": "outscraper.com",
+      "emails": [
+        {
+          "value": "[email protected]",
+          "sources": [
+            {
+              "ref": "https://outscraper.com/",
+              "extracted_on": "2021-09-27T07:45:30.386000",
+              "updated_on": "2021-11-18T12:59:15.602000"
+            },
+          ...
+          ]
+        },
+        {
+          "value": "[email protected]",
+          "sources": [
+            {
+              "ref": "https://outscraper.com/privacy-policy/",
+              "extracted_on": "2021-11-18T12:51:39.716000",
+              "updated_on": "2021-11-18T12:51:39.716000"
+            }
+          ]
+        }
+      ],
+      "phones": [
+        {
+          "value": "12812368208",
+          "sources": [
+            {
+              "ref": "https://outscraper.com/",
+              "extracted_on": "2021-11-18T12:59:15.602000",
+              "updated_on": "2021-11-18T12:59:15.602000"
+            },
+            ...
+          ]
+        }
+      ],
+      "socials": {
+        "facebook": "https://www.facebook.com/outscraper/",
+        "github": "https://github.com/outscraper",
+        "linkedin": "https://www.linkedin.com/company/outscraper/",
+        "twitter": "https://twitter.com/outscraper",
+        "whatsapp": "https://wa.me/12812368208",
+        "youtube": "https://www.youtube.com/channel/UCDYOuXSEenLpt5tKNq-0l9Q"
+      },
+      "site_data": {
+        "description": "Scrape Google Maps Places, Business Reviews, Photos, Play Market Reviews, and more. Get any public data from the internet by applying cutting-edge technologies.",
+        "generator": "WordPress 5.8.2",
+        "title": "Outscraper - get any public data from the internet"
+      }
+    }
+  ]
+```

README.rst

@@ -95,6 +95,16 @@ Scrape Google Play Reviews
     result = api_client.google_play_reviews(
         'com.facebook.katana', reviewsLimit=20, language='en')
 
+Emails & Contacts Scraper
+-------------------------
+
+.. code:: python
+
+    from outscraper import ApiClient
+
+    api_client = ApiClient(api_key='SECRET_API_KEY')
+    result = api_client.emails_and_contacts(['outscraper.com'])
+
 Responses examples
 ------------------
 
@@ -338,3 +348,63 @@ Google Play Reviews response example:
       ]
     ]
 
+Emails & Contacts Scraper response example:
+
+.. code:: json
+
+    [
+        {
+          "query": "outscraper.com",
+          "domain": "outscraper.com",
+          "emails": [
+            {
+              "value": "[email protected]",
+              "sources": [
+                {
+                  "ref": "https://outscraper.com/",
+                  "extracted_on": "2021-09-27T07:45:30.386000",
+                  "updated_on": "2021-11-18T12:59:15.602000"
+                },
+              ...
+              ]
+            },
+            {
+              "value": "[email protected]",
+              "sources": [
+                {
+                  "ref": "https://outscraper.com/privacy-policy/",
+                  "extracted_on": "2021-11-18T12:51:39.716000",
+                  "updated_on": "2021-11-18T12:51:39.716000"
+                }
+              ]
+            }
+          ],
+          "phones": [
+            {
+              "value": "12812368208",
+              "sources": [
+                {
+                  "ref": "https://outscraper.com/",
+                  "extracted_on": "2021-11-18T12:59:15.602000",
+                  "updated_on": "2021-11-18T12:59:15.602000"
+                },
+                ...
+              ]
+            }
+          ],
+          "socials": {
+            "facebook": "https://www.facebook.com/outscraper/",
+            "github": "https://github.com/outscraper",
+            "linkedin": "https://www.linkedin.com/company/outscraper/",
+            "twitter": "https://twitter.com/outscraper",
+            "whatsapp": "https://wa.me/12812368208",
+            "youtube": "https://www.youtube.com/channel/UCDYOuXSEenLpt5tKNq-0l9Q"
+          },
+          "site_data": {
+            "description": "Scrape Google Maps Places, Business Reviews, Photos, Play Market Reviews, and more. Get any public data from the internet by applying cutting-edge technologies.",
+            "generator": "WordPress 5.8.2",
+            "title": "Outscraper - get any public data from the internet"
+          }
+        }
+      ]
+

outscraper/api_client.py

@@ -4,7 +4,7 @@
 from .utils import as_list
 
 
-VERSION = '1.1.0'
+VERSION = '1.1.1'
 
 
 class ApiClient(object):
@@ -240,3 +240,22 @@ def google_play_reviews(self, query: list, reviewsLimit: int = 100, sort: str =
             return self._wait_request_archive(response.json()['id']).get('data', [])
 
         raise Exception(f'Response status code: {response.status_code}')
+
+    def emails_and_contacts(self, query: list) -> list:
+        '''
+            Return email addresses, social links and phones from domains in seconds.
+
+                    Parameters:
+                            query (list | str): Domains or links (e.g., outscraper.com).
+
+                    Returns:
+                            list: json result
+        '''
+        response = requests.get(f'{self._api_url}/emails-and-contacts', params={
+            'query': as_list(query),
+        }, headers=self._api_headers)
+
+        if 199 < response.status_code < 300:
+            return self._wait_request_archive(response.json()['id']).get('data', [])
+
+        raise Exception(f'Response status code: {response.status_code}')