{ "openapi": "3.0.1", "info": { "title": "Google Maps Scraper ā€” Emails, Reviews, Leads & Photos", "description": "Scrape Google Maps into clean datasets: business listings with emails, phone numbers and social links, plus reviews, photos, owner posts and AI review keywords. 12 operations ā€” search, search-in-area, nearby, details, reviews, photos, posts, autocomplete. Pay per result.", "version": "1.1", "x-build-id": "f2SBDDi9DQZizaUVy" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/sian.agency~local-business-data-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-sian.agency-local-business-data-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/sian.agency~local-business-data-scraper/runs": { "post": { "operationId": "runs-sync-sian.agency-local-business-data-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/sian.agency~local-business-data-scraper/run-sync": { "post": { "operationId": "run-sync-sian.agency-local-business-data-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "operation": { "title": "šŸŽÆ Operation ā€” what do you want to scrape?", "enum": [ "search", "searchInArea", "searchNearby", "businessDetails", "businessDetailsPlus", "businessReviews", "reviewDetails", "businessPhotos", "photoDetails", "businessPosts", "reverseGeocoding", "autocomplete" ], "type": "string", "description": "šŸŽÆ **Pick one operation per run.** Search finds places; Details, Reviews, and Photos enrich a known Business ID; Utilities are free lookups.\n\nā€¢ **Search / In Area / Nearby** ā€” keyword or multi-category search with emails & contacts\nā€¢ **Business Details / Plus** ā€” full details, socials & AI review keywords\nā€¢ **Business Reviews / Photos / Posts** ā€” paginated user reviews, images & owner posts\nā€¢ **Reverse Geocoding / Autocomplete** ā€” utility geo lookups", "default": "search" }, "query": { "title": "šŸ” Search Query", "type": "string", "description": "šŸ” What you would type into Google Maps (e.g. `restaurants in Austin` or `dentist`). Optional if Business Categories are selected below.", "default": "restaurants in Austin" }, "businessCategories": { "title": "šŸ·ļø Business Categories (Multi-select)", "type": "array", "description": "Select business categories to search. When selected, the scraper automatically fans out searches across all chosen categories in one run.", "items": { "type": "string", "enum": [ "accounting", "advertising_agency", "airport", "amusement_park", "aquarium", "art_gallery", "bakery", "bank", "bar", "beauty_salon", "bicycle_store", "book_store", "bowling_alley", "bus_station", "cafe", "campground", "car_dealer", "car_rental", "car_repair", "car_wash", "casino", "cemetery", "church", "city_hall", "clothing_store", "convenience_store", "courthouse", "dentist", "department_store", "doctor", "drugstore", "electrician", "electronics_store", "embassy", "fire_station", "florist", "funeral_home", "furniture_store", "gas_station", "gym", "hair_care", "hardware_store", "hindu_temple", "home_goods_store", "hospital", "insurance_agency", "jewelry_store", "laundry", "lawyer", "library", "light_rail_station", "liquor_store", "local_government_office", "locksmith", "lodging", "meal_delivery", "meal_takeaway", "mosque", "movie_rental", "movie_theater", "moving_company", "museum", "night_club", "painter", "park", "parking", "pet_store", "pharmacy", "physiotherapist", "plumber", "police", "post_office", "primary_school", "real_estate_agency", "restaurant", "roofing_contractor", "rv_park", "school", "secondary_school", "shoe_store", "shopping_mall", "spa", "stadium", "storage", "store", "subway_station", "supermarket", "synagogue", "taxi_stand", "tourist_attraction", "train_station", "transit_station", "travel_agency", "university", "veterinary_care", "zoo" ], "enumTitles": [ "Accounting & Tax Services", "Advertising Agency", "Airport", "Amusement Park", "Aquarium", "Art Gallery", "Bakery", "Bank", "Bar & Pub", "Beauty Salon", "Bicycle Store", "Book Store", "Bowling Alley", "Bus Station", "Cafe & Coffee Shop", "Campground", "Car Dealer", "Car Rental", "Car Repair & Auto Mechanic", "Car Wash", "Casino", "Cemetery", "Church", "City Hall", "Clothing Store", "Convenience Store", "Courthouse", "Dentist & Dental Clinic", "Department Store", "Doctor & Medical Clinic", "Drugstore", "Electrician", "Electronics Store", "Embassy", "Fire Station", "Florist", "Funeral Home", "Furniture Store", "Gas Station", "Gym & Fitness Center", "Hair Salon & Barber", "Hardware Store", "Hindu Temple", "Home Goods Store", "Hospital", "Insurance Agency", "Jewelry Store", "Laundry & Dry Cleaning", "Lawyer & Legal Services", "Library", "Light Rail Station", "Liquor Store", "Local Government Office", "Locksmith", "Lodging & Hotel", "Meal Delivery", "Meal Takeaway", "Mosque", "Movie Rental", "Movie Theater", "Moving Company", "Museum", "Night Club", "Painter & Decorator", "Park", "Parking", "Pet Store & Pet Care", "Pharmacy", "Physiotherapist", "Plumber", "Police Station", "Post Office", "Primary School", "Real Estate Agency", "Restaurant", "Roofing Contractor", "RV Park", "School", "Secondary School", "Shoe Store", "Shopping Mall", "Spa & Wellness", "Stadium", "Storage & Self-Storage", "Retail Store", "Subway Station", "Supermarket & Grocery", "Synagogue", "Taxi Stand", "Tourist Attraction", "Train Station", "Transit Station", "Travel Agency", "University & College", "Veterinary Care", "Zoo" ] }, "default": [] }, "extractEmailsAndContacts": { "title": "šŸ“§ Extract emails & contacts", "type": "boolean", "description": "šŸ“§ **The lead-gen wedge.** When enabled (default), Search and Business Details rows include `emails`, `phoneNumbers` and a full social graph (Facebook, Instagram, LinkedIn, Twitter, YouTube, TikTok, Snapchat, Pinterest, GitHub, Yelp) extracted from each business website.\n\nšŸ’” Turn OFF for faster, listings-only runs when you don't need contacts.", "default": true }, "limit": { "title": "šŸ”¢ Max businesses (Search)", "minimum": 1, "maximum": 500, "type": "integer", "description": "šŸ”¢ **Search / Search In Area / Search Nearby only.** How many businesses to return in one run (1ā€“500). Each search is a single upstream request that returns up to this many rows.\n\nšŸ’” **TIP:** Start with 20 to preview, then scale up to 500 for full sweeps.", "default": 20 }, "lat": { "title": "šŸ§­ Latitude", "type": "string", "description": "šŸ§­ **Required for Search In Area, Search Nearby and Reverse Geocoding.** Center latitude.\n- Example: `30.2672` (Austin)\n\nAlso used as a soft location bias for Search.", "default": "30.2672" }, "lng": { "title": "šŸ§­ Longitude", "type": "string", "description": "šŸ§­ **Required for Search In Area, Search Nearby and Reverse Geocoding.** Center longitude.\n- Example: `-97.7431` (Austin)", "default": "-97.7431" }, "zoom": { "title": "šŸ” Zoom level (Search In Area)", "type": "string", "description": "šŸ” **Required for Search In Area** (3ā€“21). Higher = tighter area. Maps default ā‰ˆ `13`.", "default": "13" }, "businessId": { "title": "šŸ¢ Business ID", "type": "string", "description": "šŸ¢ **Required for Business Details, Business Details Plus, Business Reviews, Review Details, Business Photos, Photo Details, Business Posts.**\n\nThe `businessId` from a Search result row (e.g. `0x89b7c63b3f02adc5:0x3f...`).\n\nšŸ’” **Batch:** Business Details, Business Details Plus and Photo Details accept up to 20 comma-separated IDs in one run.\n\nāš ļø **Ignored** for Search and Autocomplete.", "default": "" }, "reviewAuthorId": { "title": "šŸ”Ž Review Author ID (Review Details)", "type": "string", "description": "šŸ”Ž **Required for Review Details.** The `authorId` from a Business Reviews row, combined with `businessId`, returns one review's full detail.\n\nāš ļø **Ignored** for all other operations.", "default": "" }, "photoId": { "title": "šŸ–¼ļø Photo ID (Photo Details)", "type": "string", "description": "šŸ–¼ļø **Required for Photo Details.** The `photoId` from a Business Photos row. Accepts up to 20 comma-separated IDs.\n\nāš ļø **Ignored** for all other operations.", "default": "" }, "sortBy": { "title": "ā†•ļø Sort reviews by", "enum": [ "most_relevant", "newest", "highest_ranking", "lowest_ranking" ], "type": "string", "description": "ā†•ļø **Business Reviews only.** Order of returned reviews.", "default": "most_relevant" }, "reviewsQuery": { "title": "šŸ”¤ Filter reviews by keyword (Business Reviews)", "type": "string", "description": "šŸ”¤ **Business Reviews only.** Optional keyword to filter reviews (e.g. `parking`, `staff`). Leave blank to return all reviews.", "default": "" }, "translateReviews": { "title": "šŸŒ Translate reviews (Business Reviews)", "type": "boolean", "description": "šŸŒ **Business Reviews only.** Translate non-English review text into the requested language.", "default": false }, "isVideo": { "title": "šŸŽ¬ Videos only (Business Photos)", "type": "boolean", "description": "šŸŽ¬ **Business Photos only.** Return only video media instead of photos.", "default": false }, "region": { "title": "šŸŒ Region", "type": "string", "description": "šŸŒ ISO 3166-1 alpha-2 region code (e.g. `us`, `gb`, `ca`, `de`, `au`). Default `us`.", "default": "us" }, "language": { "title": "šŸ—£ļø Language", "type": "string", "description": "šŸ—£ļø ISO 639-1 language code for results (e.g. `en`, `es`, `de`, `fr`). Default `en`.", "default": "en" }, "maxPages": { "title": "šŸ“„ Max pages to fetch", "minimum": 1, "maximum": 20, "type": "integer", "description": "šŸ“„ **Applies to Business Reviews, Business Photos and Business Posts** (the paginated enrich ops). Reviews ~10/page, photos ~20/page.\n\nšŸ’” **TIP:** Start small (1ā€“3) to preview. Pagination stops automatically when Google Maps reports no more results.\n\nāš ļø Hard cap: 20 pages to prevent runaway runs. Ignored for Search (use `limit`) and single-record operations.", "default": 3 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } }