{ "openapi": "3.0.1", "info": { "title": "Kijiji Auto & Vehicle Scraper + Real Time Notifications", "description": "Extract car and truck listings from Kijiji Canada. Filter by 73 makes, body type, transmission, fuel type, drivetrain, price, year, mileage, and more. Get titles, prices, locations, images, and attributes. Skip seen listings, Discord alerts, API access, and scheduled runs. ~$0.008 per run.", "version": "0.0", "x-build-id": "GFs7BGhOmX1eYDqhS" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/raidr-api~kijiji-vehicle-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-raidr-api-kijiji-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~kijiji-vehicle-scraper/runs": { "post": { "operationId": "runs-sync-raidr-api-kijiji-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~kijiji-vehicle-scraper/run-sync": { "post": { "operationId": "run-sync-raidr-api-kijiji-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": [ "location" ], "properties": { "location": { "title": "📍 Location", "type": "string", "description": "Where to search on Kijiji. Enter a city name, full address, or postal code. Examples: \"Toronto, ON\", \"Edmonton, AB\", \"V6B 1A1\".", "default": "Toronto, ON" }, "radius": { "title": "📏 Search Radius", "enum": [ "5", "10", "25", "50", "100", "150", "200", "300", "500" ], "type": "string", "description": "How far from your location to search. Pick a radius that covers the area you're interested in.", "default": "150" }, "searchQuery": { "title": "🔤 Search Query", "type": "string", "description": "Optional keywords to search for. For example: \"Honda Civic\", \"Ford F-150\", \"electric SUV\". Leave blank to return all vehicle listings for your location and filters." }, "sortBy": { "title": "📊 Sort By", "enum": [ "DATE_DESC", "DATE_ASC", "PRICE_ASC", "PRICE_DESC", "MILEAGE_ASC", "MILEAGE_DESC", "DISTANCE_ASC" ], "type": "string", "description": "How to sort the results. This matches the sorting dropdown on kijiji.ca.", "default": "DATE_DESC" }, "forSaleBy": { "title": "🏷️ For Sale By", "type": "array", "description": "Filter by seller type. Select one or more, or leave empty for all seller types.", "items": { "type": "string", "enum": [ "ownr", "delr" ], "enumTitles": [ "Owner", "Dealer" ] } }, "makes": { "title": "🚘 Make", "type": "array", "description": "Filter by car manufacturer. Select one or more makes, or leave empty to include all makes.", "items": { "type": "string", "enum": [ "acura", "alpharomeo", "am_general", "amc", "astnmrtn", "audi", "austinhealey", "bentley", "bmw", "bricklin", "bugatti", "buick", "cadillac", "chevrolet", "chrysler", "daewoo", "datsun", "diahatsu", "dodge", "eagle", "ferrari", "fiat", "ford", "genesis", "geo", "gmc", "honda", "hummer", "hyundai", "infiniti", "inthrvstr", "isuzu", "jaguar", "jeep", "kia", "landrover", "lexus", "lincoln", "lmbrghn", "lotus", "maserati", "maybach", "mazda", "mclaren", "mercedes", "mercedes-amg", "mercury", "mg", "mini", "mitsubishi", "nissan", "oldsmobile", "opel", "peugeot", "plymouth", "polestar", "pontiac", "porsche", "ram", "renault", "rollsroyce", "saab", "saturn", "scion", "shelby", "smart", "subaru", "suzuki", "tesla", "toyota", "triumph", "volkwagen", "volvo", "othrmake" ], "enumTitles": [ "Acura", "Alfa Romeo", "AM General", "AMC", "Aston Martin", "Audi", "Austin-Healey", "Bentley", "BMW", "Bricklin", "Bugatti", "Buick", "Cadillac", "Chevrolet", "Chrysler", "Daewoo", "Datsun", "Daihatsu", "Dodge", "Eagle", "Ferrari", "Fiat", "Ford", "Genesis", "Geo", "GMC", "Honda", "Hummer", "Hyundai", "Infiniti", "International Harvester", "Isuzu", "Jaguar", "Jeep", "Kia", "Land Rover", "Lexus", "Lincoln", "Lamborghini", "Lotus", "Maserati", "Maybach", "Mazda", "McLaren", "Mercedes-Benz", "Mercedes-AMG", "Mercury", "MG", "MINI", "Mitsubishi", "Nissan", "Oldsmobile", "Opel", "Peugeot", "Plymouth", "Polestar", "Pontiac", "Porsche", "RAM", "Renault", "Rolls-Royce", "Saab", "Saturn", "Scion", "Shelby", "Smart", "Subaru", "Suzuki", "Tesla", "Toyota", "Triumph", "Volkswagen", "Volvo", "Other" ] } }, "bodyTypes": { "title": "🚙 Body Type", "type": "array", "description": "Filter by body type. Select one or more, or leave empty for all body types.", "items": { "type": "string", "enum": [ "conv", "coup", "htchbck", "pickuptruck", "sedan", "suvcrossover", "vanminicomma", "wagon", "othrbdytyp" ], "enumTitles": [ "Convertible", "Coupe", "Hatchback", "Pickup Truck", "Sedan", "SUV / Crossover", "Minivan / Van", "Wagon", "Other" ] } }, "conditions": { "title": "✅ Condition", "type": "array", "description": "Filter by vehicle condition. Select one or more, or leave empty for all conditions.", "items": { "type": "string", "enum": [ "new", "used", "lease", "damaged", "salvage" ], "enumTitles": [ "New", "Used", "Lease Takeover", "Damaged", "Salvage" ] } }, "transmissions": { "title": "⚙️ Transmission", "type": "array", "description": "Filter by transmission type. Select one or more, or leave empty for all types.", "items": { "type": "string", "enum": [ "1", "2", "3", "0" ], "enumTitles": [ "Manual", "Automatic", "Other", "Semi-Automatic" ] } }, "fuelTypes": { "title": "⛽ Fuel Type", "type": "array", "description": "Filter by fuel type. Select one or more, or leave empty for all fuel types.", "items": { "type": "string", "enum": [ "diesel", "electric", "gas", "hybrid", "other" ], "enumTitles": [ "Diesel", "Electric", "Gas", "Hybrid / Electric", "Other" ] } }, "drivetrains": { "title": "🛞 Drivetrain", "type": "array", "description": "Filter by drivetrain. Select one or more, or leave empty for all drivetrains.", "items": { "type": "string", "enum": [ "4x4", "awd", "fwd", "rwd", "other" ], "enumTitles": [ "4 x 4", "All-Wheel Drive (AWD)", "Front-Wheel Drive (FWD)", "Rear-Wheel Drive (RWD)", "Other" ] } }, "colours": { "title": "🎨 Colour", "type": "array", "description": "Filter by exterior colour. Select one or more, or leave empty for all colours.", "items": { "type": "string", "enum": [ "black", "blue", "brown", "burgundy", "gold", "gray", "green", "orange", "pink", "purple", "red", "silver", "tan", "teal", "white", "yellow", "beige", "off_white", "other" ], "enumTitles": [ "Black", "Blue", "Brown", "Burgundy", "Gold", "Grey", "Green", "Orange", "Pink", "Purple", "Red", "Silver", "Tan", "Teal", "White", "Yellow", "Beige", "Off White", "Other" ] } }, "seats": { "title": "💺 Seats", "type": "array", "description": "Filter by number of seats. Select one or more, or leave empty for any number of seats.", "items": { "type": "string", "enum": [ "2", "3", "4", "5", "6", "7", "other" ], "enumTitles": [ "2 seats", "3 seats", "4 seats", "5 seats", "6 seats", "7+ seats", "Other" ] } }, "doors": { "title": "🚪 Doors", "type": "array", "description": "Filter by number of doors. Select one or more, or leave empty for any number of doors.", "items": { "type": "string", "enum": [ "2", "3", "4", "5", "others" ], "enumTitles": [ "2 doors", "3 doors", "4 doors", "5 doors", "Other" ] } }, "adType": { "title": "📋 Offer Type", "enum": [ "OFFER", "WANTED" ], "type": "string", "description": "Filter by offer type. \"For Sale\" shows vehicles listed for sale. \"Wanted\" shows buyers looking for vehicles.", "default": "OFFER" }, "minPrice": { "title": "💲 Min Price ($)", "type": "integer", "description": "Minimum price in dollars. Example: 5000 = $5,000. Leave at 0 for no minimum.", "default": 0 }, "maxPrice": { "title": "💲 Max Price ($)", "type": "integer", "description": "Maximum price in dollars. Example: 50000 = $50,000. Leave at 0 for no maximum.", "default": 0 }, "minYear": { "title": "📅 Min Year", "type": "integer", "description": "Earliest model year to include. Example: 2015. Leave at 0 for no minimum.", "default": 0 }, "maxYear": { "title": "📅 Max Year", "type": "integer", "description": "Latest model year to include. Example: 2026. Leave at 0 for no maximum.", "default": 0 }, "minKilometers": { "title": "🛣️ Min Kilometres", "type": "integer", "description": "Minimum mileage in km. Example: 10000. Leave at 0 for no minimum.", "default": 0 }, "maxKilometers": { "title": "🛣️ Max Kilometres", "type": "integer", "description": "Maximum mileage in km. Example: 150000. Leave at 0 for no maximum.", "default": 0 }, "airConditioning": { "title": "❄️ Air Conditioning", "type": "boolean", "description": "Only show vehicles with air conditioning.", "default": false }, "alloyWheels": { "title": "🔘 Alloy Wheels", "type": "boolean", "description": "Only show vehicles with alloy wheels.", "default": false }, "bluetooth": { "title": "📶 Bluetooth", "type": "boolean", "description": "Only show vehicles with Bluetooth.", "default": false }, "cruiseControl": { "title": "🚢 Cruise Control", "type": "boolean", "description": "Only show vehicles with cruise control.", "default": false }, "navigationSystem": { "title": "🧭 Navigation System", "type": "boolean", "description": "Only show vehicles with a navigation system.", "default": false }, "parkingAssist": { "title": "🅿️ Parking Assistant", "type": "boolean", "description": "Only show vehicles with parking assist.", "default": false }, "pushButtonStart": { "title": "🔑 Push Button Start", "type": "boolean", "description": "Only show vehicles with push button start.", "default": false }, "sunroof": { "title": "☀️ Sunroof", "type": "boolean", "description": "Only show vehicles with a sunroof.", "default": false }, "trailerHitch": { "title": "🪝 Trailer Hitch", "type": "boolean", "description": "Only show vehicles with a trailer hitch.", "default": false }, "maxPages": { "title": "📄 Max Pages", "type": "integer", "description": "Maximum number of pages to fetch (40 listings per page). Set to 0 to fetch all available pages. Example: 5 = up to 200 listings.", "default": 5 }, "skipPreviouslySeen": { "title": "🔄 Skip Previously Seen Listings", "type": "boolean", "description": "Remember listing IDs from previous runs and only output new listings. Useful for scheduled runs that monitor for new vehicles over time. When enabled, only listings that haven't been seen in any previous run will appear in the dataset output and Discord notifications.", "default": false }, "enableDiscord": { "title": "💬 Enable Discord Notifications", "type": "boolean", "description": "Turn on Discord notifications. You must also provide a webhook URL below for notifications to be sent.", "default": false }, "discordWebhookUrl": { "title": "🔗 Webhook URL", "type": "string", "description": "Discord webhook URL for notifications. Leave empty to disable Discord notifications.", "default": "" }, "discordImageDisplay": { "title": "🖼️ Image Style", "enum": [ "thumbnail", "full", "none" ], "type": "string", "description": "How listing images appear in Discord. Thumbnail shows a small image on the right. Full shows a large image below the embed.", "default": "thumbnail" }, "proxyConfiguration": { "title": "🌐 Proxy Configuration", "type": "object", "description": "Proxy settings. Not required by default — enable if Kijiji starts blocking requests. Residential proxies with a Canadian IP are recommended when enabled.", "default": { "useApifyProxy": false } } } }, "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 } } } } } } } } } }