{ "openapi": "3.0.1", "info": { "title": "JamesEdition Cars Scraper", "description": "[💰 $12 / 1K] Extract luxury, classic and supercar listings from JamesEdition. Filter by make, model, year, price, mileage, body type, colour, steering side and country. Get EUR/USD/local prices, full specs, VIN, photo galleries, map coordinates and dealer details.", "version": "1.0", "x-build-id": "isOWsRO2pazWU1f8c" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/solidcode~james-edition-cars-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-solidcode-james-edition-cars-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/solidcode~james-edition-cars-scraper/runs": { "post": { "operationId": "runs-sync-solidcode-james-edition-cars-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/solidcode~james-edition-cars-scraper/run-sync": { "post": { "operationId": "run-sync-solidcode-james-edition-cars-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": { "make": { "title": "Make", "type": "string", "description": "Car manufacturer to search, for example \"Porsche\", \"Ferrari\", \"Mercedes\" or \"Rolls Royce\". Leave empty to search every make at once. Ignored when Start URLs are provided." }, "model": { "title": "Model", "type": "string", "description": "Model within the chosen make, for example \"911 GT3 RS\", \"Cayenne\" or \"Mustang\". Requires a Make. Leave empty to include every model." }, "startUrls": { "title": "Start URLs", "type": "array", "description": "Paste one or more JamesEdition links, either car search pages or single car pages. When provided, these replace the search fields above and below.", "items": { "type": "string" } }, "countryCode": { "title": "Country", "enum": [ "US", "AE", "DE", "GB", "ES", "IT", "JP", "NL", "MC", "FR", "CA", "AT", "NZ", "AU", "SG", "SK", "LU", "KR", "BG", "SI" ], "type": "string", "description": "Only include cars located in this country. Only the 20 countries listed here currently have cars for sale on JamesEdition. Leave empty to search worldwide." }, "regionCode": { "title": "State / Region Code", "type": "string", "description": "Official short region code only — NOT the full name. Use \"CA\" for California, \"FL\" for Florida, \"TX\" for Texas, \"BY\" for Bavaria. Typing \"California\" returns nothing. Requires a Country. Leave empty for the whole country." }, "priceMinEur": { "title": "Minimum Price (EUR)", "minimum": 0, "type": "integer", "description": "Only include cars at or above this price, in euros. JamesEdition compares prices in euros no matter which currency a seller lists in. Leave empty for no minimum." }, "priceMaxEur": { "title": "Maximum Price (EUR)", "minimum": 0, "type": "integer", "description": "Only include cars at or below this price, in euros. Leave empty for no maximum." }, "yearFrom": { "title": "Year From", "minimum": 1900, "maximum": 2100, "type": "integer", "description": "Only include cars from this model year or later, for example 2020 for recent cars. Leave empty for any year." }, "yearTo": { "title": "Year To", "minimum": 1900, "maximum": 2100, "type": "integer", "description": "Only include cars from this model year or earlier, for example 1975 for classics. Leave empty for any year." }, "mileageMinMiles": { "title": "Minimum Mileage (miles)", "minimum": 0, "type": "integer", "description": "Only include cars with at least this many miles on the odometer. JamesEdition filters mileage in miles even when a listing displays kilometres. Leave empty for any mileage." }, "mileageMaxMiles": { "title": "Maximum Mileage (miles)", "minimum": 0, "type": "integer", "description": "Only include cars with at most this many miles on the odometer. Set a low number such as 1000 to find delivery-mileage and collector cars. Leave empty for any mileage." }, "bodyTypes": { "title": "Body Types", "uniqueItems": true, "type": "array", "description": "Only include these body styles. Leave empty to include every type.", "items": { "type": "string", "enum": [ "coupe", "suv", "sedan", "cabriolet", "pickup", "limousine", "roadster", "race_car", "hot_rod", "station_estate_wagon", "rv", "golf car", "green_electric", "other" ], "enumTitles": [ "Coupe", "SUV", "Sedan", "Cabriolet / Convertible", "Pickup", "Limousine", "Roadster", "Race Car", "Hot Rod", "Station / Estate Wagon", "RV / Motorhome", "Golf Car", "Electric / Green", "Other" ] } }, "exteriorColors": { "title": "Exterior Colours", "uniqueItems": true, "type": "array", "description": "Only include cars in these exterior colours. Leave empty to include every colour.", "items": { "type": "string", "enum": [ "black", "white", "grey", "silver", "red", "blue", "green", "yellow", "orange", "brown", "beige", "gold", "purple", "pink", "turquoise", "two_tone", "custom" ], "enumTitles": [ "Black", "White", "Grey", "Silver", "Red", "Blue", "Green", "Yellow", "Orange", "Brown", "Beige", "Gold", "Purple", "Pink", "Turquoise", "Two-tone", "Custom" ] } }, "interiorColors": { "title": "Interior Colours", "uniqueItems": true, "type": "array", "description": "Only include cars with these interior colours. The interior palette is not identical to the exterior one — pink and turquoise interiors are not offered. Leave empty to include every colour.", "items": { "type": "string", "enum": [ "black", "white", "grey", "silver", "red", "blue", "green", "yellow", "orange", "brown", "beige", "gold", "purple", "two_tone", "custom", "tone" ], "enumTitles": [ "Black", "White", "Grey", "Silver", "Red", "Blue", "Green", "Yellow", "Orange", "Brown", "Beige", "Gold", "Purple", "Two-tone", "Custom", "Tone" ] } }, "steeringSide": { "title": "Steering Side", "uniqueItems": true, "type": "array", "description": "Only include left-hand drive or right-hand drive cars. Leave empty to include both.", "items": { "type": "string", "enum": [ "lhd", "rhd" ], "enumTitles": [ "Left-hand drive (LHD)", "Right-hand drive (RHD)" ] } }, "sortBy": { "title": "Sort Results By", "enum": [ "premium", "popular", "recent", "price_desc", "price_asc", "year_desc", "year_asc", "mileage_asc", "mileage_desc" ], "type": "string", "description": "Choose the order in which cars are collected. Useful together with Max Cars — for example sort by highest price to collect only the top of the market." }, "maxResults": { "title": "Max Cars", "minimum": 0, "type": "integer", "description": "Maximum number of cars to collect per search (or per Start URL). Set to 0 to collect everything available. JamesEdition itself stops paginating after 1,800 cars per search, so one search can never return more than 1,800 no matter how high you set this — split large jobs by make, country or price band to go beyond that." }, "includeDetails": { "title": "Include Full Car Details", "type": "boolean", "description": "Open each car's own page to add the full seller description, engine, gearbox, fuel type, drivetrain, condition, VIN, interior colour, exact mileage, the dealership's name, address and profile, and the sales contact. This adds one extra page load per car, so runs take longer. Leave off for a fast overview with photos, prices and location only." } } }, "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 } } } } } } } } } }