{
  "openapi": "3.0.1",
  "info": {
    "title": "Google Maps Leads Tracker - New Businesses & Changes",
    "description": "Google Maps leads for any keyword and area: phone, email and social profiles from each website, rating, reviews, lead score, online booking, unclaimed profiles. Only changes returns new businesses, closures and websites added or removed, with Slack, Discord, Teams or Telegram alerts.",
    "version": "0.1",
    "x-build-id": "S1om4UUsVc2OoK5nO"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/akhil_rajesh~google-maps-leads-tracker/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-akhil_rajesh-google-maps-leads-tracker",
        "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/akhil_rajesh~google-maps-leads-tracker/runs": {
      "post": {
        "operationId": "runs-sync-akhil_rajesh-google-maps-leads-tracker",
        "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/akhil_rajesh~google-maps-leads-tracker/run-sync": {
      "post": {
        "operationId": "run-sync-akhil_rajesh-google-maps-leads-tracker",
        "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": "Kinds of business to find ('plumber', 'hair salon', 'dentist', 'roofing contractor'), as you would type them into Google Maps. A Google Maps search link (google.com/maps/search/plumbers/@30.27,-97.74,13z) searches its own map area. Each search is read in every location below.",
            "items": {
              "type": "string"
            }
          },
          "location": {
            "title": "Location",
            "type": "string",
            "description": "Where to search: a city, district or postcode with its state or country ('Austin, TX', 'Shoreditch, London', 'M5V 2T6', '90210, USA'), or coordinates ('30.27, -97.74'). The whole area is covered with a grid of searches, as far as Google Maps draws it (Austin: about 25 km around its centre). States and provinces are too large: list their cities in Locations."
          },
          "locations": {
            "title": "More locations",
            "type": "array",
            "description": "More places to search, one per line (each search is read in each). Up to 50 searches in all.",
            "items": {
              "type": "string"
            }
          },
          "radiusKm": {
            "title": "Radius (km)",
            "minimum": 0,
            "maximum": 100,
            "type": "number",
            "description": "How far around the location's centre to search. Leave empty for the area Google Maps draws for the place (a district about 2 km, a city 20-30 km); coordinates and postcodes get 5 km."
          },
          "coverage": {
            "title": "Coverage",
            "enum": [
              "fast",
              "normal",
              "thorough"
            ],
            "type": "string",
            "description": "How densely the area is searched. Google Maps lists up to about 160 places per search point, so a city needs many points. Austin plumbers (25 km): normal read 328 in 4.5 minutes, thorough 371 in 8.5 minutes.",
            "default": "normal"
          },
          "maxResults": {
            "title": "Max results",
            "minimum": 1,
            "maximum": 100000,
            "type": "integer",
            "description": "The most places a run returns (and charges), shared between the searches. With Only changes, the most changes a run returns.",
            "default": 100
          },
          "maxPlacesPerSearch": {
            "title": "Max places read per search",
            "minimum": 0,
            "maximum": 5000,
            "type": "integer",
            "description": "The most places a search reads in its area (before the filters). Raise it for big cities with many businesses of the kind.",
            "default": 500
          },
          "onlyChanges": {
            "title": "Only changes",
            "type": "boolean",
            "description": "Return only what changed since the last run of the same search: new businesses, places Google marks closed or open again, websites added or removed, new phones and names. The first run returns every place as its baseline. Schedule it to watch an area."
          },
          "changeTypes": {
            "title": "Changes to return",
            "type": "array",
            "description": "Which changes to return. Leave empty for all of them.",
            "items": {
              "type": "string",
              "enum": [
                "newPlace",
                "closed",
                "reopened",
                "websiteAdded",
                "websiteRemoved",
                "phoneChanged",
                "renamed"
              ],
              "enumTitles": [
                "New places",
                "Closed",
                "Reopened",
                "Website added",
                "Website removed",
                "Phone changed",
                "Renamed"
              ]
            }
          },
          "newPlaceMaxReviews": {
            "title": "New places: most reviews",
            "minimum": 0,
            "maximum": 100000,
            "type": "integer",
            "description": "A place this search hasn't seen before counts as new only with at most this many reviews (a new business has few). Others were there already, and are recorded without a row. Leave empty for 10."
          },
          "websiteFilter": {
            "title": "Website",
            "enum": [
              "all",
              "withoutWebsite",
              "withWebsite"
            ],
            "type": "string",
            "description": "Keep all places, only those without a website of their own, or only those with one."
          },
          "socialMediaCountsAsWebsite": {
            "title": "A social page counts as a website",
            "type": "boolean",
            "description": "Off: a place whose only link is a Facebook, Instagram, Linktree, Yelp or booking page has no website of its own. On: such a page counts as a website."
          },
          "minRating": {
            "title": "Minimum rating",
            "minimum": 0,
            "maximum": 5,
            "type": "number",
            "description": "Keep places rated at least this (1-5). Places without a rating are left out."
          },
          "maxRating": {
            "title": "Maximum rating",
            "minimum": 0,
            "maximum": 5,
            "type": "number",
            "description": "Keep places rated at most this, for businesses that need help with reviews."
          },
          "minReviews": {
            "title": "Minimum reviews",
            "minimum": 0,
            "type": "integer",
            "description": "Keep places with at least this many reviews."
          },
          "maxReviews": {
            "title": "Maximum reviews",
            "minimum": 0,
            "type": "integer",
            "description": "Keep places with at most this many reviews (0: only places without reviews)."
          },
          "withPhoneOnly": {
            "title": "Only places with a phone",
            "type": "boolean",
            "description": "Leave out places that show no phone."
          },
          "onlyUnclaimed": {
            "title": "Only unclaimed places",
            "type": "boolean",
            "description": "Keep only places whose owner hasn't claimed the Google Business Profile (Google shows 'Own this business?')."
          },
          "categoryWords": {
            "title": "Category words",
            "type": "array",
            "description": "Keep only places with one of these words in a category ('dentist', 'clinic').",
            "items": {
              "type": "string"
            }
          },
          "excludeWords": {
            "title": "Exclude words",
            "type": "array",
            "description": "Leave out places with any of these words in their name or categories ('franchise', 'supply').",
            "items": {
              "type": "string"
            }
          },
          "onlyMatching": {
            "title": "Only places matching the search",
            "type": "boolean",
            "description": "Google's later results drift to related businesses (for 'hair salon': spas, bridal shops, an office). On: keep places in the categories of the search's top results, or with the keyword in their name or categories. Off: keep everything Google lists.",
            "default": true
          },
          "excludeOnlineBooking": {
            "title": "Leave out places that book online",
            "type": "boolean",
            "description": "Leave out places that already take bookings online (OpenTable, Resy, Doctolib, Fresha, Calendly, Reserve with Google, or a booking page). Every row says onlineBooking either way."
          },
          "minLeadScore": {
            "title": "Minimum lead score",
            "minimum": 0,
            "maximum": 100,
            "type": "integer",
            "description": "Keep places scoring at least this (0-100; hot is 70+, warm 45+). The score is checked before the website is read for emails, which can only raise it."
          },
          "includeClosed": {
            "title": "Include closed places",
            "type": "boolean",
            "description": "Keep places Google marks permanently closed (left out by default)."
          },
          "language": {
            "title": "Language",
            "type": "string",
            "description": "The language of categories and hours (en, de, es, fr, pt-BR...).",
            "default": "en"
          },
          "findContacts": {
            "title": "Find emails and social profiles",
            "type": "boolean",
            "description": "Read each place's own website (its homepage and up to 3 contact pages, following its robots.txt) for emails, Facebook, Instagram, LinkedIn, X, YouTube and TikTok, a contact page and form. A place whose website gives an email or a social profile costs one more place; others cost nothing more. Slower: about 10 websites at a time."
          },
          "alertWebhookUrl": {
            "title": "Alert webhook URL",
            "type": "string",
            "description": "A Slack, Discord or Microsoft Teams incoming webhook, or any HTTPS address that takes JSON (Zapier, Make, n8n). Each run posts its changes there; the first run posts a set-up message. Turns on Only changes."
          },
          "telegramBotToken": {
            "title": "Telegram bot token",
            "type": "string",
            "description": "To post alerts to Telegram instead: your bot's token from @BotFather (123456789:AAH...). Add the bot to the chat (to a channel as an admin that can post). Turns on Only changes."
          },
          "telegramChatId": {
            "title": "Telegram chat id",
            "type": "string",
            "description": "The chat the bot posts to: a chat id (-1001234567890, 123456789) or a public channel or group (@mychannel)."
          },
          "alertChangeTypes": {
            "title": "Alert on",
            "type": "array",
            "description": "Which changes to post. Leave empty for new places, closures and websites removed.",
            "items": {
              "type": "string",
              "enum": [
                "newPlace",
                "closed",
                "reopened",
                "websiteAdded",
                "websiteRemoved",
                "phoneChanged",
                "renamed"
              ],
              "enumTitles": [
                "New places",
                "Closed",
                "Reopened",
                "Website added",
                "Website removed",
                "Phone changed",
                "Renamed"
              ]
            }
          },
          "historyName": {
            "title": "History name",
            "type": "string",
            "description": "The store that remembers what earlier runs saw. Leave empty to share one store between all your runs (each search and filter set keeps its own record); give a name to keep a schedule's history apart."
          },
          "proxy": {
            "title": "Proxy",
            "type": "object",
            "description": "Not needed: Google Maps answers Apify's servers directly. Residential and SERP proxies aren't available (they are billed per GB or request)."
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}