{ "openapi": "3.0.1", "info": { "title": "Hemnet Properties Scraper (Sweden)", "description": "Scrapes for-sale property listings from Hemnet, Sweden's dominant real estate portal. Every row carries asking price, monthly fee, rooms, living and land area, price per square metre, street address, GPS coordinates, broker and agency, publication date and photos.", "version": "0.1", "x-build-id": "vnjJmbQE3SleOl6LY" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapyx~hemnet-properties-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapyx-hemnet-properties-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/scrapyx~hemnet-properties-scraper/runs": { "post": { "operationId": "runs-sync-scrapyx-hemnet-properties-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/scrapyx~hemnet-properties-scraper/run-sync": { "post": { "operationId": "run-sync-scrapyx-hemnet-properties-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": { "locations": { "title": "Locations", "type": "array", "description": "One Swedish place per entry, each with its own SEARCH_SUMMARY row — e.g. `Stockholm`, `Göteborg`, `Nacka kommun`, or a numeric Hemnet location id like `17744`.\n\nNames are resolved through Hemnet's own public location lookup. When a name matches several places (searching `Stockholm` returns the county, the municipality and a dozen districts) the **broadest** is used — county over municipality over district — and the summary row always reports which one was actually served.\n\nBecause Hemnet pages through at most 2,500 rows per query, several narrow locations return far more data than one broad one.", "default": [], "items": { "type": "string" } }, "itemTypes": { "title": "Property types", "type": "array", "description": "Restrict to one or more property types. Leave empty for all.\n\nOnly these seven were verified to actually filter. Hemnet does **not** reject an unrecognised type — it returns every listing in the region as though the filter had applied. That trap catches real Swedish words: `lägenhet`, `parhus`, `kedjehus` and `andelsboende` all silently return the unfiltered total, so they are refused before the run starts.", "items": { "type": "string", "enum": [ "bostadsratt", "villa", "radhus", "fritidshus", "tomt", "gard", "other" ], "enumTitles": [ "Apartment (bostadsrätt)", "House / villa", "Terraced house (radhus)", "Holiday home (fritidshus)", "Land / plot (tomt)", "Farm / estate (gård)", "Other" ] }, "default": [] }, "roomsMin": { "title": "Minimum rooms", "minimum": 0, "maximum": 20, "type": "integer", "description": "Verified real: on Stockholms län this narrowed 10,100 listings to 2,978. Leave at 0 to skip.", "default": 0 }, "priceMax": { "title": "Maximum asking price (SEK)", "minimum": 0, "type": "integer", "description": "Verified real: `2000000` narrowed Stockholms län from 10,100 to 3,633. Leave at 0 to skip.", "default": 0 }, "livingAreaMin": { "title": "Minimum living area (m²)", "minimum": 0, "type": "integer", "description": "Verified real: `100` narrowed Stockholms län from 10,100 to 2,197. Leave at 0 to skip.", "default": 0 }, "maxItems": { "title": "Max listings per location", "minimum": 0, "type": "integer", "description": "Stop after this many listings per location. Set to 0 for everything Hemnet will serve — which is capped at 2,500 rows per query however many matches it reports.", "default": 100 }, "maxConcurrency": { "title": "Max concurrent requests", "minimum": 1, "maximum": 12, "type": "integer", "description": "Upper bound on requests in flight at once, across all locations.", "default": 4 }, "minRequestInterval": { "title": "Minimum seconds between requests", "minimum": 0, "maximum": 30, "type": "integer", "description": "Paces how often requests START, without tying up a concurrency slot. Each search page is roughly 1.6 MB, so a small interval is polite by default.", "default": 0 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Residential pinned to Sweden. Hemnet showed no bot challenge on the profiles this actor uses, but it is a Sweden-only portal, and a comparable local-market portal in this portfolio (Rumah123) turned out to score exit-IP geography rather than ASN reputation — rotating IPs without a country pin failed there 4 times out of 4.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "SE" } } } }, "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 } } } } } } } } } }