{ "openapi": "3.0.1", "info": { "title": "OfferUp Vehicle Scraper + Instant Results", "description": "Scrape OfferUp for vehicles by make, model, year, price, and mileage. Features exact listing dates, smart age filtering, and deduplication. Optimized for lowest cost per run using advanced extraction techniques. Get instant vehicle results with filtering for private listings only.", "version": "0.0", "x-build-id": "uIMOG4NCqp6sHg4ra" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/raidr-api~offerup-vehicle-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-raidr-api-offerup-vehicle-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/raidr-api~offerup-vehicle-scraper/runs": { "post": { "operationId": "runs-sync-raidr-api-offerup-vehicle-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/raidr-api~offerup-vehicle-scraper/run-sync": { "post": { "operationId": "run-sync-raidr-api-offerup-vehicle-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": [ "zipcode" ], "properties": { "zipcode": { "title": "πŸ“ ZIP Code", "type": "string", "description": "ZIP code used as the center point for the OfferUp vehicle search.", "default": "77002" }, "radius": { "title": "πŸ—ΊοΈ Search Radius", "enum": [ "", "25", "80", "100", "200", "5000" ], "type": "string", "description": "Distance around the ZIP code. Leave as no limit to let OfferUp return the broad default feed.", "default": "" }, "maxItems": { "title": "πŸ“¦ Maximum Results", "minimum": 1, "type": "integer", "description": "Maximum number of unique listings to save to the dataset.", "default": 500 }, "sort": { "title": "↕️ Sort Results By", "enum": [ "", "-posted", "distance", "price", "-price", "-vehicle_year", "vehicle_miles" ], "type": "string", "description": "How OfferUp should order the feed results.", "default": "" }, "priceMin": { "title": "πŸ’΅ Minimum Price", "minimum": 0, "type": "integer", "description": "Minimum listing price. Leave empty for no minimum." }, "priceMax": { "title": "πŸ’° Maximum Price", "minimum": 0, "type": "integer", "description": "Maximum listing price. Leave empty for no maximum." }, "vehicleMakes": { "title": "🚘 Vehicle Makes", "uniqueItems": true, "type": "array", "description": "Filter by one or more vehicle makes. Leave empty to include all makes.", "items": { "type": "string", "enum": [ "ab", "ac", "ad", "aj", "an", "ap", "bb", "bf", "bi", "bj", "c", "cc", "cd", "d", "dc", "de", "dh", "e", "fb", "fc", "fd", "fe", "ga", "ge", "hb", "he", "hf", "i", "ic", "j", "jb", "k", "lb", "ld", "lf", "lg", "lh", "mb", "me", "mf", "mh", "mi", "mk", "ml", "n", "o", "pe", "pf", "pg", "r", "re", "s", "sb", "sc", "sh", "sl", "sn", "tc", "td", "vb", "vc" ], "enumTitles": [ "Abarth", "Acura", "Alfa Romeo", "AM General", "Aston Martin", "Audi", "Bentley", "BMW", "Bugatti", "Buick", "Cadillac", "Chevrolet", "Chrysler", "Daewoo", "Daihatsu", "Datsun", "Dodge", "Eagle", "Ferrari", "Fiat", "Fisker", "Ford", "Genesis", "GMC", "Honda", "Hummer", "Hyundai", "Infiniti", "Isuzu", "Jaguar", "Jeep", "Kia", "Lamborghini", "Land Rover", "Lexus", "Lincoln", "Lotus", "Maserati", "Mazda", "McLaren", "Mercedes-Benz", "Mercury", "Mini", "Mitsubishi", "Nissan", "Oldsmobile", "Plymouth", "Pontiac", "Porsche", "Ram", "Rolls-Royce", "Saab", "Saturn", "Scion", "Smart", "Subaru", "Suzuki", "Tesla", "Toyota", "Volkswagen", "Volvo" ] } }, "vehicleYearMin": { "title": "πŸ“… Minimum Year", "minimum": 1936, "type": "integer", "description": "Minimum vehicle model year. Leave empty for no minimum." }, "vehicleYearMax": { "title": "πŸ“… Maximum Year", "minimum": 1936, "type": "integer", "description": "Maximum vehicle model year. Leave empty for no maximum." }, "vehicleMileageMax": { "title": "🧭 Maximum Mileage", "enum": [ "", "0", "25000", "50000", "75000", "100000", "125000", "150000", "175000", "200000" ], "type": "string", "description": "Only include vehicles at or below this mileage. Leave as no limit to include all mileage values.", "default": "" }, "vehicleStyles": { "title": "πŸš™ Body Styles", "uniqueItems": true, "type": "array", "description": "Filter by vehicle body style. Leave empty to include all styles.", "items": { "type": "string", "enum": [ "c", "s", "t", "v" ], "enumTitles": [ "Car", "SUV", "Truck", "Van" ] } }, "vehicleTransmissions": { "title": "βš™οΈ Transmissions", "uniqueItems": true, "type": "array", "description": "Filter by transmission type. Leave empty to include all transmissions.", "items": { "type": "string", "enum": [ "a", "m" ], "enumTitles": [ "Automatic", "Manual" ] } }, "vehicleDrivetrains": { "title": "πŸ›ž Drivetrains", "uniqueItems": true, "type": "array", "description": "Filter by drivetrain. Leave empty to include all drivetrains.", "items": { "type": "string", "enum": [ "a", "f", "r" ], "enumTitles": [ "AWD/4WD", "FWD", "RWD" ] } }, "vehicleMpgMin": { "title": "β›½ Minimum MPG", "enum": [ "", "10", "20", "30", "40" ], "type": "string", "description": "Minimum fuel efficiency. Leave as no limit to include all MPG values.", "default": "" }, "conditions": { "title": "🏷️ Listing Conditions", "uniqueItems": true, "type": "array", "description": "Filter by OfferUp listing condition. Leave empty to include every condition.", "items": { "type": "string", "enum": [ "NEW", "REFURBISHED", "OPEN_BOX", "USED", "BROKEN", "OTHER" ], "enumTitles": [ "New", "Excellent", "Very good", "Good", "Fair", "For parts" ] } } } }, "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 } } } } } } } } } }