{"id":25715106,"url":"https://github.com/christivn/mapscraper","last_synced_at":"2025-05-05T16:22:30.252Z","repository":{"id":245262577,"uuid":"817732560","full_name":"christivn/mapScraper","owner":"christivn","description":"🤖🗺️ Headless browser scraper written in python to extract Places data from Google Maps.","archived":false,"fork":false,"pushed_at":"2024-12-19T09:13:44.000Z","size":86,"stargazers_count":11,"open_issues_count":0,"forks_count":2,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-30T22:22:10.113Z","etag":null,"topics":["google-map-api","google-maps","google-maps-api","google-maps-scraper","google-maps-scraping","google-places","google-scraper","lead","lead-generation","prospecting","prospects","python","python-scraper","serapi"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/christivn.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-06-20T10:24:28.000Z","updated_at":"2025-03-03T14:15:50.000Z","dependencies_parsed_at":"2024-11-12T09:25:08.750Z","dependency_job_id":"6e71a0e9-519a-4c8a-94cb-7e98c15910c7","html_url":"https://github.com/christivn/mapScraper","commit_stats":null,"previous_names":["christivn/google-places-scraper"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/christivn%2FmapScraper","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/christivn%2FmapScraper/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/christivn%2FmapScraper/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/christivn%2FmapScraper/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/christivn","download_url":"https://codeload.github.com/christivn/mapScraper/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252531944,"owners_count":21763307,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["google-map-api","google-maps","google-maps-api","google-maps-scraper","google-maps-scraping","google-places","google-scraper","lead","lead-generation","prospecting","prospects","python","python-scraper","serapi"],"created_at":"2025-02-25T13:42:58.501Z","updated_at":"2025-05-05T16:22:30.223Z","avatar_url":"https://github.com/christivn.png","language":"Python","readme":"![Header](https://github.com/christivn/mapScraper/blob/main/github-header-image.png?raw=true)\n\n## 🚀 Features\nWith the **Google Maps Scraper**, you can obtain detailed data about businesses and specific places on Google Maps, such as:\n- Place ID\n- Place name\n- Category\n- Full address\n- Phone number\n- Associated domain and URL\n- Coordinates (latitude and longitude)\n- Average star rating\n- Number of reviews\n\n\u003cbr\u003e\n\n## 📦 Required Packages\nTo run this scraper, you'll need the following Python packages:\n- `requests_html` - for making HTML requests and rendering dynamic content\n- `urllib` - for URL handling\n- `json` - for managing structured data in JSON format\n\n\u003cbr\u003e\n\n## ➡️ Code Example\nHere's a basic usage example:\n\n```python\nfrom mapScraper import placesCrawlerV2\n\n# Define your query\nquery = \"Gym in Seville Spain\"\n# Run the search\nresults = placesCrawlerV2.search(query)\n\n# Display the results\nprint(results)\n```\n\n\u003cbr\u003e\n\n## 📋 Example Output\nThe scraper returns a list in JSON format with detailed information about the found places. Here’s a sample output:\n\n```json\n[\n  {\n    \"id\": \"ChIJP0UWUA9sEg0RuJoxZuLavLs\",\n    \"title\": \"Sevilla\",\n    \"category\": \"Gym\",\n    \"address\": \"C. Amor de Dios, 35, Casco Antiguo, 41002 Sevilla\",\n    \"phoneNumber\": \"681 96 61 09\",\n    \"completePhoneNumber\": \"+34 681 96 61 09\",\n    \"domain\": \"instagram.com\",\n    \"url\": \"https://instagram.com/sevillagym_oficial?utm_medium=copy_link\",\n    \"coor\": \"37.3958503,-5.994440399999999\",\n    \"stars\": 4.3,\n    \"reviews\": 253\n  },\n  {\n    \"id\": \"ChIJD6RGzE9pEg0RJmWVq_nh2j0\",\n    \"title\": \"Sevilla Century Fitness Gym\",\n    \"category\": \"Gymnastics center\",\n    \"address\": \"Av. del Alcalde Manuel del Valle, 50, Norte, 41015 Sevilla\",\n    \"phoneNumber\": \"691 84 08 73\",\n    \"completePhoneNumber\": \"+34 691 84 08 73\",\n    \"domain\": \"www.centuryfitness.es\",\n    \"url\": \"https://www.centuryfitness.es/\",\n    \"coor\": \"37.4127951,-5.9724556\",\n    \"stars\": 4.8,\n    \"reviews\": 2442\n  },\n  {\n    \"id\": \"ChIJNYda7WtsEg0RCC83FLkQK1Q\",\n    \"title\": \"Hispanic Happiness Club\",\n    \"category\": \"Athletic club\",\n    \"address\": \"C. Ignacio Gómez Millán, s/n, 41010 Sevilla\",\n    \"phoneNumber\": \"954 33 88 08\",\n    \"completePhoneNumber\": \"+34 954 33 88 08\",\n    \"domain\": \"www.galisport.com\",\n    \"url\": \"http://www.galisport.com/\",\n    \"coor\": \"37.3839533,-6.007852499999999\",\n    \"stars\": 3.5,\n    \"reviews\": 172\n  }\n]\n```\n\n\u003cbr\u003e\n\n## 🛠️ Setup and Usage\n1. Clone this repository.\n2. Make sure you have the necessary packages installed.\n3. Modify the `query` to customize your search and run the script to see the results.\n\n\u003cbr\u003e\n\n## ⚠️ Note\nThis project is for educational and research purposes only. Please respect Google’s usage policies and terms of service.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchristivn%2Fmapscraper","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fchristivn%2Fmapscraper","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchristivn%2Fmapscraper/lists"}