{ "openapi": "3.0.1", "info": { "title": "Google Maps Scraper France - Leads, Phones & Emails", "description": "Scrape French businesses from Google Maps by search and city: name, category, address, separate postcode, phone, website, e-mail and social profiles found on the website, rating, review count and opening hours, in French. Filters for places with a phone or e-mail. Bilingual FR/EN form.", "version": "1.0", "x-build-id": "lNcrtWMkZDv2R1KyS" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/badr_xba~google-maps-france/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-badr_xba-google-maps-france", "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/badr_xba~google-maps-france/runs": { "post": { "operationId": "runs-sync-badr_xba-google-maps-france", "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/badr_xba~google-maps-france/run-sync": { "post": { "operationId": "run-sync-badr_xba-google-maps-france", "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", "required": [ "searchQueries" ], "properties": { "searchQueries": { "title": "🔍 Recherches / Searches", "type": "array", "description": "Ce que vous taperiez dans Google Maps : plombier, dentiste, agence immobilière. Une recherche par ligne. Vous pouvez aussi écrire la ville dans la recherche (plombier à Lyon, avocat près de Bordeaux 33000) ou coller des liens Google Maps (lieu, recherche, maps.app.goo.gl, ?cid=) et des place IDs (ChIJ…). Une liste collée sur une ligne (plombier, électricien) est découpée ; les doublons sont retirés. — What you would type into Google Maps, one per line; “plumber in Lyon”, Google Maps links and place IDs work too.", "default": [ "plombier" ], "items": { "type": "string" } }, "locations": { "title": "📍 Zones / Areas", "type": "array", "description": "Villes, codes postaux, départements ou régions, un par ligne : Lyon, 75011, Saint-Étienne (avec ou sans accents), Bouches-du-Rhône. La recherche se fait d'abord en France. Coordonnées GPS (48.8566, 2.3522) et liens de carte Google Maps acceptés. Ignoré quand la couverture nationale ci-dessous est activée. / Cities, postcodes or regions; ignored when the whole-of-France sweep below is on.", "default": [ "Paris, France" ], "items": { "type": "string" } }, "allFrance": { "title": "Couvrir toute la France / Cover the whole of France", "type": "boolean", "description": "Interroge les villes de la liste intégrée (226 villes : métropole, Corse et outre-mer, des plus peuplées aux plus petites) au lieu des zones saisies ci-dessus. Google borne ses résultats autour d'un point : chercher « France » ne rend que quelques dizaines de fiches, alors que ville par ville on couvre le pays. Les doublons sont écartés automatiquement. / Sweeps the built-in list of 226 French cities instead of the areas above.", "default": false }, "maxCities": { "title": "Nombre de villes / Number of cities", "minimum": 0, "maximum": 226, "type": "integer", "description": "Avec la couverture nationale : combien de villes interroger, des plus peuplées aux plus petites. 0 les prend toutes (226, plusieurs heures). / With the national sweep: how many cities, largest first. 0 means all of them.", "default": 10 }, "maxPlacesPerSearch": { "title": "Nombre maximum de lieux par recherche et par zone / Max places per search and area", "minimum": 0, "type": "integer", "description": "Limite exacte de fiches livrées (et facturées) pour chaque recherche dans chaque zone ou ville. 0 = sans limite : l'Actor s'arrête quand la zone est épuisée. — Exact limit of places delivered (and billed) per search and area; 0 means no limit.", "default": 100 }, "extractContacts": { "title": "Chercher les e-mails et réseaux sociaux / Find e-mails and social profiles", "type": "boolean", "description": "Ouvre le site de chaque entreprise pour relever les adresses e-mail publiques et les liens Facebook, Instagram, LinkedIn, X, YouTube, TikTok et WhatsApp. C'est ce qui transforme une liste de lieux en fichier de prospection. Aucun surcoût. — Opens each business website to collect public e-mails and social profiles. No extra charge.", "default": false }, "onlyWithEmail": { "title": "Seulement avec e-mail / Only places with an e-mail", "type": "boolean", "description": "Ne livre que les entreprises dont on a trouvé une adresse e-mail : les autres ne sont pas facturées. Active automatiquement l'option ci-dessus. — Delivers only places with an e-mail found; you do not pay for the others.", "default": false }, "onlyWithPhone": { "title": "Seulement avec téléphone / Only places with a phone", "type": "boolean", "description": "Utile pour la prospection téléphonique : écarte les fiches sans numéro. — Useful for cold calling: drops places without a phone number.", "default": false }, "onlyWithWebsite": { "title": "Seulement avec site web / Only places with a website", "type": "boolean", "description": "Ne garder que les lieux qui affichent un site web. — Keep only places that show a website.", "default": false }, "onlyWithoutWebsite": { "title": "Seulement sans site web / Only places without a website", "type": "boolean", "description": "L'inverse : les commerces sans site, souvent les meilleurs prospects pour une agence web. — The opposite: businesses with no website, often the best prospects for a web agency.", "default": false }, "minRating": { "title": "Note minimum / Minimum rating", "minimum": 1, "maximum": 5, "type": "number", "description": "Ne garder que les lieux ayant au moins cette note, de 1 à 5 (décimales acceptées, ex. 4.5). Vide = pas de filtre. — Keep only places rated at least this, from 1 to 5 (decimals allowed, e.g. 4.5)." }, "minReviews": { "title": "Nombre d'avis minimum / Minimum review count", "minimum": 0, "type": "integer", "description": "Ne garder que les lieux ayant au moins ce nombre d'avis Google. Vide = pas de filtre. — Keep only places with at least this many reviews." }, "skipClosedPlaces": { "title": "Ignorer les établissements fermés / Skip closed places", "type": "boolean", "description": "Écarte les lieux marqués définitivement ou temporairement fermés par Google. — Drops places Google marks permanently or temporarily closed.", "default": false }, "categoryKeywords": { "title": "Catégorie contient / Category contains", "type": "array", "description": "Ne garder que les lieux dont une catégorie Google contient un de ces mots, ex. pizza, italien. — Keep only places whose Google category contains one of these words.", "items": { "type": "string" } }, "excludeKeywords": { "title": "Nom ne contient pas / Name excludes", "type": "array", "description": "Exclure les lieux dont le nom contient un de ces mots. — Exclude places whose name contains any of these words.", "items": { "type": "string" } }, "startUrls": { "title": "🔗 Liens Google Maps ou place IDs / Google Maps URLs or place IDs", "type": "array", "description": "Facultatif : ils peuvent aussi aller dans Recherches. Un lien de lieu (…/maps/place/…), ?cid=, maps.app.goo.gl ou un place ID (ChIJ…) donne une ligne ; un lien de recherche (…/maps/search/plombier/@45.76,4.83,13z) est cherché dans la zone de la carte. — Place links give one row each; search links are searched in the map area.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "latitude": { "title": "Latitude (au lieu d'une zone) / Latitude instead of an area", "type": "string", "description": "Pour viser un point précis plutôt qu'une ville : latitude du centre, ex. 48.8566. À utiliser avec Longitude et Rayon ; les zones sont alors ignorées. — Centre latitude when you prefer an exact point to a city name." }, "longitude": { "title": "Longitude (au lieu d'une zone) / Longitude instead of an area", "type": "string", "description": "Longitude du centre, ex. 2.3522. — Centre longitude, for example 2.3522." }, "radiusKm": { "title": "Rayon autour du point (km) / Radius in km", "minimum": 1, "maximum": 200, "type": "integer", "description": "Demi-côté de la zone carrée explorée autour des coordonnées. — Half-width of the square searched around those coordinates.", "default": 5 }, "dedupeAcrossSearches": { "title": "Supprimer les doublons entre recherches et zones / Remove duplicates across searches and areas", "type": "boolean", "description": "Activé (recommandé) : une entreprise trouvée par deux mots-clés ou dans deux zones voisines n'est livrée — et facturée — qu'une fois par run. Toujours activé avec la couverture nationale. — On: a business is delivered and billed only once per run.", "default": true }, "strictArea": { "title": "Rester strictement dans la zone / Stay strictly inside the area", "type": "boolean", "description": "Quand un carré de la zone est presque vide, Google élargit tout seul la recherche au pays entier. Activé, l'Actor écarte ces lieux situés ailleurs. — When a square is nearly empty Google widens the search on its own; this drops results outside your area.", "default": true }, "languageCode": { "title": "Langue des résultats / Results language", "type": "string", "description": "Langue des catégories et des horaires : « fr » donne « Plombier, Ouvert · Ferme à 18:00 », « en » donne « Plumber, Open · Closes 6 PM ». — Language of categories and opening hours.", "default": "fr" }, "countryCode": { "title": "Pays des résultats / Results country", "type": "string", "description": "« fr » garde la recherche en France ; videz-le pour la Belgique, la Suisse ou le Luxembourg. — “fr” keeps results in France; clear it for Belgium, Switzerland or Luxembourg.", "default": "fr" }, "maxPagesPerTile": { "title": "Pages par carré / Pages per square", "minimum": 1, "maximum": 15, "type": "integer", "description": "Google rend 20 lieux par page. 5 pages = jusqu'à 100 lieux par carré avant découpage. — Google returns 20 places per page; 5 pages is up to 100 per square before splitting.", "default": 5 }, "maxSplitDepth": { "title": "Profondeur de découpage / Split depth", "minimum": 0, "maximum": 4, "type": "integer", "description": "Quand un carré est saturé, l'Actor le découpe en quatre. 2 = jusqu'à 16 carrés par zone, 3 = jusqu'à 64, plus long mais plus complet. — How many times a saturated square is divided into four.", "default": 2 }, "maxConcurrency": { "title": "Requêtes en parallèle / Parallel requests", "minimum": 1, "maximum": 16, "type": "integer", "description": "Plus élevé = plus rapide, mais Google bloque plus facilement. — Higher is faster, but Google blocks more easily.", "default": 8 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Facultatif. Sans proxy, une requête refusée par Google est automatiquement retentée via le proxy datacenter d'Apify, avec une nouvelle IP. Si beaucoup de requêtes restent refusées (voir FAILED_INPUTS), choisissez le groupe RESIDENTIAL. Les sites des entreprises ne passent jamais par le proxy résidentiel. / Optional; refused requests are retried automatically with a fresh IP.", "default": { "useApifyProxy": 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 } } } } } } } } } }