{
  "openapi": "3.0.1",
  "info": {
    "title": "Google Maps Scraper - Business Contacts & Ratings",
    "description": "Returns Google Maps places for any search and location: name, phone, website, address parts, coordinates, rating, review count, opening hours, categories, place id and a lead score. Reads past Google's 200-place list by searching the map in tiles. No browser, no login; filters cost nothing extra.",
    "version": "1.0",
    "x-build-id": "U0Bi6oN1Xm3RsyDVN"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/benthepythondev~google-maps-business-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-benthepythondev-google-maps-business-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/benthepythondev~google-maps-business-scraper/runs": {
      "post": {
        "operationId": "runs-sync-benthepythondev-google-maps-business-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/benthepythondev~google-maps-business-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-benthepythondev-google-maps-business-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": {
          "query": {
            "title": "Search query",
            "type": "string",
            "description": "What to search for on Google Maps, as you would type it there: a kind of business (\"dentist\", \"coffee shop\"), a brand or a business name. Searched in the location below."
          },
          "location": {
            "title": "Location",
            "type": "string",
            "description": "City, district, state or country to search in, for example \"San Francisco, CA\", \"Mitte, Berlin\" or \"Texas\". With a location the Actor can read past Google's list of about 200 places by searching the map of that location piece by piece."
          },
          "queries": {
            "title": "More search queries",
            "type": "array",
            "description": "Several search queries for one run. Each query is searched in each location, and a place found by two searches is saved once.",
            "items": {
              "type": "string"
            }
          },
          "locations": {
            "title": "More locations",
            "type": "array",
            "description": "Several locations for one run, for example a list of cities. Each query is searched in each of them.",
            "items": {
              "type": "string"
            }
          },
          "maxResults": {
            "title": "Maximum places per search",
            "minimum": 1,
            "maximum": 20000,
            "type": "integer",
            "description": "Places to save for each search (each query in each location), up to 20,000. One Google list holds about 120 to 240 places; for more the Actor searches the map of the location in tiles. With filters a search reads at most 1,000 places, or ten places per place asked for here if that is more.",
            "default": 10
          },
          "startUrls": {
            "title": "Place links, place ids or search links",
            "type": "array",
            "description": "Google Maps place links, place ids (ChIJ…), feature ids (0x…:0x…) or Google Maps search links. Each place is read from its own page, every link is read regardless of the limit above. A search link is run as a search; a link with a map position (…/@37.76,-122.41,15z) searches that part of the map.",
            "items": {
              "type": "string"
            }
          },
          "mode": {
            "title": "Mode",
            "enum": [
              "search",
              "direct_urls"
            ],
            "type": "string",
            "description": "\"search\" runs the queries and reads the links. \"direct_urls\" reads only the links and ignores the query fields.",
            "default": "search"
          },
          "minRating": {
            "title": "Minimum rating",
            "minimum": 1,
            "maximum": 5,
            "type": "number",
            "description": "Save only places with at least this star rating (1.0 to 5.0). Places without a rating are left out. Filtered places are not charged."
          },
          "minReviews": {
            "title": "Minimum number of reviews",
            "minimum": 0,
            "type": "integer",
            "description": "Save only places with at least this many reviews. Filtered places are not charged."
          },
          "websiteFilter": {
            "title": "Website filter",
            "enum": [
              "any",
              "has_website",
              "no_website"
            ],
            "type": "string",
            "description": "\"has_website\" saves only places with a website, \"no_website\" only places without one (prospects for web design and local marketing). Filtered places are not charged.",
            "default": "any"
          },
          "skipClosedPlaces": {
            "title": "Skip permanently closed places",
            "type": "boolean",
            "description": "Leave out places Google marks as permanently closed.",
            "default": false
          },
          "includeReviews": {
            "title": "Full details and reviews",
            "type": "boolean",
            "description": "Reads each place's own page as well: price range, every group of Google's \"About\" tab, the number of 1 to 5 star reviews and the reviews Google shows a visitor on the overview (eight at most, with author, rating, text and date). One more request per place, about four places a second. Without it a row has what Google's result list carried.",
            "default": false
          },
          "maxReviews": {
            "title": "Maximum reviews per place",
            "minimum": 1,
            "maximum": 100,
            "type": "integer",
            "description": "Reviews to keep per place when reviews are included. Google shows a visitor eight at most.",
            "default": 10
          },
          "includePhotos": {
            "title": "Include photo links",
            "type": "boolean",
            "description": "Adds `photos`: the photo links in Google's record of the place, between 1 and about 20. The main photo is always in `image_url`.",
            "default": false
          },
          "includeLeadScore": {
            "title": "Include lead score",
            "type": "boolean",
            "description": "Adds a score from 0 to 100 computed from the row itself: website and phone present, rating, number of reviews, opening hours, photos.",
            "default": true
          },
          "language": {
            "title": "Language",
            "type": "string",
            "description": "Language of categories, opening hours and descriptions, as a language code: en, de, fr, es, it, pt-BR, ja.",
            "default": "en"
          },
          "countryCode": {
            "title": "Country of the visitor",
            "type": "string",
            "description": "Two-letter country code Google is told the visitor is in. It decides the format of addresses and phone numbers: with \"us\" a US phone is \"(415) 772-9060\", a German one \"+49 30 81455310\"; with \"de\" the German one is \"030 81455310\".",
            "default": "us"
          },
          "onlyNew": {
            "title": "Only places not delivered before",
            "type": "boolean",
            "description": "Skips every place an earlier run with the same monitor name saved. Use it to continue a large area over several runs, or on a schedule to get businesses that appear after a first complete run. Skipped places are not charged.",
            "default": false
          },
          "monitorId": {
            "title": "Monitor name",
            "type": "string",
            "description": "Name of the memory used by \"only places not delivered before\". Runs with the same name share one memory."
          },
          "excludePlaceUrls": {
            "title": "Exclude place links",
            "type": "array",
            "description": "Skip these places, given as long Google Maps place links. Excluded places are not saved or charged.",
            "items": {
              "type": "string"
            }
          },
          "excludePlaceIds": {
            "title": "Exclude place ids",
            "type": "array",
            "description": "Skip these places, given as place ids (ChIJ…), numeric CIDs or feature ids (0x…:0x…). Excluded places are not saved or charged.",
            "items": {
              "type": "string"
            }
          },
          "debugMode": {
            "title": "Debug log",
            "type": "boolean",
            "description": "Logs every request with its size and time. For support.",
            "default": false
          }
        }
      },
      "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
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "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
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}