Merge pull request #27 from outscraper/os-added-more-examples

Os added more examples

Author: kseniia-maiesh

examples/Email Addresses Finder.md

@@ -0,0 +1,27 @@
+# Email Addresses Finder With Python
+
+Allows to validate email addresses. Checks if emails are deliverable. [Outscraper API](https://app.outscraper.cloud/api-docs#tag/Email-Related/paths/~1email-validator/get).
+
+## Installation
+
+Python 3+
+```bash
+pip install outscraper
+```
+
+[Link to the Python package page](https://pypi.org/project/outscraper/)
+
+## Initialization
+```python
+from outscraper import ApiClient
+
+client = ApiClient(api_key='SECRET_API_KEY')
+```
+[Link to the profile page to create the API key](https://app.outscraper.com/profile)
+
+## Usage
+
+```python
+# Validate email addresses:
+results = client.validate_emails(['support@outscraper.com'])
+```

examples/Google Maps Photos Scraper.md

@@ -0,0 +1,28 @@
+# Google Maps Photos Scraper With Python
+
+Returns Google Maps photos from places when using search queries (e.g., restaurants, Manhattan, NY, USA) or from a single place when using IDs or names (e.g., NoMad Restaurant, NY, USA, 0x886916e8bc273979:0x5141fcb11460b226, ChIJu7bMNFV-54gR-lrHScvPRX4).
+In case no photos were found by your search criteria, your search request will consume the usage of one photo.[Outscraper API](https://app.outscraper.cloud/api-docs#tag/Google/paths/~1maps~1photos-v3/get).
+
+## Installation
+
+Python 3+
+```bash
+pip install outscraper
+```
+
+[Link to the Python package page](https://pypi.org/project/outscraper/)
+
+## Initialization
+```python
+from outscraper import ApiClient
+
+client = ApiClient(api_key='SECRET_API_KEY')
+```
+[Link to the profile page to create the API key](https://app.outscraper.com/profile)
+
+## Usage
+
+```python
+# Get information about the places photos:
+results = client.google_maps_photos(['The NoMad Restaurant, NY, USA'])
+```

examples/SimilarWeb Scraper.md

@@ -0,0 +1,26 @@
+# SimilarWeb Scraper With Python
+
+Returns website analytics data including traffic, rankings, audience insights, and competitive intelligence from SimilarWeb [Outscraper API](https://app.outscraper.cloud/api-docs#tag/Domain-Related/paths/~1similarweb/get).
+
+## Installation
+
+Python 3+
+```bash
+pip install outscraper
+```
+
+[Link to the Python package page](https://pypi.org/project/outscraper/)
+
+## Initialization
+```python
+from outscraper import ApiClient
+
+client = ApiClient(api_key='SECRET_API_KEY')
+```
+[Link to the profile page to create the API key](https://app.outscraper.com/profile)
+
+## Usage
+
+```python
+# Get data from Similarweb businesses:
+results = client.similarweb(['apple.com'])

examples/Tripadvisor Reviews Scraper.md

@@ -0,0 +1,28 @@
+# Tripadvisor Reviews Scraper With Python
+
+Returns reviews from Tripadvisor businesses.
+In case no reviews were found by your search criteria, your search request will consume the usage of one review. [Outscraper API](https://app.outscraper.cloud/api-docs#tag/Reviews-and-Comments/paths/~1tripadvisor-reviews/get).
+
+## Installation
+
+Python 3+
+```bash
+pip install outscraper
+```
+
+[Link to the Python package page](https://pypi.org/project/outscraper/)
+
+## Initialization
+```python
+from outscraper import ApiClient
+
+client = ApiClient(api_key='SECRET_API_KEY')
+```
+[Link to the profile page to create the API key](https://app.outscraper.com/profile)
+
+## Usage
+
+```python
+# Get information about business:
+results = client.tripadvisor_reviews(['https://www.tripadvisor.com Restaurant_Review-g187147-d12947099-Reviews-Mayfair_Garden-Paris_Ile_de_France.html'])
+```

examples/Trustpilot Reviews Scraper.md

@@ -0,0 +1,27 @@
+# Trustpilot Reviews Scraper With Python
+
+Returns reviews from Trustpilot businesses. In case no reviews were found by your search criteria, your search request will consume the usage of one review.[Outscraper API](https://app.outscraper.cloud/api-docs#tag/Reviews-and-Comments/paths/~1trustpilot~1reviews/get).
+
+## Installation
+
+Python 3+
+```bash
+pip install outscraper
+```
+
+[Link to the Python package page](https://pypi.org/project/outscraper/)
+
+## Initialization
+```python
+from outscraper import ApiClient
+
+client = ApiClient(api_key='SECRET_API_KEY')
+```
+[Link to the profile page to create the API key](https://app.outscraper.com/profile)
+
+## Usage
+
+```python
+# Get information about the reviews from Trustpilot:
+results = client.trustpilot_reviews(['https://www.trustpilot.com/review/outscraper.com'])
+```

examples/Trustpilot Scraper.md

@@ -0,0 +1,27 @@
+# Trustpilot Scraper With Python
+
+Returns data from Trustpilot businesses. [Outscraper API](https://app.outscraper.cloud/api-docs#tag/Businesses-and-POI/paths/~1trustpilot/get).
+
+## Installation
+
+Python 3+
+```bash
+pip install outscraper
+```
+
+[Link to the Python package page](https://pypi.org/project/outscraper/)
+
+## Initialization
+```python
+from outscraper import ApiClient
+
+client = ApiClient(api_key='SECRET_API_KEY')
+```
+[Link to the profile page to create the API key](https://app.outscraper.com/profile)
+
+## Usage
+
+```python
+# Search data from Trustpilot businesses:
+results = client.trustpilot(['outscraper.com'])
+```

examples/Trustpilot Search Scraper.md

@@ -0,0 +1,27 @@
+# Trustpilot Search Scraper With Python
+
+Returns search results from Trustpilot. [Outscraper API](https://app.outscraper.cloud/api-docs#tag/Trustpilot/paths/~1trustpilot~1search/get).
+
+## Installation
+
+Python 3+
+```bash
+pip install outscraper
+```
+
+[Link to the Python package page](https://pypi.org/project/outscraper/)
+
+## Initialization
+```python
+from outscraper import ApiClient
+
+client = ApiClient(api_key='SECRET_API_KEY')
+```
+[Link to the profile page to create the API key](https://app.outscraper.com/profile)
+
+## Usage
+
+```python
+# Get information about the search results from Trustpilot:
+results = client.trustpilot_search(['real estate'])
+```

examples/Yellow Pages Search Scraper.md

@@ -0,0 +1,27 @@
+# Yellow Pages Search Scraper With Python
+
+Returns search results from Yellow Pages. [Outscraper API](https://app.outscraper.cloud/api-docs#tag/Businesses-and-POI/paths/~1yellowpages-search/get).
+
+## Installation
+
+Python 3+
+```bash
+pip install outscraper
+```
+
+[Link to the Python package page](https://pypi.org/project/outscraper/)
+
+## Initialization
+```python
+from outscraper import ApiClient
+
+client = ApiClient(api_key='SECRET_API_KEY')
+```
+[Link to the profile page to create the API key](https://app.outscraper.com/profile)
+
+## Usage
+
+```python
+# Search results from Yellow Pages:
+results = client.yellowpages_search(['restaurants'])
+```

examples/Youtube Comments Scraper.md

@@ -0,0 +1,27 @@
+# Youtube Comments Scraper With Python
+
+Returns comments from YouTube videos.[Outscraper API](https://app.outscraper.cloud/api-docs#tag/Reviews-and-Comments/paths/~1youtube-comments/get).
+
+## Installation
+
+Python 3+
+```bash
+pip install outscraper
+```
+
+[Link to the Python package page](https://pypi.org/project/outscraper/)
+
+## Initialization
+```python
+from outscraper import ApiClient
+
+client = ApiClient(api_key='SECRET_API_KEY')
+```
+[Link to the profile page to create the API key](https://app.outscraper.com/profile)
+
+## Usage
+
+```python
+# Get information about the comments from YouTube videos:
+results = client.youtube_comments(['https://www.youtube.com/watch?v=ph5pHgklaZ0'])
+```