{
  "openapi": "3.0.1",
  "info": {
    "title": "Google Maps Leads Scraper: Emails, Phones & Decision Makers",
    "description": "Google Maps leads scraper and contact extractor for local business data. Search any category and city; get places with name, address, phone numbers, website, rating, plus emails, socials and named decision makers (company owner, CEO) for B2B leads. $0.0015 per place.",
    "version": "0.7",
    "x-build-id": "md4osZFXO0tjVQGie"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/datagleaner~google-maps-leads/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-datagleaner-google-maps-leads",
        "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/datagleaner~google-maps-leads/runs": {
      "post": {
        "operationId": "runs-sync-datagleaner-google-maps-leads",
        "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/datagleaner~google-maps-leads/run-sync": {
      "post": {
        "operationId": "run-sync-datagleaner-google-maps-leads",
        "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": {
          "searches": {
            "title": "Searches",
            "type": "array",
            "description": "What to find on Google Maps. Each entry is either free text such as `plumber in Austin, TX` or an object `{\"query\": \"plumber\", \"location\": \"Austin, TX\"}`. Add one entry per category and city: one search returns up to about 200 places, so split big areas into neighbourhoods or cities. Leave empty to run a small built-in example. Example: `[\"plumber in Austin, TX\", {\"query\": \"dentist\", \"location\": \"Denver, CO\"}]`. Billing: $0.0015 per place returned, plus $0.002 per place where website contacts are found."
          },
          "maxPlacesPerSearch": {
            "title": "Max places per search",
            "minimum": 1,
            "maximum": 1000,
            "type": "integer",
            "description": "Stop each search after this many new places. Google Maps returns 20 places per page and about 200 in total for one search. Every place returned is one billed `place` event. Prefill 10 keeps a first call small (about $0.015 for places); the default of 20 applies when omitted.",
            "default": 20
          },
          "includeWebsiteContacts": {
            "title": "Add website contacts (emails, phones, socials)",
            "type": "boolean",
            "description": "Read each place's own website (home page and its contact, about and legal pages) for emails, phone numbers, social profiles and the contact page link. A `website-contacts` event is billed only for places where an email or phone is found.",
            "default": true
          },
          "findDomains": {
            "title": "Find websites for places that list none",
            "type": "boolean",
            "description": "Off by default. Places with no website on Google Maps (or only a Facebook or Yelp page) are looked up by name, city, phone and postal code with Data Gleaner's Company Domain Finder, run on your own Apify account. A website found at the confidence floor is added as `foundWebsite` and then gets the same contact and decision-maker lookup as any other place. The finder bills its own $0.0008 per website found (not this Actor), and the contact and decision-maker events above apply as usual. Many local businesses have no website at all, so expect a minority to resolve. Ignored with `onlyWithWebsite`.",
            "default": false
          },
          "domainMinConfidence": {
            "title": "Minimum confidence for a found website",
            "minimum": 0,
            "maximum": 1,
            "type": "number",
            "description": "Retired with `findDomains` on 2 November 2026: still accepted so saved tasks keep working, but it has no effect and nothing is billed.",
            "default": 0.6
          },
          "includeDecisionMakers": {
            "title": "Add decision makers (named people with titles)",
            "type": "boolean",
            "description": "Read the website's team, about, leadership and Impressum pages for named people (owner, founder, CEO, managers) with title, seniority, LinkedIn link and published email. Billed per person returned (`decision-maker` event). Places with no team page are not charged for this.",
            "default": false
          },
          "maxPeoplePerPlace": {
            "title": "Max decision makers per place",
            "minimum": 0,
            "maximum": 100,
            "type": "integer",
            "description": "Most senior first (founders, then C-level, VPs, directors, board, managers, others). 0 means no limit. Each person returned is one billed event.",
            "default": 3
          },
          "seniority": {
            "title": "Decision maker seniority filter",
            "type": "array",
            "description": "Return only these levels. Leave empty for everyone. People filtered out are not billed. Example: `[\"founder\", \"c-level\"]`.",
            "items": {
              "type": "string",
              "enum": [
                "founder",
                "c-level",
                "vp",
                "director",
                "board",
                "manager",
                "other"
              ],
              "enumTitles": [
                "Founder or owner",
                "C-level, president, managing director",
                "VP or partner",
                "Director or head of",
                "Board member",
                "Manager or lead",
                "Other staff"
              ]
            }
          },
          "onlyWithWebsite": {
            "title": "Only places with a website",
            "type": "boolean",
            "description": "Leave out places that list no website (they are not returned and not billed). The place limit counts only the places returned.",
            "default": false
          },
          "maxItems": {
            "title": "Max places in total",
            "minimum": 1,
            "maximum": 100000,
            "type": "integer",
            "description": "Hard cap on dataset rows for the whole run, across all searches.",
            "default": 1000
          },
          "language": {
            "title": "Language",
            "type": "string",
            "description": "Two-letter language code for Google Maps (`en`, `de`, `fr`, `es`, `ja`...). Affects category names and address format.",
            "default": "en"
          },
          "country": {
            "title": "Country bias",
            "type": "string",
            "description": "Two-letter country code Google uses to rank results (`us`, `gb`, `de`, `au`...). Put the city in the search itself; this only sets the regional bias.",
            "default": "us"
          },
          "maxPagesPerWebsite": {
            "title": "Max pages per website (contacts)",
            "minimum": 1,
            "maximum": 15,
            "type": "integer",
            "description": "Pages read per website for contacts, home page included. Contact-looking pages are tried first.",
            "default": 6
          },
          "maxTeamPages": {
            "title": "Max team pages per website (decision makers)",
            "minimum": 1,
            "maximum": 10,
            "type": "integer",
            "description": "Team, about, leadership and Impressum pages read per website for decision makers, after the home page.",
            "default": 4
          },
          "maxConcurrency": {
            "title": "Places enriched in parallel",
            "minimum": 1,
            "maximum": 50,
            "type": "integer",
            "description": "How many places have their website crawled at the same time. Requests to Google Maps are always sent one at a time.",
            "default": 10
          },
          "delaySecs": {
            "title": "Delay between requests (seconds)",
            "minimum": 0,
            "maximum": 30,
            "type": "number",
            "description": "Pause between two requests to Google Maps, and between two requests to the same website.",
            "default": 0.5
          },
          "requestTimeoutSecs": {
            "title": "Website request timeout (seconds)",
            "minimum": 3,
            "maximum": 120,
            "type": "integer",
            "description": "How long to wait for each website page before retrying.",
            "default": 20
          },
          "respectRobotsTxt": {
            "title": "Respect robots.txt on websites",
            "type": "boolean",
            "description": "Kept for compatibility and ignored: robots.txt is always honoured, including Crawl-delay, and this cannot be switched off.",
            "default": true
          },
          "skipSeenPlaces": {
            "title": "Seen-places store (skip places you already have)",
            "type": "string",
            "description": "Optional. A name for a key-value store on your own Apify account (lowercase letters, digits and `-`, up to 63 characters), for example `dentists-weekly`. Places already in it are skipped; places this run returns are added to it as the run goes. Use the same name on every repeat run. Leave empty to return every place. If the store cannot be read the run continues without skipping and says so in its log. Skipped places do not count towards `maxPlacesPerSearch`. Not used in the built-in example."
          },
          "excludeDatasetIds": {
            "title": "Exclude places from these datasets",
            "type": "array",
            "description": "Optional. Dataset IDs of earlier runs (this Actor's or another list you hold). A place is skipped, not enriched and not billed, when a dataset row has the same `placeId`, `cid` or `ftid`; a row without those matches places on the same website domain. Up to 20 datasets; one that cannot be read is skipped with a warning in the log. Example: `[\"aBcD1234eFgH5678\"]`.",
            "items": {
              "type": "string"
            }
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}