{ "openapi": "3.0.1", "info": { "title": "SS.com Scraper: Latvia Classified Ads & Prices", "description": "Scrape classified ads from ss.com, Latvia's largest listings portal. Get listing titles, prices in EUR, item specs like car year, mileage, rooms, and floor, plus image links and ad URLs. Search any category by URL, filter by price and year, then export to Excel, Google Sheets, CSV, or JSON.", "version": "0.1", "x-build-id": "5KsqMJwiUz7y74HqD" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/getascraper~ss-com-latvia-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-getascraper-ss-com-latvia-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/getascraper~ss-com-latvia-scraper/runs": { "post": { "operationId": "runs-sync-getascraper-ss-com-latvia-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/getascraper~ss-com-latvia-scraper/run-sync": { "post": { "operationId": "run-sync-getascraper-ss-com-latvia-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": [ "proxyConfiguration" ], "properties": { "query": { "title": "Search keyword", "type": "string", "description": "Keyword to filter listings within the selected category (for example audi or diesel). Leave empty to scrape the whole category. Applied as the ss.com txt search parameter.", "default": "" }, "category": { "title": "Category", "enum": [ "cars", "motorcycles", "flats", "houses", "land", "commercial", "mobile_phones", "jobs", "animals" ], "type": "string", "description": "Top-level ss.com category to scrape. Ignored when a Category URL or Start URLs are provided. The scraper auto-discovers sub-categories for broad categories like cars.", "default": "cars" }, "categoryUrl": { "title": "Category URL", "type": "string", "description": "Optional direct ss.com category, sub-category, or filtered URL. Overrides the Category selector. Apply any filters in your browser on ss.com and copy-paste the resulting URL here.", "default": "" }, "startUrls": { "title": "Start URLs", "type": "array", "description": "Optional list of additional specific URLs to scrape in parallel.", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "minPrice": { "title": "Minimum price", "minimum": 0, "type": "integer", "description": "Filter results to only include classifieds with a price greater than or equal to this value in Euros." }, "maxPrice": { "title": "Maximum price", "minimum": 0, "type": "integer", "description": "Filter results to only include classifieds with a price less than or equal to this value in Euros." }, "minYear": { "title": "Minimum year", "minimum": 1900, "type": "integer", "description": "Filter results to only include classifieds with a manufacturing year greater than or equal to this value." }, "maxYear": { "title": "Maximum year", "minimum": 1900, "type": "integer", "description": "Filter results to only include classifieds with a manufacturing year less than or equal to this value." }, "maxItems": { "title": "Maximum listings limit", "minimum": 1, "type": "integer", "description": "Maximum total classified listings to extract.", "default": 100 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Rotating proxy settings to avoid access issues. Standard proxies are fully sufficient.", "default": { "useApifyProxy": true, "apifyProxyGroups": [] } } } }, "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 } } } } } } } } } }