{ "openapi": "3.0.1", "info": { "title": "SeLoger, Leboncoin, Bien'ici, PAP & Logic-Immo Scraper", "description": "French property listings from Leboncoin, SeLoger, Bien'ici, PAP and Logic-Immo in one run, one format: price, m², rooms, DPE, photos, agency, compared with real sale prices (DVF). Buy or rent, any city, postcode or département. Only-new mode for alerts.", "version": "2.0", "x-build-id": "9QI4hL5Q4l7tGnh8G" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/cycha~france-real-estate-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-cycha-france-real-estate-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/cycha~france-real-estate-scraper/runs": { "post": { "operationId": "runs-sync-cycha-france-real-estate-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/cycha~france-real-estate-scraper/run-sync": { "post": { "operationId": "run-sync-cycha-france-real-estate-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", "required": [ "location" ], "properties": { "location": { "title": "Location", "type": "string", "description": "City, département number or postcode. One per line for several searches. Examples: Lyon, Bordeaux, 33, 75011, Gironde." }, "transactionType": { "title": "Buy or rent", "enum": [ "buy", "rent" ], "type": "string", "description": "Properties for sale or for rent.", "default": "buy" }, "propertyTypes": { "title": "Property types", "type": "array", "description": "PAP has only apartments, houses and land.", "items": { "type": "string", "enum": [ "apartment", "house", "land", "parking", "other" ], "enumTitles": [ "Apartment", "House", "Land", "Parking", "Other (building, commercial)" ] }, "default": [ "apartment", "house" ] }, "minPrice": { "title": "Min price (€)", "minimum": 0, "type": "integer", "description": "Sale price, or monthly rent when renting." }, "maxPrice": { "title": "Max price (€)", "minimum": 0, "type": "integer", "description": "Sale price, or monthly rent when renting." }, "minSurface": { "title": "Min surface (m²)", "minimum": 0, "type": "integer", "description": "Living area." }, "maxSurface": { "title": "Max surface (m²)", "minimum": 0, "type": "integer", "description": "Living area." }, "minRooms": { "title": "Min rooms (pièces)", "minimum": 0, "type": "integer", "description": "Rooms in the French sense: T3 = 3 pièces." }, "sources": { "title": "Sites", "type": "array", "description": "Which sites to search. All five by default.", "items": { "type": "string", "enum": [ "leboncoin", "seloger", "bienici", "pap", "logicimmo" ], "enumTitles": [ "Leboncoin", "SeLoger", "Bien'ici", "PAP (private sellers)", "Logic-Immo" ] }, "default": [ "leboncoin", "seloger", "bienici", "pap", "logicimmo" ] }, "maxResults": { "title": "Max listings per location", "minimum": 0, "type": "integer", "description": "Shared across the selected sites. 0 = everything the sites return (up to 5,000).", "default": 100 }, "marketComparison": { "title": "Compare with real sale prices (DVF)", "type": "boolean", "description": "Adds the median €/m² actually paid nearby in the last two years, from the government's DVF register, and how this listing compares. Sales only.", "default": true }, "onlyNewListings": { "title": "Only new listings (for schedules)", "type": "boolean", "description": "Remember the listings delivered by earlier runs of the same searches and return only listings not delivered before, even when another search of the task found them. You only pay for new listings.", "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 } } } } } } } } } }