{ "openapi": "3.0.1", "info": { "title": "SS.LV Latvia Classifieds Scraper", "description": "[💰 $3 / 1K] Extract classified ads from SS.LV / SS.COM, Latvia's biggest marketplace — real estate, cars, jobs, electronics and more. Get price, price/m², location, photos, descriptions and per-category specs. Paste any SS.LV URL or search by keyword, in English, Latvian or Russian.", "version": "1.0", "x-build-id": "zYmvptIWjrh7yFvD5" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/solidcode~ss-lv-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-solidcode-ss-lv-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/solidcode~ss-lv-scraper/runs": { "post": { "operationId": "runs-sync-solidcode-ss-lv-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/solidcode~ss-lv-scraper/run-sync": { "post": { "operationId": "run-sync-solidcode-ss-lv-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": { "startUrls": { "title": "SS.LV URLs", "type": "array", "description": "Paste one or more SS.LV category pages, search-result pages, or individual ad pages (for example 'https://www.ss.lv/en/real-estate/flats/riga/centre/sell/' or 'https://www.ss.lv/en/transport/cars/audi/'). The easiest way: go to ss.lv, set the filters you want in your browser, then copy the address from the address bar. Every page of results is followed automatically.", "items": { "type": "string" } }, "searchQueries": { "title": "Search keywords", "type": "array", "description": "Type what you're looking for, for example 'audi', 'dzīvoklis Rīgā', or 'iphone'. Each keyword is searched across the whole of SS.LV and every page of results is collected. Use this when you don't want to build a URL by hand.", "items": { "type": "string" } }, "language": { "title": "Language", "enum": [ "en", "lv", "ru" ], "type": "string", "description": "Which language version of SS.LV to read. This changes the wording of labels and categories in your results — the ads themselves are the same in all three. Any URL you paste above is automatically switched to this language." }, "includeDetails": { "title": "Include full ad details", "type": "boolean", "description": "Open each ad's own page to add the full description, the complete photo gallery, map coordinates, the listing date, and every extra specification the seller filled in (rooms, area, floor, house type, car year/mileage, and so on). Leave this off (the default) for fast, inexpensive runs that still give you the title, price, photo thumbnail and the columns shown on the results page. Turning it on makes one extra request per ad, so runs take noticeably longer." }, "maxResults": { "title": "Maximum results", "minimum": 0, "maximum": 50000, "type": "integer", "description": "The largest number of ads to collect in total, across all URLs and keywords. Set to 0 for no limit (an internal ceiling of 50,000 ads per run still applies so a run can't go on forever). Ads are collected a full page at a time, so your final count may go slightly over this number." } } }, "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 } } } } } } } } } }