{ "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": "YfXIfOt4S7jGEZwc3" }, "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 (25 listings/page). Set 0 to scrape all reachable pages. SeLoger caps a search at ~2500 results (100 pages); narrow your filters to go beyond. Big runs are slower — raise the run timeout accordingly.", "default": 10 }, "split_intervals": { "title": "Get more than 2500 results (split by price)", "type": "boolean", "description": "ON by default. SeLoger caps a single search at ~2500 results. When a search has more, the actor automatically splits it into price intervals (each under the cap) and scrapes them all, so you get the full set. Uses `max_pages` per interval — set `max_pages: 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. 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 page (one extra heavy request per listing through the proxy), which makes the run much slower and more expensive.", "default": false }, "concurrency": { "title": "Concurrency", "minimum": 1, "maximum": 32, "type": "integer", "description": "Maximum number of simultaneous requests. Pages and detail pages are fetched in parallel up to this limit. Higher = faster but more aggressive (use good residential proxies).", "default": 8 }, "delay_between_pages": { "title": "Delay between requests (seconds)", "minimum": 0, "maximum": 10, "type": "number", "description": "Wait time between requests (politeness). 0 uses the library default jitter.", "default": 0 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "SeLoger is protected by Datadome. Residential proxies in France are strongly recommended — a clean residential IP lets the request through without any cookie." } } }, "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 } } } } } } } } } }