{
  "openapi": "3.0.1",
  "info": {
    "title": "Google Maps Leads Scraper: Emails, Phones, Socials",
    "description": "Turn a Google Maps search into a ready lead list: phone, website, full address, category, rating, reviews and hours, plus every email (with staff names and titles), phone and social profile from each business website. Several search terms per run, one row per business.",
    "version": "0.1",
    "x-build-id": "xPBzArY0GZ9W4shHL"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/automatic~google-maps-leads-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-automatic-google-maps-leads-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/automatic~google-maps-leads-scraper/runs": {
      "post": {
        "operationId": "runs-sync-automatic-google-maps-leads-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/automatic~google-maps-leads-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-automatic-google-maps-leads-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": {
          "searchQueries": {
            "title": "What businesses to find",
            "maxItems": 100,
            "type": "array",
            "description": "One or more business types or names, for example roofing contractor, dentist or coffee shop. Each term is searched in the location below; a business found by several terms is saved once. Leave empty (with no Maps URLs) for a one-business sample.",
            "items": {
              "type": "string",
              "maxLength": 300
            }
          },
          "location": {
            "title": "Search location",
            "maxLength": 300,
            "type": "string",
            "description": "City, region or neighborhood to search in, for example Austin, TX or Berlin, Germany. Optional: leave empty if your search terms already name the place (\"dentist in Austin, TX\")."
          },
          "maxPlaces": {
            "title": "Maximum businesses",
            "minimum": 1,
            "maximum": 10000,
            "type": "integer",
            "description": "Maximum unique businesses to save across all search terms and URLs, for example 50. The prefilled input saves 10. Google Maps shows up to about 120 businesses per search term and area; add terms or split a large city into neighborhoods for more.",
            "default": 100
          },
          "maxPlacesPerSearch": {
            "title": "Maximum businesses per search term",
            "minimum": 1,
            "maximum": 10000,
            "type": "integer",
            "description": "Optional cap for each search term or URL, so several terms all get results, for example 50 with five terms. Empty means only Maximum businesses applies, and the first terms can use it all."
          },
          "includeWebsiteContacts": {
            "title": "Include business website contacts",
            "type": "boolean",
            "description": "Read each business's own website for emails (with the person's name and job title when the site shows one), extra phone numbers and social profiles. Turn off for Maps data alone; you are then charged only per business.",
            "default": true
          },
          "maxPagesPerWebsite": {
            "title": "Maximum pages per website",
            "minimum": 1,
            "maximum": 10,
            "type": "integer",
            "description": "Pages to read per website, for example 3: the listed page, then its contact, about and team pages. More pages can find more emails and take longer.",
            "default": 3
          },
          "mapsUrls": {
            "title": "Google Maps URLs (optional)",
            "maxItems": 100,
            "type": "array",
            "description": "Expanded Google Maps place or search links, for example https://www.google.com/maps/search/coffee+shops+Austin . Short maps.app.goo.gl links must be opened in a browser first and the full address pasted. Invalid links are skipped and listed in OUTPUT.errors.",
            "items": {
              "type": "string"
            }
          },
          "hasWebsite": {
            "title": "Only businesses with a website",
            "type": "boolean",
            "description": "Save only businesses with a website listed on Maps, for example true. A listed website may still be unavailable.",
            "default": false
          },
          "minimumRating": {
            "title": "Minimum Google rating",
            "minimum": 0,
            "maximum": 5,
            "type": "number",
            "description": "Minimum displayed rating, for example 4.5. Zero includes unrated businesses.",
            "default": 0
          },
          "category": {
            "title": "Category contains",
            "maxLength": 300,
            "type": "string",
            "description": "Text to match in the business's main Google category, for example dentist. Empty includes all categories. Categories follow the results language."
          },
          "language": {
            "title": "Results language",
            "type": "string",
            "description": "Language code for Maps results, for example en, de or pt-BR.",
            "default": "en"
          },
          "maxItems": {
            "title": "Maximum items (optional alias)",
            "minimum": 1,
            "maximum": 10000,
            "type": "integer",
            "description": "Optional additional cap, for example 1. If both maxPlaces and maxItems are set, the smaller cap wins."
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}