{ "openapi": "3.0.1", "info": { "title": "SS.com Scraper - Latvia Classifieds (Cars, Flats, Jobs)", "description": "Scrape ss.com, the biggest classifieds site in Latvia: cars, flats, houses, land, jobs and all 98 sections. Pick sections, makes or districts, deal type and date, filter by price, year, km, rooms and area. Add Details for description, specs, equipment, GPS and all photos.", "version": "1.0", "x-build-id": "bNPOG4ejslBSlH7g9" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/normdata~ss-com-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-normdata-ss-com-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/normdata~ss-com-scraper/runs": { "post": { "operationId": "runs-sync-normdata-ss-com-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/normdata~ss-com-scraper/run-sync": { "post": { "operationId": "run-sync-normdata-ss-com-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": { "maxItems": { "title": "Maximum results", "minimum": 1, "type": "integer", "description": "Stop after this many ads in total. Leave empty for no limit. The Apify Free plan is always capped at 10." }, "sections": { "title": "Sections", "type": "array", "description": "ss.com sections (98; type to search, like Cars, Flats, Vacancies or Dogs).", "items": { "type": "string", "enum": [ "agriculture/agricultural-machinery", "agriculture/agricultural-works", "agriculture/animal-husbandry", "agriculture/aviculture", "agriculture/fertilizers", "agriculture/fish-industry", "agriculture/foodstuffs", "agriculture/other", "agriculture/seeds-and-seedings", "agriculture/vegetable-and-horticulture", "animals/cats", "animals/dogs", "animals/exotic-animals", "animals/fish", "animals/other", "animals/parrots-and-birds", "animals/rodents", "animals/veterinary-medicine", "clothes-footwear/footwear", "clothes-footwear/accessories", "clothes-footwear/mens-clothes", "clothes-footwear/other", "clothes-footwear/seamstress-and-atelier-services", "clothes-footwear/overalls", "clothes-footwear/womens-clothes", "electronics/audio-video-dvd-sat", "electronics/batteries", "electronics/computers", "electronics/gps-sat-devices", "electronics/home-appliances", "electronics/other", "electronics/phones", "electronics/photo-optics", "electronics/tvs", "for-children/a-feed", "for-children/all-for-school", "for-children/autoarmchairs", "for-children/carriages", "for-children/children-furniture", "for-children/clothes-footwear", "for-children/hobby-groups-gardens", "for-children/other", "for-children/toys", "home-stuff/canvas-antiques", "home-stuff/furniture-interior", "home-stuff/gifts-souvenirs-handmade-products", "home-stuff/health-beauty", "home-stuff/home-plants", "home-stuff/jewelry", "home-stuff/other", "home-stuff/searches-finds", "work/business-contacts", "work/courses-education", "work/finance", "work/internet-services", "work/legal-services", "work/i-search-for-work", "work/other", "work/texts-translations", "work/are-required", "production-work/production-work-orders", "production-work/firewood", "production-work/economic-works", "production-work/other", "real-estate/brokers-services", "real-estate/farms-estates", "real-estate/flats", "real-estate/wood", "real-estate/homes-summer-residences", "real-estate/plots-and-lands", "real-estate/offices", "real-estate/other", "real-estate/premises", "entertainment/acquaintances", "entertainment/books", "entertainment/collecting", "entertainment/hobby", "entertainment/hunting-fishing", "entertainment/music", "entertainment/other", "entertainment/sports", "entertainment/tickets-concerts-where-to-go", "entertainment/tourism", "transport/bycycles", "transport/cargo-cars", "transport/cars", "transport/moto-transport", "transport/other", "transport/service-centers-and-checkup", "transport/transports-rent", "transport/transportation-and-loading", "construction/materials", "construction/civil-work", "construction/garden-technics", "construction/other", "construction/plumbing", "construction/projects-design", "construction/tools-and-technics" ], "enumTitles": [ "Agriculture › Agricultural machinery", "Agriculture › Agricultural works", "Agriculture › Animal husbandry", "Agriculture › Aviculture", "Agriculture › Fertilizer and chemicals", "Agriculture › Fish industry", "Agriculture › Foodstuffs", "Agriculture › Other", "Agriculture › Seeds and seedings", "Agriculture › Vegetable growing, gardening", "Animals › Cats, kittens", "Animals › Dogs, puppies", "Animals › Exotic animals", "Animals › Fish, aquariums", "Animals › Other", "Animals › Parrots and birds", "Animals › Rodents", "Animals › Veterinary medicine", "Clothes, footwear › Footwear", "Clothes, footwear › Glasses, belts, handbags", "Clothes, footwear › Men's clothes", "Clothes, footwear › Other", "Clothes, footwear › Sewing services and atelier", "Clothes, footwear › Unionalls", "Clothes, footwear › Women's clothes", "Electronics › Audio, Video, DVD, SAT", "Electronics › Batteries", "Electronics › Computers, office equipment", "Electronics › GPS navigators", "Electronics › Home appliances", "Electronics › Other and repair", "Electronics › Phones", "Electronics › Photo and optics", "Electronics › Televisions set", "For children › Accessories and food", "For children › All for school", "For children › Car seats, bags carrying", "For children › Carriages", "For children › Children furniture", "For children › Children's clothing, shoes", "For children › Mugs, kindergartens, sections", "For children › Other", "For children › Toys, swings", "For home › Antiques, canvas", "For home › Furniture, interior", "For home › Gifts, souvenirs", "For home › Health, beauty", "For home › Home plants", "For home › Jewellery, gems", "For home › Other...", "For home › Searches, finds", "Job and business › Business contacts", "Job and business › Courses, education", "Job and business › Financial services", "Job and business › Internet services", "Job and business › Legal services", "Job and business › Looking for a job", "Job and business › Other", "Job and business › Texts translations", "Job and business › Vacancies", "Production, work › Equipment", "Production, work › Firewood, briquettes, pellets", "Production, work › Household work", "Production, work › Other...", "Real estate › Brokers services", "Real estate › Farms, estates", "Real estate › Flats", "Real estate › Forest", "Real estate › Houses, cottages", "Real estate › Land and plots", "Real estate › Offices", "Real estate › Other...", "Real estate › Premises", "Rest, hobbies › Acquaintanc", "Rest, hobbies › Books", "Rest, hobbies › Collecting", "Rest, hobbies › Hobby", "Rest, hobbies › Hunting, fishing", "Rest, hobbies › Music, instrument, education", "Rest, hobbies › Other...", "Rest, hobbies › Sport, recreation", "Rest, hobbies › Tickets, concerts, where to go", "Rest, hobbies › Tourism", "Transport › Bicycles, scooters", "Transport › Cargo cars", "Transport › Cars", "Transport › Moto transport", "Transport › Other...", "Transport › Repair and spare parts", "Transport › Transport's rent", "Transport › Transportation of goods and people", "Construction › Building materials", "Construction › Construction works", "Construction › Garden technics", "Construction › Other", "Construction › Plumbing", "Construction › Projects, design", "Construction › Tools and technics" ] } }, "subcategories": { "title": "Subcategories", "type": "array", "description": "Optional. Names as shown on ss.com, inside the picked sections: a make (\"BMW\"), make and model (\"BMW > X5\"), a city or district (\"Riga\", \"Riga > Centre\", \"Jurmala\"), a breed (\"Labrador\") or a job (\"Driver\"). With no section picked, every section is searched for the name.", "items": { "type": "string" } }, "dealTypes": { "title": "Deal type", "type": "array", "description": "Sell, Buy, Rent out, Want to rent, Exchange and more. Empty = all of them. Sections without deal types (like Vacancies) are read whole.", "items": { "type": "string", "enum": [ "sell", "buy", "rentOut", "wantToRent", "exchange", "give", "make", "repair", "other" ], "enumTitles": [ "Sell", "Buy", "Rent out (Hand over)", "Want to rent (Will remove)", "Exchange", "Give away", "Making", "Repair", "Miscellaneous" ] } }, "postedWithin": { "title": "Posted within", "enum": [ "today", "2days", "5days" ], "type": "string", "description": "Only ads posted in the last day, 2 days or 5 days (the site's own date filter). Empty = all ads." }, "minPrice": { "title": "Minimum price (€)", "minimum": 0, "type": "integer", "description": "Only ads from this price in euros." }, "maxPrice": { "title": "Maximum price (€)", "minimum": 0, "type": "integer", "description": "Only ads up to this price in euros." }, "minYear": { "title": "Year from", "minimum": 1900, "type": "integer", "description": "Cars, motorbikes and other vehicles made in this year or later." }, "maxYear": { "title": "Year to", "minimum": 1900, "type": "integer", "description": "Vehicles made in this year or earlier." }, "maxMileageKm": { "title": "Maximum km", "minimum": 0, "type": "integer", "description": "Cars with at most this many kilometers." }, "minRooms": { "title": "Minimum rooms", "minimum": 0, "type": "integer", "description": "Flats with at least this many rooms." }, "maxRooms": { "title": "Maximum rooms", "minimum": 0, "type": "integer", "description": "Flats with at most this many rooms." }, "minAreaM2": { "title": "Minimum area (m²)", "minimum": 0, "type": "integer", "description": "Flats, houses, land and premises from this size." }, "maxAreaM2": { "title": "Maximum area (m²)", "minimum": 0, "type": "integer", "description": "Flats, houses, land and premises up to this size." }, "keyword": { "title": "Keyword search", "type": "string", "description": "ss.com's own search inside the picked sections, subcategories and deal types: the words anywhere in the ad (text and equipment, any case, accents ignored), like panorama or balkons. With Posted within, the site cannot search, so the words are checked in the title and list columns (or the full description with Details)." }, "withPhotoOnly": { "title": "With photo only", "type": "boolean", "description": "Skip ads without a photo." }, "includeDetails": { "title": "Details", "type": "boolean", "description": "Opens each ad's own page for the full description, every spec line (gearbox, body, color, seats, inspection; house type, floors, cadastral number; company, working hours), car equipment, GPS position, seller's place and company, posting time and all photos." }, "onlyNew": { "title": "Only new ads", "type": "boolean", "description": "Skip ads saved by earlier runs with the same monitor name." }, "monitorName": { "title": "Monitor name", "type": "string", "description": "Runs with the same name share their history. Use a different name for each schedule." }, "startUrls": { "title": "Links", "type": "array", "description": "ss.com category pages (ss.com/en/transport/cars/bmw/x5/, ss.com/lv/real-estate/flats/riga/centre/sell/, ss.com/en/transport/cars/today-2/) or ad pages (ss.com/msg/en/transport/cars/bmw/x5/abcde.html). Latvian and Russian links work too. Filters are ignored with links.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }