{ "openapi": "3.0.1", "info": { "title": "Kijiji.ca Scraper", "description": "Scrape Kijiji.ca listings by keyword, category and location: cars, apartments, jobs and buy & sell ads with price, photos, seller, coordinates and vehicle or rental details. Export JSON, CSV or Excel.", "version": "1.0", "x-build-id": "PgwOZQNHgXsN0WADy" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/parsebird~kijiji-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-parsebird-kijiji-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/parsebird~kijiji-scraper/runs": { "post": { "operationId": "runs-sync-parsebird-kijiji-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/parsebird~kijiji-scraper/run-sync": { "post": { "operationId": "run-sync-parsebird-kijiji-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": { "keywords": { "title": "Search keywords", "type": "array", "description": "Enter one or more search terms, the same as typing in the Kijiji search box (e.g. honda civic, 2 bedroom apartment, sectional sofa). Each keyword is a separate search that uses the Category, Location and filters below. Leave empty to browse a whole category.", "items": { "type": "string" } }, "category": { "title": "Category", "enum": [ "", "1", "2", "3", "4", "5", "7", "9", "120", "289", "634", "635", "636", "15102001", "10", "12", "14", "16", "17", "19", "26", "103", "104", "107", "108", "109", "110", "111", "128", "132", "133", "139", "140", "141", "235", "253", "274", "638", "644", "717", "727", "767", "931", "15093001", "17220001", "29659001", "29659003", "27", "29", "30", "31", "33", "122", "142", "171", "172", "174", "301", "341", "34", "170", "30349001", "36", "37", "39", "40", "42", "30353001", "35", "44", "641", "643", "45", "46", "47", "50", "54", "55", "58", "59", "60", "61", "62", "146", "147", "148", "149", "150", "152", "420", "898", "72", "76", "79", "83", "84", "86", "87", "131", "144", "160", "165", "166", "168", "169", "302", "15214001", "112", "114", "115", "125", "126", "127", "135", "143", "217", "791", "14654003", "14654004", "14654005", "14996001", "14996002", "14996003", "800", "801", "802", "803", "804", "805" ], "type": "string", "description": "Limit keyword searches to one Kijiji category. Pick a category without a keyword to scrape everything in it.", "default": "" }, "location": { "title": "Location", "enum": [ "0", "9003", "1700234", "1700199", "1700202", "1700203", "1700205", "1700204", "1700232", "1700233", "1700230", "1700095", "1700231", "1700136", "9007", "1700296", "1700307", "1700306", "1700305", "1700298", "1700316", "1700315", "1700300", "1700224", "1700139", "1700140", "1700141", "1700320", "1700319", "80003", "1700286", "1700285", "1700292", "1700289", "1700288", "1700290", "1700291", "1700287", "1700227", "1700228", "1700246", "1700263", "1700226", "1700295", "1700304", "1700303", "1700299", "1700317", "1700318", "1700301", "1700294", "1700143", "1700302", "1700297", "1700314", "1700313", "1700310", "1700308", "1700311", "1700309", "1700312", "1700293", "1700229", "1700173", "1700100", "9006", "1700085", "1700086", "1700323", "1700087", "1700324", "1700236", "1700235", "1700192", "9005", "1700260", "1700261", "1700018", "1700262", "1700001", "80017", "9008", "1700254", "1700255", "1700044", "1700045", "1700046", "1700113", "9002", "1700256", "1700257", "1700011", "80010", "1700107", "1700321", "1700108", "1700109", "1700258", "1700047", "1700259", "9004", "1700006", "1700129", "1700130", "1700132", "1700206", "1700247", "1700239", "1700133", "1700242", "80014", "1700237", "1700249", "1700181", "1700183", "1700182", "1700209", "1700210", "1700212", "1700213", "1700240", "1700214", "1700078", "1700248", "1700243", "1700184", "1700186", "1700185", "1700187", "1700217", "1700219", "1700218", "1700074", "1700075", "1700076", "1700077", "1700189", "1700190", "1700191", "1700244", "80016", "1700245", "1700126", "1700238", "1700272", "1700273", "1700274", "1700276", "1700277", "1700275", "1700220", "1700241", "9011", "1700118", "1700119", "1700120", "9001", "1700059", "1700060", "1700061", "1700251", "1700121", "1700122", "1700123", "1700062", "1700063", "1700065", "1700064", "1700284", "1700066", "1700253", "80002", "1700281", "1700278", "1700279", "1700280", "1700283", "1700282", "1700147", "1700148", "1700150", "1700124", "1700250", "1700178", "1700180", "1700179", "1700151", "1700252", "1700071", "1700156", "9009", "1700322", "1700265", "1700264", "1700266", "1700088", "1700194", "1700195", "1700196", "1700197", "1700093", "9010", "1700103", "1700104", "1700105", "1700106", "1700101", "1700102" ], "type": "string", "description": "Province, region or city to search in. Kijiji includes the smaller towns of a region in its results.", "default": "0" }, "startUrls": { "title": "Kijiji URLs", "type": "array", "description": "Paste Kijiji.ca URLs: search or category result pages (with any filters you set on the site), single listing pages (/v-...), or seller and dealer profiles (/o-...). Search URLs keep their own filters and sort order.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "minPrice": { "title": "Min price (CAD)", "minimum": 0, "type": "integer", "description": "Only listings priced at or above this amount in Canadian dollars. Listings without a price (Please contact, Swap/Trade) are left out when a price filter is set. Applies to keyword searches; for pasted URLs, set the price filter on Kijiji before copying the URL." }, "maxPrice": { "title": "Max price (CAD)", "minimum": 0, "type": "integer", "description": "Only listings priced at or below this amount in Canadian dollars. Applies to keyword searches." }, "sellerType": { "title": "Posted by", "enum": [ "", "private", "business" ], "type": "string", "description": "Keep only listings from private sellers (owners) or from businesses (dealers, agents, professional employers). Kijiji filters this itself in Buy & Sell, Cars & Vehicles, rentals and Jobs; for other searches and pasted URLs the Actor keeps only listings whose seller type it can identify as a match.", "default": "" }, "sortBy": { "title": "Sort by", "enum": [ "newest", "oldest", "price_asc", "price_desc", "relevance" ], "type": "string", "description": "Order of the results for keyword searches. Pasted URLs keep their own sort order. Relevance needs a keyword.", "default": "newest" }, "maxItems": { "title": "Max listings", "minimum": 1, "type": "integer", "description": "Maximum number of listings to save in total, shared across all keywords and URLs. Kijiji shows at most 4,000 listings per search; ask for more and the Actor splits the search into price ranges to go past that limit.", "default": 100 }, "scrapeDetails": { "title": "Scrape listing details", "type": "boolean", "description": "Add each listing's full description, all photos, seller name and profile, dealer website, listing status and expiry date, market average price and mileage rating for vehicles. Uses one extra request per 20 listings.", "default": false }, "includeTopAds": { "title": "Include Top Ads", "type": "boolean", "description": "Also save the paid Top Ads Kijiji shows above the regular results. They repeat on every page and do not always match your filters.", "default": false }, "language": { "title": "Language", "enum": [ "en", "fr" ], "type": "string", "description": "Language of Kijiji's labels in the output (category, location, condition, transmission and similar values) and of listing URLs. Listing titles and descriptions stay in the language the seller wrote them.", "default": "en" }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Kijiji works without a proxy. If requests get refused, the Actor moves to Apify datacenter and then Canadian residential proxy on its own.", "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 }, "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 } } } } } } } } } }