{ "openapi": "3.0.1", "info": { "title": "SeLoger Universal Scraper", "description": "⚡ Extract unlimited SeLoger listings in seconds! Drop your search URL and get rich, structured real estate data — price, surface, rooms, location, DPE & more. Perfect for market analysis, investment scouting, price benchmarking or lead generation. Automate the French property market & stay ahead! 🏡", "version": "0.0", "x-build-id": "jzYvmOCJuS23ZFDHB" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapifier~seloger-universal-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapifier-seloger-universal-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/scrapifier~seloger-universal-scraper/runs": { "post": { "operationId": "runs-sync-scrapifier-seloger-universal-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/scrapifier~seloger-universal-scraper/run-sync": { "post": { "operationId": "run-sync-scrapifier-seloger-universal-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": { "transaction": { "title": "Transaction", "enum": [ "rent", "buy" ], "type": "string", "description": "Rent or buy.", "default": "rent" }, "locations": { "title": "Locations (city / postal code)", "type": "array", "description": "One or more cities, arrondissements or postal codes, e.g. \"Paris 11\", \"Lyon\", \"75011\", \"Bordeaux\". Each is resolved automatically.", "items": { "type": "string" } }, "property_types": { "title": "Property types", "type": "array", "description": "Apartment and/or house. Leave empty for both.", "items": { "type": "string", "enum": [ "apartment", "house" ], "enumTitles": [ "Apartment", "House" ] } }, "price_min": { "title": "Min price (€)", "minimum": 0, "type": "integer", "description": "Minimum price (monthly rent or sale price, in €)." }, "price_max": { "title": "Max price (€)", "minimum": 0, "type": "integer", "description": "Maximum price (monthly rent or sale price, in €)." }, "surface_min": { "title": "Min surface (m²)", "minimum": 0, "type": "integer", "description": "Minimum living surface in m²." }, "surface_max": { "title": "Max surface (m²)", "minimum": 0, "type": "integer", "description": "Maximum living surface in m²." }, "rooms_min": { "title": "Min rooms", "minimum": 1, "maximum": 5, "type": "integer", "description": "Minimum number of rooms (5 = 5 and more)." }, "bedrooms_min": { "title": "Min bedrooms", "minimum": 1, "maximum": 5, "type": "integer", "description": "Minimum number of bedrooms (5 = 5 and more)." }, "urls_list": { "title": "Search URLs", "type": "array", "description": "Advanced: instead of the filters above, do a search on SeLoger.com and paste the URL from your browser's address bar (e.g. https://www.seloger.com/classified-search?distributionTypes=Buy&estateTypes=House,Apartment&locations=AD08FR31096). The older list.htm?... URLs also work. If set, URLs take precedence over the filters above.", "items": { "type": "string" } }, "max_pages": { "title": "Max pages", "minimum": 0, "type": "integer", "description": "Maximum number of pages to scrape per search. Set 0 to scrape all reachable pages. A single SeLoger search returns at most ~2500 results — narrow your filters to go beyond. Big runs are slower, so raise the run timeout accordingly.", "default": 10 }, "split_intervals": { "title": "Get more than 2500 results (split by price)", "type": "boolean", "description": "ON by default. A single SeLoger search returns at most ~2500 results — when there are more, the Actor automatically collects the full set for you. Set 'Max pages' to 0 to get everything.", "default": true }, "fetch_details": { "title": "Fetch full listing details (costs more)", "type": "boolean", "description": "OFF by default to keep runs cheap and fast. The search results already include description, photos, price, surface, rooms, DPE, transport and the agency phone. Turn this ON only if you also need every photo, the full feature list and exact GPS — it opens each listing's own page, which makes the run much slower and more expensive.", "default": false }, "concurrency": { "title": "Concurrency", "minimum": 1, "maximum": 32, "type": "integer", "description": "How many listings to fetch in parallel. Higher = faster; keep it moderate and pair it with a good residential proxy.", "default": 8 }, "delay_between_pages": { "title": "Delay between requests (seconds)", "minimum": 0, "maximum": 10, "type": "number", "description": "Wait time between requests (politeness). 0 = fastest.", "default": 0 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Residential proxies in France are strongly recommended for reliable runs." } } }, "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 } } }, "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 } } } } } } } } } }