use latest versions by default

Author: vlad-outscraper

README.md

@@ -35,13 +35,13 @@ results = client.google_search_news('election', language='en')
 
 ```python
 # Search for businesses in specific locations:
-results = client.google_maps_search_v2('restaurants brooklyn usa', limit=20, language='en')
+results = client.google_maps_search('restaurants brooklyn usa', limit=20, language='en')
 
 # Get data of the specific place by id
-results = client.google_maps_search_v2('ChIJrc9T9fpYwokRdvjYRHT8nI4', language='en')
+results = client.google_maps_search('ChIJrc9T9fpYwokRdvjYRHT8nI4', language='en')
 
 # Search with many queries (batching)
-results = client.google_maps_search_v2([
+results = client.google_maps_search([
     'restaurants brooklyn usa',
     'bars brooklyn usa',
 ], language='en')
@@ -52,16 +52,16 @@ results = client.google_maps_search_v2([
 
 ```python
 # Get reviews of the specific place by id
-results = client.google_maps_reviews_v3('ChIJrc9T9fpYwokRdvjYRHT8nI4', reviews_limit=20, language='en')
+results = client.google_maps_reviews('ChIJrc9T9fpYwokRdvjYRHT8nI4', reviews_limit=20, language='en')
 
 # Get reviews for places found by search query
-results = client.google_maps_reviews_v3('Memphis Seoul brooklyn usa', reviews_limit=20, limit=500, language='en')
+results = client.google_maps_reviews('Memphis Seoul brooklyn usa', reviews_limit=20, limit=500, language='en')
 
 # Get only new reviews during last 24 hours
 from datetime import datetime, timedelta
 yesterday_timestamp = int((datetime.now() - timedelta(1)).timestamp())
 
-results = client.google_maps_reviews_v3(
+results = client.google_maps_reviews(
     'ChIJrc9T9fpYwokRdvjYRHT8nI4', sort='newest', cutoff=yesterday_timestamp, reviews_limit=100, language='en')
 ```
 

README.rst

@@ -49,13 +49,13 @@ Scrape Google Maps (Places)
 .. code:: python
 
    # Search for businesses in specific locations:
-   results = client.google_maps_search_v2('restaurants brooklyn usa', limit=20, language='en')
+   results = client.google_maps_search('restaurants brooklyn usa', limit=20, language='en')
 
    # Get data of the specific place by id
-   results = client.google_maps_search_v2('ChIJrc9T9fpYwokRdvjYRHT8nI4', language='en')
+   results = client.google_maps_search('ChIJrc9T9fpYwokRdvjYRHT8nI4', language='en')
 
    # Search with many queries (batching)
-   results = client.google_maps_search_v2([
+   results = client.google_maps_search([
        'restaurants brooklyn usa',
        'bars brooklyn usa',
    ], language='en')
@@ -66,16 +66,16 @@ Scrape Google Maps Reviews
 .. code:: python
 
    # Get reviews of the specific place by id
-   results = client.google_maps_reviews_v3('ChIJrc9T9fpYwokRdvjYRHT8nI4', reviews_limit=20, language='en')
+   results = client.google_maps_reviews('ChIJrc9T9fpYwokRdvjYRHT8nI4', reviews_limit=20, language='en')
 
    # Get reviews for places found by search query
-   results = client.google_maps_reviews_v3('Memphis Seoul brooklyn usa', reviews_limit=20, limit=500, language='en')
+   results = client.google_maps_reviews('Memphis Seoul brooklyn usa', reviews_limit=20, limit=500, language='en')
 
    # Get only new reviews during last 24 hours
    from datetime import datetime, timedelta
    yesterday_timestamp = int((datetime.now() - timedelta(1)).timestamp())
 
-   results = client.google_maps_reviews_v3(
+   results = client.google_maps_reviews(
        'ChIJrc9T9fpYwokRdvjYRHT8nI4', sort='newest', cutoff=yesterday_timestamp, reviews_limit=100, language='en')
 
 Scrape Google Maps Photos

examples/Google Maps Reviews.md

@@ -23,18 +23,18 @@ client = ApiClient(api_key='SECRET_API_KEY')
 
 ```python
 # Get reviews of the specific place by id
-results = client.google_maps_reviews_v3(['ChIJrc9T9fpYwokRdvjYRHT8nI4'], reviews_limit=20, language='en')
+results = client.google_maps_reviews(['ChIJrc9T9fpYwokRdvjYRHT8nI4'], reviews_limit=20, language='en')
 
 # Get reviews for places found by search query
-results = client.google_maps_reviews_v3(['Memphis Seoul brooklyn usa'], reviews_limit=20, limit=500, language='en')
+results = client.google_maps_reviews(['Memphis Seoul brooklyn usa'], reviews_limit=20, limit=500, language='en')
 
 # Get only new reviews during last 24 hours
 yesterday_timestamp = 1657980986
-results = client.google_maps_reviews_v3(
+results = client.google_maps_reviews(
     ['ChIJrc9T9fpYwokRdvjYRHT8nI4'], sort='newest', cutoff=yesterday_timestamp, reviews_limit=100, language='en')
 
 # Scrap Places Reviews by Place Ids
-results = client.google_maps_reviews_v3(
+results = client.google_maps_reviews(
     ["ChIJN5X_gWdZwokRck9rk2guJ1M", "ChIJxWLy8DlawokR1jvfXUPSTUE"],
     reviews_limit=20, # limit of reviews per each place
     limit=1, # limit of palces per each query
@@ -46,7 +46,7 @@ for place in results:
         print('review:', review['review_text'])
 
 # Scrap Only New Reviews
-results = client.google_maps_reviews_v3(
+results = client.google_maps_reviews(
     ["ChIJN5X_gWdZwokRck9rk2guJ1M", "ChIJxWLy8DlawokR1jvfXUPSTUE"],
     reviews_limit=1000,
     limit=1,

examples/Google Maps.md

@@ -23,13 +23,13 @@ client = ApiClient(api_key='SECRET_API_KEY')
 
 ```python
 # Search for businesses in specific locations:
-results = client.google_maps_search_v2(['restaurants brooklyn usa'], limit=20, language='en', region='us')
+results = client.google_maps_search(['restaurants brooklyn usa'], limit=20, language='en', region='us')
 
 # Get data of the specific place by id
-results = client.google_maps_search_v2(['ChIJrc9T9fpYwokRdvjYRHT8nI4'], language='en')
+results = client.google_maps_search(['ChIJrc9T9fpYwokRdvjYRHT8nI4'], language='en')
 
 # Scrap Places by Two Queries
-results = client.google_maps_search_v2(
+results = client.google_maps_search(
     ['restaurants brooklyn usa', 'bars brooklyn usa'],
     limit=50, # limit of palces per each query
     language='en',
@@ -44,7 +44,7 @@ for query_places in results:
         print('website:', place['site'])
 
 # Scrap Places by Place Ids
-results = client.google_maps_search_v2(
+results = client.google_maps_search(
     ["ChIJ8ccnM7dbwokRy-pTMsdgvS4", "ChIJN5X_gWdZwokRck9rk2guJ1M", "ChIJxWLy8DlawokR1jvfXUPSTUE"],
     limit=1, # limit of palces per each query
 )

examples/Run Requests in Parallel.md

@@ -39,5 +39,5 @@ place_ids = [
 ]
 
 pool = ThreadPool(4) # number of threads, use something between 2 and 40
-results = pool.map(partial(client.google_maps_search_v2, language='en', region='US'), place_ids)
+results = pool.map(partial(client.google_maps_search, language='en', region='US'), place_ids)
 ```

outscraper/api_client.py

@@ -153,11 +153,11 @@ def google_search_news(self, query: list, pages_per_query: int = 1, uule: str =
 
         raise Exception(f'Response status code: {response.status_code}')
 
-    def google_maps_search(self, query: list, limit: int = 500, extract_contacts: bool = False, drop_duplicates: bool = False,
+    def google_maps_search_v1(self, query: list, limit: int = 500, extract_contacts: bool = False, drop_duplicates: bool = False,
         coordinates: str = None, language: str = 'en', region: str = None, fields: list = None
     ) -> list:
         '''
-            Get Google Maps Data
+            Get Google Maps Data (old verison)
 
             Returns places from Google Maps based on a given search query (or many queries).
             The results from searches are the same as you would see by visiting a regular Google Maps site. However, in most cases, it's recommended to use locations inside queries (e.g., bars, NY, USA) as the IP addresses of Outscraper's servers might be located in different countries.
@@ -193,7 +193,7 @@ def google_maps_search(self, query: list, limit: int = 500, extract_contacts: bo
 
         raise Exception(f'Response status code: {response.status_code}')
 
-    def google_maps_search_v2(self, query: list, limit: int = 20, drop_duplicates: bool = False,
+    def google_maps_search(self, query: list, limit: int = 20, drop_duplicates: bool = False,
         language: str = 'en', region: str = None, skip: int = 0, fields: list = None,
     ) -> list:
         '''
@@ -273,12 +273,12 @@ def google_maps_directions(self, query: list, departure_time: int = None, finish
 
         raise Exception(f'Response status code: {response.status_code}')
 
-    def google_maps_reviews(self, query: list, reviews_limit: int = 100, limit: int = 1, sort: str = 'most_relevant',
+    def google_maps_reviews_v2(self, query: list, reviews_limit: int = 100, limit: int = 1, sort: str = 'most_relevant',
         skip: int = 0, start: int = None, cutoff: int = None, cutoff_rating: int = None, ignore_empty: bool = False,
         coordinates: str = None, language: str = 'en', region: str = None, fields: list = None
     ) -> list:
         '''
-            Get Google Maps Reviews
+            Get Google Maps Reviews (old verison)
 
             Returns Google Maps reviews 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).
             Places information will be returned as well in the case at least one review is found.
@@ -324,7 +324,7 @@ def google_maps_reviews(self, query: list, reviews_limit: int = 100, limit: int
 
         raise Exception(f'Response status code: {response.status_code}')
 
-    def google_maps_reviews_v3(self, query: list, reviews_limit: int = 10, limit: int = 1, sort: str = 'most_relevant',
+    def google_maps_reviews(self, query: list, reviews_limit: int = 10, limit: int = 1, sort: str = 'most_relevant',
         skip: int = 0, start: int = None, cutoff: int = None, cutoff_rating: int = None, ignore_empty: bool = False,
         language: str = 'en', region: str = None, reviews_query: str = None, fields: list = None
     ) -> list:
@@ -420,12 +420,6 @@ def google_maps_photos(self, query: list, photosLimit: int = 100, limit: int = 1
     def google_maps_business_reviews(self, *args, **kwargs) -> list: # deprecated
         return self.google_maps_reviews(*args, **kwargs)
 
-    def google_maps_reviews_v2(self, *args, **kwargs) -> list: # alias
-        return self.google_maps_reviews(*args, **kwargs)
-
-    def google_search_v3(self, *args, **kwargs) -> list: # alias
-        return self.google_search(*args, **kwargs)
-
     def google_play_reviews(self, query: list, reviews_limit: int = 100, sort: str = 'most_relevant', cutoff: int = None,
         rating: int = None, language: str = 'en', fields: list = None
     ) -> list:

setup.py

@@ -8,7 +8,7 @@ def readme():
 
 setup(
     name='outscraper',
-    version='1.8.0',
+    version='2.0.0',
     description='Python bindings for the Outscraper API',
     long_description=readme(),
     classifiers = ['Programming Language :: Python',