{ "openapi": "3.0.1", "info": { "title": "NeoAuto Scraper", "description": "Pull every car for sale in Peru in one run: lead-gen teams get the seller's real name, phone and WhatsApp, dealers track competitor pricing by brand and region, and researchers model price by year and mileage, straight from NeoAuto, with pagination that actually reaches what you ask for.", "version": "1.0", "x-build-id": "REDrNGOiApEFoM0YG" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/normdata~neoauto-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-normdata-neoauto-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~neoauto-scraper/runs": { "post": { "operationId": "runs-sync-normdata-neoauto-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~neoauto-scraper/run-sync": { "post": { "operationId": "run-sync-normdata-neoauto-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 vehicles", "minimum": 1, "type": "integer", "description": "Stop after this many listings. Leave empty for no limit (the run stops once the matching listings run out). The Apify Free plan is always capped at 10." }, "pageUrl": { "title": "Paste a NeoAuto search link (optional)", "type": "string", "description": "Already built a search on neoauto.com with the filters you want? Paste that page's URL here and this Actor reuses it exactly, every filter below is then ignored." }, "make": { "title": "Make", "type": "string", "description": "Brand slug as NeoAuto uses it, e.g. \"toyota\", \"hyundai\", \"kia\", \"mercedes-benz\". Leave empty for every make." }, "model": { "title": "Model", "type": "string", "description": "Model slug, e.g. \"corolla\", \"tucson\". Works best together with Make." }, "priceMin": { "title": "Minimum price (USD)", "minimum": 0, "type": "integer", "description": "Only listings priced at or above this amount. NeoAuto prices everything in US dollars." }, "priceMax": { "title": "Maximum price (USD)", "minimum": 0, "type": "integer", "description": "Only listings priced at or below this amount." }, "yearMin": { "title": "Year from", "minimum": 1950, "maximum": 2035, "type": "integer", "description": "Oldest model year to include." }, "yearMax": { "title": "Year to", "minimum": 1950, "maximum": 2035, "type": "integer", "description": "Newest model year to include." }, "kmMax": { "title": "Maximum mileage (km)", "minimum": 0, "type": "integer", "description": "Only listings with this many kilometers or fewer." }, "bodyType": { "title": "Body type", "enum": [ "", "camionetas-suv", "sedan", "hatchback", "pick-up", "vans", "deportivo", "station-wagon", "buses-camiones-y-vans" ], "type": "string", "description": "Category as NeoAuto names it." }, "fuel": { "title": "Fuel", "enum": [ "", "gasolina", "diesel", "hibrido", "gas_hibrido", "electrica", "dual", "gas", "glp", "gnv" ], "type": "string", "description": "Engine fuel type." }, "transmission": { "title": "Transmission", "enum": [ "", "automatica", "mecanica", "secuencial" ], "type": "string", "description": "Gearbox type." }, "department": { "title": "Department (region)", "enum": [ "", "lima", "arequipa", "callao", "la-libertad", "ica", "junin", "piura", "lambayeque", "cusco", "ucayali", "tacna", "ancash" ], "type": "string", "description": "Peruvian department where the vehicle is listed." }, "sellerType": { "title": "Seller type", "enum": [ "todos", "dealer", "particular" ], "type": "string", "description": "Keep only private sellers or only dealers. Applied after fetching, like a client-side filter." }, "verifiedOnly": { "title": "Verified listings only", "type": "boolean", "description": "Keep only listings NeoAuto marks as verified (papers checked, no pending fines)." }, "fetchDetails": { "title": "Fetch extra detail per listing", "type": "boolean", "description": "Opens each listing's own page to add color, doors, engine size (cc), drivetrain, district, the full description, and how long ago it was posted. Slower, one extra request per listing, so it's off by default." }, "customQuery": { "title": "Extra NeoAuto query parameters", "type": "string", "description": "Optional. Raw query string to append to the search, for anything not exposed above, e.g. \"publicado=7dias\" or \"verificado=1&publicado=hoy\"." } } }, "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 } } } } } } } } } }