{ "openapi": "3.0.1", "info": { "title": "Autopapa Georgia Scraper: Cars, Motorcycles & Dealers", "description": "Scrape autopapa.ge, the Georgian car marketplace: used and new cars, SUVs, trucks, motorcycles and trailers with USD and lari price, mileage, customs status, masked VIN, photos, dealers and price-change monitoring. No login, no proxy. Export JSON, CSV or Excel.", "version": "0.1", "x-build-id": "3vWrtOAjij1JIHm6a" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/recordsdata~autopapa-ge-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-recordsdata-autopapa-ge-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/recordsdata~autopapa-ge-scraper/runs": { "post": { "operationId": "runs-sync-recordsdata-autopapa-ge-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/recordsdata~autopapa-ge-scraper/run-sync": { "post": { "operationId": "run-sync-recordsdata-autopapa-ge-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": { "mode": { "title": "What to collect", "enum": [ "search", "urls", "dealers" ], "type": "string", "description": "search = vehicle ads for the makes, places and filters below. urls = listing addresses, listing numbers, search addresses and dealer pages you list. dealers = the car dealer directory with business data and stock counts.", "default": "search" }, "maxItems": { "title": "Maximum items", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Stops after this many rows (all record types together). Free plans are limited to 10 items per run.", "default": 50 }, "makes": { "title": "Makes", "type": "array", "description": "Car makes as written on the site, for example Toyota, BMW, Mercedes-Benz or Ford. Case and spaces do not matter. The make list is read from the site at run time, an unknown make is reported with close suggestions. Empty means every make.", "default": [], "items": { "type": "string" } }, "models": { "title": "Models", "type": "array", "description": "Models inside the makes above, for example Prius, Camry or X5. Needs at least one make. A model that does not exist for the chosen makes is reported with examples.", "default": [], "items": { "type": "string" } }, "cities": { "title": "Cities in Georgia", "type": "array", "description": "Georgian cities that have ads, for example Tbilisi, Batumi, Kutaisi or Rustavi. Each city is a separate search. Leave empty for the whole country. Cannot be combined with a country other than Georgia.", "default": [], "items": { "type": "string" } }, "country": { "title": "Where the vehicle is", "enum": [ "any", "georgia", "usa", "china", "japan", "armenia", "azerbaijan", "on-the-way" ], "type": "string", "description": "Country where the vehicle is located: already in Georgia, or still abroad (USA, China, Japan, Armenia, Azerbaijan) or on the way to Georgia.", "default": "any" }, "yearFrom": { "title": "Year from", "minimum": 0, "maximum": 2100, "type": "integer", "description": "Only vehicles of this model year or newer. 0 or empty means no limit." }, "yearTo": { "title": "Year to", "minimum": 0, "maximum": 2100, "type": "integer", "description": "Only vehicles of this model year or older. 0 or empty means no limit." }, "priceFrom": { "title": "Minimum price (USD)", "minimum": 0, "maximum": 100000000, "type": "integer", "description": "Only ads priced at or above this amount in US dollars. 0 or empty means no limit." }, "priceTo": { "title": "Maximum price (USD)", "minimum": 0, "maximum": 100000000, "type": "integer", "description": "Only ads priced at or below this amount in US dollars. 0 or empty means no limit." }, "mileageFrom": { "title": "Minimum mileage (km)", "minimum": 0, "maximum": 5000000, "type": "integer", "description": "Only vehicles with at least this odometer reading. 0 or empty means no limit." }, "mileageTo": { "title": "Maximum mileage (km)", "minimum": 0, "maximum": 5000000, "type": "integer", "description": "Only vehicles with at most this odometer reading. 0 or empty means no limit." }, "engineVolumeFrom": { "title": "Engine volume from (litres)", "minimum": 0, "maximum": 20, "type": "number", "description": "Only engines of at least this size in litres, for example 1.6. 0 or empty means no limit." }, "engineVolumeTo": { "title": "Engine volume to (litres)", "minimum": 0, "maximum": 20, "type": "number", "description": "Only engines of at most this size in litres, for example 2.5. 0 or empty means no limit." }, "powerFrom": { "title": "Power from (hp)", "minimum": 0, "maximum": 3000, "type": "integer", "description": "Only vehicles with at least this engine power in horsepower. 0 or empty means no limit." }, "powerTo": { "title": "Power to (hp)", "minimum": 0, "maximum": 3000, "type": "integer", "description": "Only vehicles with at most this engine power in horsepower. 0 or empty means no limit." }, "bodyTypes": { "title": "Body types", "type": "array", "description": "Vehicle types to keep: cars (sedan, SUV and others), trucks, buses, motorcycles, scooters, trailers or boats. Leave empty for all.", "items": { "type": "string", "enum": [ "sedan", "hatchback", "wagon", "suv", "sports-car", "cabriolet", "minibus", "truck", "bus", "pickup", "trailer", "minivan", "special", "motorcycle", "scooter", "quadricycle", "watercraft" ], "enumTitles": [ "Sedan", "Hatchback", "Wagon", "SUV", "Sports car", "Cabriolet", "Minibus", "Truck", "Bus", "Pickup", "Trailer", "Minivan", "Special vehicle", "Motorcycle", "Scooter", "Quadricycle", "Watercraft" ] }, "default": [] }, "fuelTypes": { "title": "Fuel types", "type": "array", "description": "Engine types to keep. Leave empty for all.", "items": { "type": "string", "enum": [ "petrol", "diesel", "hybrid", "plug-in-hybrid", "electric", "petrol-gas", "lpg" ], "enumTitles": [ "Petrol", "Diesel", "Hybrid", "Plug-in hybrid", "Electric", "Petrol/gas", "LPG" ] }, "default": [] }, "transmission": { "title": "Transmission", "enum": [ "any", "manual", "automatic" ], "type": "string", "description": "Gearbox type.", "default": "any" }, "driveType": { "title": "Drive type", "enum": [ "any", "front", "rear", "all-wheel" ], "type": "string", "description": "Which wheels are driven.", "default": "any" }, "steeringSide": { "title": "Steering wheel side", "enum": [ "any", "left", "right" ], "type": "string", "description": "Left-hand or right-hand drive. Imported Japanese cars are often right-hand drive.", "default": "any" }, "colors": { "title": "Exterior colors", "type": "array", "description": "Exterior colors to keep. Leave empty for all.", "items": { "type": "string", "enum": [ "black", "white", "gray", "silver", "blue", "red", "green", "brown", "beige", "yellow", "orange", "purple", "violet", "golden", "cream", "navy", "lime", "vinous", "metallic" ], "enumTitles": [ "Black", "White", "Gray", "Silver", "Blue", "Red", "Green", "Brown", "Beige", "Yellow", "Orange", "Purple", "Violet", "Golden", "Cream", "Navy", "Lime", "Vinous", "Metallic" ] }, "default": [] }, "condition": { "title": "Condition", "enum": [ "any", "new", "good", "needs-repair", "for-parts" ], "type": "string", "description": "Condition stated by the seller.", "default": "any" }, "customs": { "title": "Customs status", "enum": [ "any", "cleared", "not-cleared" ], "type": "string", "description": "Whether Georgian customs duty is already paid. Vehicles that are not cleared are usually still abroad or on the way.", "default": "any" }, "doors": { "title": "Doors", "enum": [ "any", "2-3", "4-5" ], "type": "string", "description": "Number of doors.", "default": "any" }, "seats": { "title": "Seats", "enum": [ "any", "2", "4-5", "6-8", "more-than-8" ], "type": "string", "description": "Number of seats.", "default": "any" }, "interiorMaterial": { "title": "Interior material", "enum": [ "any", "leather", "leatherette", "textiles", "velours", "suede", "alcantara", "vinyl", "silk", "combined" ], "type": "string", "description": "Seat material.", "default": "any" }, "interiorColor": { "title": "Interior color", "enum": [ "any", "black", "white", "grey", "brown", "red", "yellow", "blue", "cream", "lime", "golden", "navy", "vinous" ], "type": "string", "description": "Interior color.", "default": "any" }, "postedWithin": { "title": "Posted within", "enum": [ "any", "hour", "day", "3-days", "week", "month", "2-months", "3-months" ], "type": "string", "description": "Only ads published in this period. Useful for daily monitoring together with sorting by newest.", "default": "any" }, "checkedByAutopapa": { "title": "Checked by Autopapa only", "type": "boolean", "description": "Only vehicles the marketplace itself inspected.", "default": false }, "withCarfax": { "title": "With Carfax report only", "type": "boolean", "description": "Only ads that carry a Carfax history report.", "default": false }, "withVideo": { "title": "With video only", "type": "boolean", "description": "Only ads that include a video.", "default": false }, "fromEurope": { "title": "From Europe only", "type": "boolean", "description": "Only vehicles imported from Europe.", "default": false }, "withoutGeorgiaMileage": { "title": "Without Georgian mileage only", "type": "boolean", "description": "Only vehicles that have not been driven in Georgia.", "default": false }, "sortBy": { "title": "Sort by", "enum": [ "popularity", "newest", "oldest", "price-asc", "price-desc" ], "type": "string", "description": "Order of the results. Newest first is best for monitoring.", "default": "newest" }, "startUrls": { "title": "Addresses", "type": "array", "description": "urls mode. autopapa.ge listing pages (https://autopapa.ge/en/usd/...), search result pages with filters, the dealer list (/business) or one dealer page (/business/). Listing numbers can go in the next field.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "listingIds": { "title": "Listing numbers", "type": "array", "description": "urls mode. The number at the end of a listing address, for example 962571. Five to nine digits.", "default": [], "items": { "type": "string" } }, "dealerQuery": { "title": "Dealer name contains", "type": "string", "description": "dealers mode. Keeps only dealers whose name contains this text. Empty means every dealer.", "default": "" }, "includeDealerVehicles": { "title": "Include the vehicles of each dealer", "type": "boolean", "description": "On: after each dealer record, also read that dealer's vehicle listings (each one is a vehicle record).", "default": false }, "scrapeDetails": { "title": "Open every listing page", "type": "boolean", "description": "On: open each listing page to add the full photo gallery, description, equipment, VIN (masked), views, publication date and seller block (vehicle-detail-record). Off: the data of the search result only, much faster (vehicle-record).", "default": false }, "includeContactDetails": { "title": "Include dealer contact details", "type": "boolean", "description": "Adds the business phone and email of dealerships and keeps phone numbers inside their descriptions. Private seller names, phones and emails are never output.", "default": false }, "onlyNew": { "title": "Only new listings (monitor)", "type": "boolean", "description": "Skips every listing seen in an earlier run with the same monitor name, so scheduled runs return only what is new.", "default": false }, "trackPriceChanges": { "title": "Report price changes", "type": "boolean", "description": "Needs Only new listings. A listing seen before with a different price comes back as a price-change-record with the previous price and the change in percent.", "default": false }, "stateKey": { "title": "Monitor name", "type": "string", "description": "Name of the memory used by Only new listings. Use one name per saved search. Empty derives a name from your filters.", "default": "" }, "resetSeen": { "title": "Forget seen listings", "type": "boolean", "description": "Clears the memory of the monitor name before this run.", "default": false }, "maxConcurrency": { "title": "Parallel page reads", "minimum": 1, "maximum": 5, "type": "integer", "description": "How many listing pages are read at the same time (1 to 5). The site asks for about one request per second, so requests are paced and a higher value adds little.", "default": 2 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Optional. Empty means direct requests, which work. Add a proxy only if your own network needs one." } } }, "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 } } } } } } } } } }