{ "openapi": "3.0.1", "info": { "title": "Autogidas.lt Car Ads Extractor", "description": "Extracts publicly available used-car listings from Autogidas.lt. Paste a search URL from the site and every matching public ad comes back as structured data — price, year, mileage, photos and the full parameter table. Only data any visitor can see on the site is returned.", "version": "0.1", "x-build-id": "oR3xEf2KHt0EjePbC" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/steeriq~autogidas-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-steeriq-autogidas-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/steeriq~autogidas-scraper/runs": { "post": { "operationId": "runs-sync-steeriq-autogidas-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/steeriq~autogidas-scraper/run-sync": { "post": { "operationId": "run-sync-steeriq-autogidas-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": "Start URLs", "type": "array", "description": "The recommended input. Build the search on autogidas.lt using the site's own filters — including the many this actor does not expose — and paste the resulting URL here. Several URLs are fine; their results are merged and de-duplicated. Whenever this field is non-empty the filter fields below are ignored completely.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "makes": { "title": "Makes and models", "type": "array", "description": "One row per make, optionally narrowed to models. Autogidas puts make and model in the URL path, so each combination becomes its own search. The make list is a suggestion, not a whitelist — it comes from the site's own make picker, so a make it omits can still be typed in. Models are free text: the site publishes no model list per make, and Apify input forms cannot drive one dropdown off another.", "items": { "type": "object", "properties": { "make": { "title": "Make", "description": "Make name as Autogidas spells it. Slugified into the search URL, so an unlisted name still works.", "type": "string", "editor": "select", "enumSuggestedValues": [ "Volkswagen", "BMW", "Audi", "Opel", "Toyota", "Volvo", "Ford", "Mercedes-Benz", "Peugeot", "Skoda", "A1 PRO", "Abarth", "AC", "Acura", "Aito", "Aixam", "Alfa Romeo", "Alpina", "Asia", "Aston Martin", "Austin", "Barkas", "Bentley", "Buick", "BYD", "Cadillac", "Casalini", "Chatenet", "Chevrolet", "Chrysler", "Citroen", "Cupra", "Dacia", "Daewoo", "DAF", "Daihatsu", "Datsun", "DFSK", "Dodge", "DS Automobiles", "Excalibur", "Ferrari", "Fiat", "Fisker", "Galloper", "GAZ", "GMC", "Gonow", "GWM", "Honda", "Hummer", "Hyundai", "Infiniti", "Isuzu", "Iveco", "Jaguar", "JDM", "Jeep", "JIA JI", "Kia", "Koenigsegg", "KTM", "Lada", "Lamborghini", "Lancia", "Land Rover", "Landwind", "Lexus", "Ligier", "Lincoln", "LuAZ", "Lynk & Co", "Man", "Maserati", "Maybach", "Mazda", "McLaren", "Mercury", "MG", "Microcar", "MINI", "Mitsubishi", "Moskvich", "MPM", "Nissan", "NSU", "Oldsmobile", "Ora", "Packard", "Piaggio", "Polestar", "Pontiac", "Porsche", "Renault", "Rover", "Saab", "SAIC", "Saturn", "Scion", "Seat", "Seres", "Shuanghuan", "Skut", "Smart", "Ssangyong", "Subaru", "Suzuki", "Tata", "Tesla", "Trabant", "UAZ", "Vauxhall", "Wartburg", "Xpeng", "Yunlong Motors", "ZAZ", "Zhidou" ] }, "models": { "title": "Models", "description": "Model names as Autogidas spells them, e.g. `320`, `X5`. Leave empty for every model of the make.", "type": "array", "editor": "stringList" } }, "required": [ "make" ] } }, "yearFrom": { "title": "Year from", "minimum": 1900, "type": "integer", "description": "Earliest manufacture year." }, "yearTo": { "title": "Year to", "minimum": 1900, "type": "integer", "description": "Latest manufacture year." }, "priceFrom": { "title": "Price from (EUR)", "minimum": 0, "type": "integer", "description": "Minimum asking price in EUR." }, "priceTo": { "title": "Price to (EUR)", "minimum": 0, "type": "integer", "description": "Maximum asking price in EUR." }, "mileageFrom": { "title": "Mileage from (km)", "minimum": 0, "type": "integer", "description": "Minimum odometer reading in kilometres." }, "mileageTo": { "title": "Mileage to (km)", "minimum": 0, "type": "integer", "description": "Maximum odometer reading in kilometres." }, "fuelType": { "title": "Fuel type", "type": "array", "description": "Any combination; leave empty for all.", "items": { "type": "string", "enum": [ "petrol", "diesel", "electric", "petrol-lpg", "petrol-electric", "petrol-electric-plugin", "petrol-electric-lpg", "diesel-electric", "diesel-electric-plugin", "lpg", "petrol-cng", "ethanol", "other" ], "enumTitles": [ "Petrol (Benzinas)", "Diesel (Dyzelinas)", "Electric (Elektra)", "Petrol / LPG (Benzinas/Dujos)", "Petrol / electric hybrid", "Petrol / electric plug-in", "Petrol / electric / LPG", "Diesel / electric hybrid", "Diesel / electric plug-in", "LPG only (Dujos)", "Petrol / CNG (Gamtinės dujos)", "Ethanol (Etanolis)", "Other (Kitas)" ] } }, "bodyType": { "title": "Body type", "type": "array", "description": "Any combination; leave empty for all.", "items": { "type": "string", "enum": [ "sedan", "hatchback", "wagon", "suv", "minivan", "coupe", "convertible", "passenger-van", "combi-van", "cargo-van", "commercial", "pickup", "limousine", "custom" ], "enumTitles": [ "Sedan (Sedanas)", "Hatchback (Hečbekas)", "Wagon (Universalas)", "SUV / crossover (Visureigis)", "Minivan (Vienatūris)", "Coupe", "Convertible (Kabrioletas)", "Passenger van (Keleivinis mikroautobusas)", "Combi van (Kombi mikroautobusas)", "Cargo van (Krovininis mikroautobusas)", "Commercial (Komercinis auto)", "Pickup (Pikapas)", "Limousine (Limuzinas)", "Custom built (Savadarbis auto)" ] } }, "gearbox": { "title": "Gearbox", "enum": [ "manual", "automatic" ], "type": "string", "description": "Autogidas allows only one gearbox value per search." }, "city": { "title": "City", "type": "string", "description": "Lithuanian city as the site spells it, e.g. `Vilnius`, `Kaunas`, `Klaipėda`." }, "validInspectionOnly": { "title": "Valid roadworthiness test only", "type": "boolean", "description": "Only ads with a valid technical inspection (Galiojanti TA).", "default": false }, "withVinOnly": { "title": "Ads with a VIN only", "type": "boolean", "description": "Only ads that publish a VIN code.", "default": false }, "hideAuctions": { "title": "Hide auction ads", "type": "boolean", "description": "Exclude ads that come from auctions.", "default": false }, "scrapeDetails": { "title": "Include full ad details", "type": "boolean", "description": "Visit each ad for the full parameter set (colour, doors, euro standard, fuel consumption, weight, partial VIN, all photos). Uncheck for a much faster, shallower pass over the results pages only.", "default": true }, "maxItems": { "title": "Max items", "minimum": 1, "type": "integer", "description": "Stop after this many ads. Autogidas does not cap pagination, so a broad search can reach the full result set (~28,000 for all cars).", "default": 1000 }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 50, "type": "integer", "description": "Kept low by default: the site sits behind Cloudflare.", "default": 5 }, "maxRequestRetries": { "title": "Max request retries", "minimum": 0, "type": "integer", "description": "How many times a blocked request is retried. Each retry draws a new proxy session and exit IP, which is how a working one is found. Short runs (a search matching only a few ads) rely on this most, because the session pool never warms up. Lowering it makes small searches fail outright.", "default": 25 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Residential proxy pinned to Lithuania is strongly recommended. Autogidas is behind Cloudflare and 403s many foreign/datacenter exit IPs; an unpinned run was blocked on every attempt while an LT-pinned run got through.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "LT" } } } }, "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 } } } } } } } } } }