Livescraper Python Library
==========================
The library provides convenient access to the `Livescraper API <https://livescraper.com/api-doc.html>`_ from applications written in the Python language. It allows using `Livescraper’s services <https://livescraper.com/services>`_ from your code.
API Docs
--------
Find the full documentation here:
`API Documentation <https://livescraper.com/api-doc.html>`_
Installation
------------
Python 3+ is required.
To install the package, use the following command:
.. code:: bash
pip install livescraper
For more details, visit:
`Livescraper on PyPI <https://pypi.org/project/livescraper/>`_
Initialization
--------------
To initialize the scraper with your API key:
.. code:: python
from livescraper import ApiClient
scraper = ApiClient(api_key)
Create your API key here:
`Create API Key <https://app.livescraper.com/user-profile>`_
Scrape Google Maps (Places)
===========================
To search for businesses in specific locations:
.. code:: python
# Search for businesses in specific locations
results = scraper.google_maps_search(
queries=["Restaurants in Alakanuk, AK, United States"],
enrichment="True",
fields=[
"query", "google_place_url", "business_name", "business_website", "business_phone",
"type", "sub_types", "category", "full_address", "borough", "street", "city",
"postal_code", "state", "country", "country_code", "timezone", "latitude", "longitude",
"plus_code", "area_service", "review_url", "reviews_id", "total_reviews", "average_rating",
"reviews_per_score", "reviews_per_score_1", "reviews_per_score_2", "reviews_per_score_3",
"reviews_per_score_4", "reviews_per_score_5", "working_hours", "working_hours_old_format",
"popular_time", "about", "posts", "description", "logo_url", "photos_count", "photo_url",
"street_view", "price_range", "business_status", "is_verified", "owner_title", "owner_link",
"owner_id", "reserving_table_links", "booking_appointment_link", "order_link", "menu_link",
"place_id", "google_id", "place_cid", "located_in", "located_google_id", "org_link",
"host", "domain_status", "email_1", "email_2", "email_3", "all_emails", "phone_1",
"phone_2", "phone_3", "all_phones", "contact_page", "facebook", "twitter", "instagram",
"youtube", "linkedin", "website_built_with", "website_title", "website_desc"
]
)
# Get data of a specific place by ID
results = scraper.google_maps_search(
queries=["ChIJrc9T9fpYwokRdvjYRHT8nI4"],
enrichment="True",
fields=[
"query", "google_place_url", "business_name", "business_website", "business_phone",
"type", "sub_types", "category", "full_address", "borough", "street", "city",
"postal_code", "state", "country", "country_code", "timezone", "latitude", "longitude",
"plus_code", "area_service", "review_url", "reviews_id", "total_reviews", "average_rating",
"reviews_per_score", "reviews_per_score_1", "reviews_per_score_2", "reviews_per_score_3",
"reviews_per_score_4", "reviews_per_score_5", "working_hours", "working_hours_old_format",
"popular_time", "about", "posts", "description", "logo_url", "photos_count", "photo_url",
"street_view", "price_range", "business_status", "is_verified", "owner_title", "owner_link",
"owner_id", "reserving_table_links", "booking_appointment_link", "order_link", "menu_link",
"place_id", "google_id", "place_cid", "located_in", "located_google_id", "org_link",
"host", "domain_status", "email_1", "email_2", "email_3", "all_emails", "phone_1",
"phone_2", "phone_3", "all_phones", "contact_page", "facebook", "twitter", "instagram",
"youtube", "linkedin", "website_built_with", "website_title", "website_desc"
]
)
# Search with many queries (batching)
results = scraper.google_maps_search(
queries=[
"restaurants california usa",
"pub brooklyn usa"
],
enrichment="True",
fields=[
"query", "google_place_url", "business_name", "business_website", "business_phone",
"type", "sub_types", "category", "full_address", "borough", "street", "city",
"postal_code", "state", "country", "country_code", "timezone", "latitude", "longitude",
"plus_code", "area_service", "review_url", "reviews_id", "total_reviews", "average_rating",
"reviews_per_score", "reviews_per_score_1", "reviews_per_score_2", "reviews_per_score_3",
"reviews_per_score_4", "reviews_per_score_5", "working_hours", "working_hours_old_format",
"popular_time", "about", "posts", "description", "logo_url", "photos_count", "photo_url",
"street_view", "price_range", "business_status", "is_verified", "owner_title", "owner_link",
"owner_id", "reserving_table_links", "booking_appointment_link", "order_link", "menu_link",
"place_id", "google_id", "place_cid", "located_in", "located_google_id", "org_link",
"host", "domain_status", "email_1", "email_2", "email_3", "all_emails", "phone_1",
"phone_2", "phone_3", "all_phones", "contact_page", "facebook", "twitter", "instagram",
"youtube", "linkedin", "website_built_with", "website_title", "website_desc"
]
)
Scrape Google Maps Reviews
==========================
To get reviews of a specific place:
.. code:: python
# Get reviews of the specific place by ID
results = scraper.google_review_search(
'ChIJrc9T9fpYwokRdvjYRHT8nI4',
fields=[
"query", "business_name", "google_id", "place_id", "place_cid", "google_place_url",
"review_url", "reviews_per_score", "total_reviews", "average_rating", "review_id",
"author_link", "author_title", "author_id", "author_image", "review_text",
"review_img_url", "review_img_urls", "owner_answer", "owner_answer_timestamp",
"owner_answer_timestamp_datetime_utc", "review_link", "review_rating",
"review_timestamp", "review_datetime_utc", "review_likes", "reviews_id"
]
)
# Get reviews for places found by search query
results = scraper.google_review_search(
'real estate agents in Los Angeles, CA',
fields=[
"query", "business_name", "google_id", "place_id", "place_cid", "google_place_url",
"review_url", "reviews_per_score", "total_reviews", "average_rating", "review_id",
"author_link", "author_title", "author_id", "author_image", "review_text",
"review_img_url", "review_img_urls", "owner_answer", "owner_answer_timestamp",
"owner_answer_timestamp_datetime_utc", "review_link", "review_rating",
"review_timestamp", "review_datetime_utc", "review_likes", "reviews_id"
]
)
Scrape Emails and Contacts
==========================
To get emails and contacts from a URL:
.. code:: python
# Get emails and contacts from a specific URL
results = scraper.google_email_search(
queries=["livescraper.com"]
)
Responses examples
==================
Google Maps (Places) response example:
.. code:: python
[
{
"name": "The Rustic Table",
"full_address": "45 Elm Street, Greenfield, MA 01301",
"borough": "Downtown Greenfield",
"street": "45 Elm Street",
"city": "Greenfield",
"postal_code": "01301",
"country_code": "US",
"country": "United States of America",
"us_state": "Massachusetts",
"state": "Massachusetts",
"plus_code": null,
"latitude": 42.587042,
"longitude": -72.601493,
"time_zone": "America/New_York",
"popular_times": null,
"site": "http://www.therustictable.com/",
"phone": "+1 413-555-1234",
"type": "Farm-to-table restaurant",
"category": "restaurants",
"subtypes": "Farm-to-table restaurant, Bistro, Organic restaurant, Vegan restaurant, Restaurant, Wine bar",
"posts": null,
"rating": 4.7,
"reviews": 540,
"reviews_data": null,
"photos_count": 320,
"google_id": "0x89df123456789abc:0xa1b2c3d4e5f6g7h8",
"place_id": "ChIJ1234abcd5678efgh90ijkl",
"reviews_link": "https://search.google.com/local/reviews?placeid=ChIJ1234abcd5678efgh90ijkl&q=restaurants+greenfield+usa&authuser=0&hl=en&gl=US",
"reviews_id": "-1234567890123456789",
"photo": "https://example.com/photos/restaurant.jpg",
"street_view": "https://example.com/streetview/restaurant.jpg",
"working_hours_old_format": "Monday: Closed | Tuesday: 5–10PM | Wednesday: 5–10PM | Thursday: 5–10PM | Friday: 5–11PM | Saturday: 12–3PM, 5–11PM | Sunday: 12–3PM, 5–9PM",
"working_hours": {
"Monday": "Closed",
"Tuesday": "5–10PM",
"Wednesday": "5–10PM",
"Thursday": "5–10PM",
"Friday": "5–11PM",
"Saturday": "12–3PM, 5–11PM",
"Sunday": "12–3PM, 5–9PM"
},
"business_status": "OPERATIONAL",
"about": {
"Service options": {
"Dine-in": true,
"Delivery": true,
"Takeout": true
},
"Health & safety": {
"Mask required": false,
"Staff required to disinfect surfaces between visits": true
},
"Highlights": {
"Farm-to-table ingredients": true,
"Great cocktails": true,
"Live music": true
},
"Popular for": {
"Lunch": true,
"Dinner": true,
"Special occasions": true
},
"Accessibility": {
"Wheelchair accessible entrance": true,
"Wheelchair accessible restroom": true,
"Wheelchair accessible seating": true
},
"Offerings": {
"Local beers": true,
"Seasonal dishes": true,
"Vegetarian options": true,
"Vegan options": true,
"Organic dishes": true,
"Wine": true
},
"Dining options": {
"Dessert": true,
"Outdoor seating": true
},
"Amenities": {
"Free parking": true,
"Wi-Fi": true
},
"Atmosphere": {
"Cozy": true,
"Casual": true,
"Family-friendly": true
},
"Crowd": {
"Groups": true,
"Couples": true
},
"Planning": {
"Dinner reservations recommended": true,
"Accepts reservations": true
},
"Payments": {
"Credit cards": true,
"Contactless payments": true
}
},
"range": "$$",
"reviews_per_score": {
"1": 5,
"2": 7,
"3": 30,
"4": 120,
"5": 378
},
"reserving_table_link": "https://example.com/reserve",
"booking_appointment_link": "https://example.com/book",
"owner_id": "123456789012345678901",
"verified": true,
"owner_title": "The Rustic Table",
"owner_link": "https://www.google.com/maps/contrib/123456789012345678901",
"location_link": "https://www.google.com/maps/place/The+Rustic+Table/@42.587042,-72.601493,14z/data=!4m8!1m2!2m1!1sRustic+Table!3m4!1s0x89df123456789abc:0xa1b2c3d4e5f6g7h8!8m2!3d42.587042!4d-72.601493"
}
]
Google Maps Reviews response example:
.. code:: python
[
{
"name": "Urban Feast",
"address": "123 Main St, Springfield, IL 62701",
"type": "Contemporary restaurant",
"postal_code": "62701",
"latitude": 39.7817213,
"longitude": -89.6501481,
"phone": "+1 217-555-1234",
"rating": 4.8,
"reviews": 432,
"site": "http://www.urbanfeast.com/",
"photos_count": 250,
"google_id": "0x89abcdef12345678:0xabcdef1234567890",
"reviews_link": "https://www.google.com/search?q=Urban+Feast,+123+Main+St,+Springfield,+IL+62701&ludocid=1234567890987654321#lrd=0x89abcdef12345678:0xabcdef1234567890,1",
"reviews_data": [
{
"google_id": "0x89abcdef12345678:0xabcdef1234567890",
"autor_link": "https://www.google.com/maps/contrib/11234567890123456789?hl=en-US",
"autor_name": "Jane Doe",
"autor_id": "11234567890123456789",
"review_text": "Amazing food and great atmosphere! Highly recommend the chef's special.",
"review_link": "https://www.google.com/maps/reviews/data=!4m5!14m4!1m3!1m2!1s11234567890123456789!2s0x0:0xabcdef1234567890?hl=en-US",
"review_rating": 5,
"review_timestamp": 1680304800,
"review_datetime_utc": "03/31/2023 12:00:00",
"review_likes": 10
}
]
}
]
Emails & Contacts Scraper response example:
.. code:: python
[
{
"query": "livescraper.com",
"domain": "livescraper.com",
"emails": [
{
"value": "support@livescraper.com",
"sources": [
{
"ref": "https://livescraper.com/",
"extracted_on": "2023-01-01T10:00:00.000Z",
"updated_on": "2023-03-01T12:00:00.000Z"
}
]
}
],
"phones": [
{
"value": "12812368208",
"sources": [
{
"ref": "https://livescraper.com/",
"extracted_on": "2023-01-01T10:00:00.000Z",
"updated_on": "2023-03-01T12:00:00.000Z"
}
]
}
],
"socials": {
"facebook": "https://www.facebook.com/livescraper/",
"github": "https://github.com/livescraper",
"linkedin": "https://www.linkedin.com/company/livescraper/",
"twitter": "https://twitter.com/livescraper",
"youtube": "https://www.youtube.com/channel/UCDYOuXSEenLpt5tKNq-0l9Q"
},
"site_data": {
"description": "Scrape Google Maps Places, Business Reviews, and more using Livescraper API.",
"title": "Livescraper - Web Scraping Simplified"
}
}
]
Raw data
{
"_id": null,
"home_page": null,
"name": "livescraper",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.6",
"maintainer_email": null,
"keywords": "livescraper webscraper extractor google api maps search json scrape parser reviews google play",
"author": "livescraper",
"author_email": "livescraper@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/af/49/5501ca26155b4a1c22b4dedcec12a9848b8758c14f37ad350eeec4c6caf8/livescraper-1.5.0.tar.gz",
"platform": null,
"description": "Livescraper Python Library\r\n==========================\r\n\r\nThe library provides convenient access to the `Livescraper API <https://livescraper.com/api-doc.html>`_ from applications written in the Python language. It allows using `Livescraper\u00e2\u20ac\u2122s services <https://livescraper.com/services>`_ from your code.\r\n\r\nAPI Docs\r\n--------\r\n\r\nFind the full documentation here:\r\n`API Documentation <https://livescraper.com/api-doc.html>`_\r\n\r\nInstallation\r\n------------\r\n\r\nPython 3+ is required.\r\n\r\nTo install the package, use the following command:\r\n\r\n.. code:: bash\r\n\r\n pip install livescraper\r\n\r\nFor more details, visit:\r\n`Livescraper on PyPI <https://pypi.org/project/livescraper/>`_\r\n\r\nInitialization\r\n--------------\r\n\r\nTo initialize the scraper with your API key:\r\n\r\n.. code:: python\r\n\r\n from livescraper import ApiClient\r\n\r\n scraper = ApiClient(api_key)\r\n\r\nCreate your API key here:\r\n`Create API Key <https://app.livescraper.com/user-profile>`_\r\n\r\nScrape Google Maps (Places)\r\n===========================\r\n\r\nTo search for businesses in specific locations:\r\n\r\n.. code:: python\r\n\r\n # Search for businesses in specific locations\r\n results = scraper.google_maps_search(\r\n queries=[\"Restaurants in Alakanuk, AK, United States\"],\r\n enrichment=\"True\",\r\n fields=[\r\n \"query\", \"google_place_url\", \"business_name\", \"business_website\", \"business_phone\", \r\n \"type\", \"sub_types\", \"category\", \"full_address\", \"borough\", \"street\", \"city\", \r\n \"postal_code\", \"state\", \"country\", \"country_code\", \"timezone\", \"latitude\", \"longitude\", \r\n \"plus_code\", \"area_service\", \"review_url\", \"reviews_id\", \"total_reviews\", \"average_rating\", \r\n \"reviews_per_score\", \"reviews_per_score_1\", \"reviews_per_score_2\", \"reviews_per_score_3\", \r\n \"reviews_per_score_4\", \"reviews_per_score_5\", \"working_hours\", \"working_hours_old_format\", \r\n \"popular_time\", \"about\", \"posts\", \"description\", \"logo_url\", \"photos_count\", \"photo_url\", \r\n \"street_view\", \"price_range\", \"business_status\", \"is_verified\", \"owner_title\", \"owner_link\", \r\n \"owner_id\", \"reserving_table_links\", \"booking_appointment_link\", \"order_link\", \"menu_link\", \r\n \"place_id\", \"google_id\", \"place_cid\", \"located_in\", \"located_google_id\", \"org_link\", \r\n \"host\", \"domain_status\", \"email_1\", \"email_2\", \"email_3\", \"all_emails\", \"phone_1\", \r\n \"phone_2\", \"phone_3\", \"all_phones\", \"contact_page\", \"facebook\", \"twitter\", \"instagram\", \r\n \"youtube\", \"linkedin\", \"website_built_with\", \"website_title\", \"website_desc\"\r\n ]\r\n )\r\n\r\n # Get data of a specific place by ID\r\n results = scraper.google_maps_search(\r\n queries=[\"ChIJrc9T9fpYwokRdvjYRHT8nI4\"],\r\n enrichment=\"True\",\r\n fields=[\r\n \"query\", \"google_place_url\", \"business_name\", \"business_website\", \"business_phone\", \r\n \"type\", \"sub_types\", \"category\", \"full_address\", \"borough\", \"street\", \"city\", \r\n \"postal_code\", \"state\", \"country\", \"country_code\", \"timezone\", \"latitude\", \"longitude\", \r\n \"plus_code\", \"area_service\", \"review_url\", \"reviews_id\", \"total_reviews\", \"average_rating\", \r\n \"reviews_per_score\", \"reviews_per_score_1\", \"reviews_per_score_2\", \"reviews_per_score_3\", \r\n \"reviews_per_score_4\", \"reviews_per_score_5\", \"working_hours\", \"working_hours_old_format\", \r\n \"popular_time\", \"about\", \"posts\", \"description\", \"logo_url\", \"photos_count\", \"photo_url\", \r\n \"street_view\", \"price_range\", \"business_status\", \"is_verified\", \"owner_title\", \"owner_link\", \r\n \"owner_id\", \"reserving_table_links\", \"booking_appointment_link\", \"order_link\", \"menu_link\", \r\n \"place_id\", \"google_id\", \"place_cid\", \"located_in\", \"located_google_id\", \"org_link\", \r\n \"host\", \"domain_status\", \"email_1\", \"email_2\", \"email_3\", \"all_emails\", \"phone_1\", \r\n \"phone_2\", \"phone_3\", \"all_phones\", \"contact_page\", \"facebook\", \"twitter\", \"instagram\", \r\n \"youtube\", \"linkedin\", \"website_built_with\", \"website_title\", \"website_desc\"\r\n ]\r\n )\r\n\r\n # Search with many queries (batching)\r\n results = scraper.google_maps_search(\r\n queries=[\r\n \"restaurants california usa\",\r\n \"pub brooklyn usa\"\r\n ],\r\n enrichment=\"True\",\r\n fields=[\r\n \"query\", \"google_place_url\", \"business_name\", \"business_website\", \"business_phone\", \r\n \"type\", \"sub_types\", \"category\", \"full_address\", \"borough\", \"street\", \"city\", \r\n \"postal_code\", \"state\", \"country\", \"country_code\", \"timezone\", \"latitude\", \"longitude\", \r\n \"plus_code\", \"area_service\", \"review_url\", \"reviews_id\", \"total_reviews\", \"average_rating\", \r\n \"reviews_per_score\", \"reviews_per_score_1\", \"reviews_per_score_2\", \"reviews_per_score_3\", \r\n \"reviews_per_score_4\", \"reviews_per_score_5\", \"working_hours\", \"working_hours_old_format\", \r\n \"popular_time\", \"about\", \"posts\", \"description\", \"logo_url\", \"photos_count\", \"photo_url\", \r\n \"street_view\", \"price_range\", \"business_status\", \"is_verified\", \"owner_title\", \"owner_link\", \r\n \"owner_id\", \"reserving_table_links\", \"booking_appointment_link\", \"order_link\", \"menu_link\", \r\n \"place_id\", \"google_id\", \"place_cid\", \"located_in\", \"located_google_id\", \"org_link\", \r\n \"host\", \"domain_status\", \"email_1\", \"email_2\", \"email_3\", \"all_emails\", \"phone_1\", \r\n \"phone_2\", \"phone_3\", \"all_phones\", \"contact_page\", \"facebook\", \"twitter\", \"instagram\", \r\n \"youtube\", \"linkedin\", \"website_built_with\", \"website_title\", \"website_desc\"\r\n ]\r\n )\r\n\r\nScrape Google Maps Reviews\r\n==========================\r\n\r\nTo get reviews of a specific place:\r\n\r\n.. code:: python\r\n\r\n # Get reviews of the specific place by ID\r\n results = scraper.google_review_search(\r\n 'ChIJrc9T9fpYwokRdvjYRHT8nI4',\r\n fields=[\r\n \"query\", \"business_name\", \"google_id\", \"place_id\", \"place_cid\", \"google_place_url\",\r\n \"review_url\", \"reviews_per_score\", \"total_reviews\", \"average_rating\", \"review_id\",\r\n \"author_link\", \"author_title\", \"author_id\", \"author_image\", \"review_text\",\r\n \"review_img_url\", \"review_img_urls\", \"owner_answer\", \"owner_answer_timestamp\",\r\n \"owner_answer_timestamp_datetime_utc\", \"review_link\", \"review_rating\",\r\n \"review_timestamp\", \"review_datetime_utc\", \"review_likes\", \"reviews_id\"\r\n ]\r\n )\r\n\r\n # Get reviews for places found by search query\r\n results = scraper.google_review_search(\r\n 'real estate agents in Los Angeles, CA',\r\n fields=[\r\n \"query\", \"business_name\", \"google_id\", \"place_id\", \"place_cid\", \"google_place_url\",\r\n \"review_url\", \"reviews_per_score\", \"total_reviews\", \"average_rating\", \"review_id\",\r\n \"author_link\", \"author_title\", \"author_id\", \"author_image\", \"review_text\",\r\n \"review_img_url\", \"review_img_urls\", \"owner_answer\", \"owner_answer_timestamp\",\r\n \"owner_answer_timestamp_datetime_utc\", \"review_link\", \"review_rating\",\r\n \"review_timestamp\", \"review_datetime_utc\", \"review_likes\", \"reviews_id\"\r\n ]\r\n )\r\n\r\nScrape Emails and Contacts\r\n==========================\r\n\r\nTo get emails and contacts from a URL:\r\n\r\n.. code:: python\r\n\r\n # Get emails and contacts from a specific URL\r\n results = scraper.google_email_search(\r\n queries=[\"livescraper.com\"]\r\n )\r\n\r\n\r\nResponses examples\r\n==================\r\n\r\nGoogle Maps (Places) response example:\r\n\r\n.. code:: python\r\n\r\n [\r\n {\r\n \"name\": \"The Rustic Table\",\r\n \"full_address\": \"45 Elm Street, Greenfield, MA 01301\",\r\n \"borough\": \"Downtown Greenfield\",\r\n \"street\": \"45 Elm Street\",\r\n \"city\": \"Greenfield\",\r\n \"postal_code\": \"01301\",\r\n \"country_code\": \"US\",\r\n \"country\": \"United States of America\",\r\n \"us_state\": \"Massachusetts\",\r\n \"state\": \"Massachusetts\",\r\n \"plus_code\": null,\r\n \"latitude\": 42.587042,\r\n \"longitude\": -72.601493,\r\n \"time_zone\": \"America/New_York\",\r\n \"popular_times\": null,\r\n \"site\": \"http://www.therustictable.com/\",\r\n \"phone\": \"+1 413-555-1234\",\r\n \"type\": \"Farm-to-table restaurant\",\r\n \"category\": \"restaurants\",\r\n \"subtypes\": \"Farm-to-table restaurant, Bistro, Organic restaurant, Vegan restaurant, Restaurant, Wine bar\",\r\n \"posts\": null,\r\n \"rating\": 4.7,\r\n \"reviews\": 540,\r\n \"reviews_data\": null,\r\n \"photos_count\": 320,\r\n \"google_id\": \"0x89df123456789abc:0xa1b2c3d4e5f6g7h8\",\r\n \"place_id\": \"ChIJ1234abcd5678efgh90ijkl\",\r\n \"reviews_link\": \"https://search.google.com/local/reviews?placeid=ChIJ1234abcd5678efgh90ijkl&q=restaurants+greenfield+usa&authuser=0&hl=en&gl=US\",\r\n \"reviews_id\": \"-1234567890123456789\",\r\n \"photo\": \"https://example.com/photos/restaurant.jpg\",\r\n \"street_view\": \"https://example.com/streetview/restaurant.jpg\",\r\n \"working_hours_old_format\": \"Monday: Closed | Tuesday: 5\u00e2\u20ac\u201c10PM | Wednesday: 5\u00e2\u20ac\u201c10PM | Thursday: 5\u00e2\u20ac\u201c10PM | Friday: 5\u00e2\u20ac\u201c11PM | Saturday: 12\u00e2\u20ac\u201c3PM, 5\u00e2\u20ac\u201c11PM | Sunday: 12\u00e2\u20ac\u201c3PM, 5\u00e2\u20ac\u201c9PM\",\r\n \"working_hours\": {\r\n \"Monday\": \"Closed\",\r\n \"Tuesday\": \"5\u00e2\u20ac\u201c10PM\",\r\n \"Wednesday\": \"5\u00e2\u20ac\u201c10PM\",\r\n \"Thursday\": \"5\u00e2\u20ac\u201c10PM\",\r\n \"Friday\": \"5\u00e2\u20ac\u201c11PM\",\r\n \"Saturday\": \"12\u00e2\u20ac\u201c3PM, 5\u00e2\u20ac\u201c11PM\",\r\n \"Sunday\": \"12\u00e2\u20ac\u201c3PM, 5\u00e2\u20ac\u201c9PM\"\r\n },\r\n \"business_status\": \"OPERATIONAL\",\r\n \"about\": {\r\n \"Service options\": {\r\n \"Dine-in\": true,\r\n \"Delivery\": true,\r\n \"Takeout\": true\r\n },\r\n \"Health & safety\": {\r\n \"Mask required\": false,\r\n \"Staff required to disinfect surfaces between visits\": true\r\n },\r\n \"Highlights\": {\r\n \"Farm-to-table ingredients\": true,\r\n \"Great cocktails\": true,\r\n \"Live music\": true\r\n },\r\n \"Popular for\": {\r\n \"Lunch\": true,\r\n \"Dinner\": true,\r\n \"Special occasions\": true\r\n },\r\n \"Accessibility\": {\r\n \"Wheelchair accessible entrance\": true,\r\n \"Wheelchair accessible restroom\": true,\r\n \"Wheelchair accessible seating\": true\r\n },\r\n \"Offerings\": {\r\n \"Local beers\": true,\r\n \"Seasonal dishes\": true,\r\n \"Vegetarian options\": true,\r\n \"Vegan options\": true,\r\n \"Organic dishes\": true,\r\n \"Wine\": true\r\n },\r\n \"Dining options\": {\r\n \"Dessert\": true,\r\n \"Outdoor seating\": true\r\n },\r\n \"Amenities\": {\r\n \"Free parking\": true,\r\n \"Wi-Fi\": true\r\n },\r\n \"Atmosphere\": {\r\n \"Cozy\": true,\r\n \"Casual\": true,\r\n \"Family-friendly\": true\r\n },\r\n \"Crowd\": {\r\n \"Groups\": true,\r\n \"Couples\": true\r\n },\r\n \"Planning\": {\r\n \"Dinner reservations recommended\": true,\r\n \"Accepts reservations\": true\r\n },\r\n \"Payments\": {\r\n \"Credit cards\": true,\r\n \"Contactless payments\": true\r\n }\r\n },\r\n \"range\": \"$$\",\r\n \"reviews_per_score\": {\r\n \"1\": 5,\r\n \"2\": 7,\r\n \"3\": 30,\r\n \"4\": 120,\r\n \"5\": 378\r\n },\r\n \"reserving_table_link\": \"https://example.com/reserve\",\r\n \"booking_appointment_link\": \"https://example.com/book\",\r\n \"owner_id\": \"123456789012345678901\",\r\n \"verified\": true,\r\n \"owner_title\": \"The Rustic Table\",\r\n \"owner_link\": \"https://www.google.com/maps/contrib/123456789012345678901\",\r\n \"location_link\": \"https://www.google.com/maps/place/The+Rustic+Table/@42.587042,-72.601493,14z/data=!4m8!1m2!2m1!1sRustic+Table!3m4!1s0x89df123456789abc:0xa1b2c3d4e5f6g7h8!8m2!3d42.587042!4d-72.601493\"\r\n }\r\n ]\r\n\r\nGoogle Maps Reviews response example:\r\n\r\n.. code:: python\r\n\r\n [\r\n {\r\n \"name\": \"Urban Feast\",\r\n \"address\": \"123 Main St, Springfield, IL 62701\",\r\n \"type\": \"Contemporary restaurant\",\r\n \"postal_code\": \"62701\",\r\n \"latitude\": 39.7817213,\r\n \"longitude\": -89.6501481,\r\n \"phone\": \"+1 217-555-1234\",\r\n \"rating\": 4.8,\r\n \"reviews\": 432,\r\n \"site\": \"http://www.urbanfeast.com/\",\r\n \"photos_count\": 250,\r\n \"google_id\": \"0x89abcdef12345678:0xabcdef1234567890\",\r\n \"reviews_link\": \"https://www.google.com/search?q=Urban+Feast,+123+Main+St,+Springfield,+IL+62701&ludocid=1234567890987654321#lrd=0x89abcdef12345678:0xabcdef1234567890,1\",\r\n \"reviews_data\": [\r\n {\r\n \"google_id\": \"0x89abcdef12345678:0xabcdef1234567890\",\r\n \"autor_link\": \"https://www.google.com/maps/contrib/11234567890123456789?hl=en-US\",\r\n \"autor_name\": \"Jane Doe\",\r\n \"autor_id\": \"11234567890123456789\",\r\n \"review_text\": \"Amazing food and great atmosphere! Highly recommend the chef's special.\",\r\n \"review_link\": \"https://www.google.com/maps/reviews/data=!4m5!14m4!1m3!1m2!1s11234567890123456789!2s0x0:0xabcdef1234567890?hl=en-US\",\r\n \"review_rating\": 5,\r\n \"review_timestamp\": 1680304800,\r\n \"review_datetime_utc\": \"03/31/2023 12:00:00\",\r\n \"review_likes\": 10\r\n }\r\n ]\r\n }\r\n ]\r\n\r\nEmails & Contacts Scraper response example:\r\n\r\n.. code:: python\r\n\r\n [\r\n {\r\n \"query\": \"livescraper.com\",\r\n \"domain\": \"livescraper.com\",\r\n \"emails\": [\r\n {\r\n \"value\": \"support@livescraper.com\",\r\n \"sources\": [\r\n {\r\n \"ref\": \"https://livescraper.com/\",\r\n \"extracted_on\": \"2023-01-01T10:00:00.000Z\",\r\n \"updated_on\": \"2023-03-01T12:00:00.000Z\"\r\n }\r\n ]\r\n }\r\n ],\r\n \"phones\": [\r\n {\r\n \"value\": \"12812368208\",\r\n \"sources\": [\r\n {\r\n \"ref\": \"https://livescraper.com/\",\r\n \"extracted_on\": \"2023-01-01T10:00:00.000Z\",\r\n \"updated_on\": \"2023-03-01T12:00:00.000Z\"\r\n }\r\n ]\r\n }\r\n ],\r\n \"socials\": {\r\n \"facebook\": \"https://www.facebook.com/livescraper/\",\r\n \"github\": \"https://github.com/livescraper\",\r\n \"linkedin\": \"https://www.linkedin.com/company/livescraper/\",\r\n \"twitter\": \"https://twitter.com/livescraper\",\r\n \"youtube\": \"https://www.youtube.com/channel/UCDYOuXSEenLpt5tKNq-0l9Q\"\r\n },\r\n \"site_data\": {\r\n \"description\": \"Scrape Google Maps Places, Business Reviews, and more using Livescraper API.\",\r\n \"title\": \"Livescraper - Web Scraping Simplified\"\r\n }\r\n }\r\n ]\r\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Python bindings for the Livescraper API",
"version": "1.5.0",
"project_urls": null,
"split_keywords": [
"livescraper",
"webscraper",
"extractor",
"google",
"api",
"maps",
"search",
"json",
"scrape",
"parser",
"reviews",
"google",
"play"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "dd76fe5fd3944e65d5e9746e45533326cdf8ea0e72f58f8cfef6e5f9b05a60ef",
"md5": "a21dd0963bdc0cc50bfce1bb1d17fd3c",
"sha256": "e9f64999b9cc47606a1ab481a8b472fb6e17d414c20cf7bfab3155f7a89bd60e"
},
"downloads": -1,
"filename": "livescraper-1.5.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "a21dd0963bdc0cc50bfce1bb1d17fd3c",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.6",
"size": 6208,
"upload_time": "2025-01-13T09:28:48",
"upload_time_iso_8601": "2025-01-13T09:28:48.242886Z",
"url": "https://files.pythonhosted.org/packages/dd/76/fe5fd3944e65d5e9746e45533326cdf8ea0e72f58f8cfef6e5f9b05a60ef/livescraper-1.5.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "af495501ca26155b4a1c22b4dedcec12a9848b8758c14f37ad350eeec4c6caf8",
"md5": "fbefb8f8ea9c4973b46ada90a9d75936",
"sha256": "da2ef16db899d5c910e4a9216f6c97655a655ef48d5f871dee2a55ca2d379650"
},
"downloads": -1,
"filename": "livescraper-1.5.0.tar.gz",
"has_sig": false,
"md5_digest": "fbefb8f8ea9c4973b46ada90a9d75936",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6",
"size": 6935,
"upload_time": "2025-01-13T09:28:50",
"upload_time_iso_8601": "2025-01-13T09:28:50.964365Z",
"url": "https://files.pythonhosted.org/packages/af/49/5501ca26155b4a1c22b4dedcec12a9848b8758c14f37ad350eeec4c6caf8/livescraper-1.5.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-01-13 09:28:50",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "livescraper"
}
JSON