{ "openapi": "3.0.1", "info": { "title": "Jiji Scraper: Africa Classifieds with Deal Scores & Price Drops", "description": "Scrape Jiji classifieds in 13 countries, including Nigeria, Kenya, Ghana, Uganda, Tanzania and Ethiopia. Get cars, phones and property with typed make, year, bedrooms and storage, below-market deal labels, and new, price-drop and removed tracking between runs. No login. Pay per listing.", "version": "0.1", "x-build-id": "xrUWRuDPK4S0wNbXv" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/getascraper~jiji-marketplace-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-getascraper-jiji-marketplace-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/getascraper~jiji-marketplace-scraper/runs": { "post": { "operationId": "runs-sync-getascraper-jiji-marketplace-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/getascraper~jiji-marketplace-scraper/run-sync": { "post": { "operationId": "run-sync-getascraper-jiji-marketplace-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": { "startUrls": { "title": "Jiji pages", "type": "array", "description": "Paste Jiji pages from any covered country: a category, a region, a brand page, a keyword search, a seller shop or a single listing. Filters already applied in the page address are kept. Pages and the pickers below add up when both are filled. Leave every source field empty to read the 20 newest phone ads in Nigeria.", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "countries": { "title": "Countries", "type": "array", "description": "Jiji sites to search. Each country is read through its own local connection. Leave empty to use Nigeria when no page link is given.", "items": { "type": "string", "enum": [ "ng", "ke", "gh", "tz", "ug", "et", "sn", "ci", "cd", "cg", "lk", "al", "mk" ], "enumTitles": [ "Nigeria", "Kenya", "Ghana", "Tanzania", "Uganda", "Ethiopia", "Senegal", "Cote d'Ivoire", "DR Congo", "Congo-Brazzaville", "Sri Lanka", "Albania", "North Macedonia" ] }, "default": [] }, "categories": { "title": "Categories", "type": "array", "description": "Categories to read in every selected country. A category that does not exist on a site is skipped with a note. Leave empty to search all categories.", "items": { "type": "string", "enum": [ "vehicles", "cars", "motorcycles-and-scooters", "car-parts-and-accessories", "trucks-commercial-agricultiral", "buses", "real-estate", "houses-apartments-for-rent", "houses-apartments-for-sale", "land-and-plots-for-sale", "commercial-property-for-rent", "commercial-properties", "mobile-phones-tablets", "mobile-phones", "tablets", "smart-watches", "electronics", "computers-and-laptops", "tv-dvd-equipment", "audio-and-music-equipment", "home-garden", "furniture", "home-appliances", "kitchen-appliances", "fashion-and-beauty", "womens-fashion", "mens-fashion", "shoes", "health-and-beauty", "jobs", "seeking-work-cvs", "services", "animals-and-pets", "babies-and-kids", "repair-and-construction", "agriculture-and-foodstuff", "business-and-industry", "hobbies-art-sport" ], "enumTitles": [ "Vehicles (all)", "Cars", "Motorcycles and scooters", "Vehicle parts and accessories", "Trucks and commercial vehicles", "Buses", "Property (all)", "Houses and apartments for rent", "Houses and apartments for sale", "Land and plots for sale", "Commercial property for rent", "Commercial property for sale", "Phones and tablets (all)", "Mobile phones", "Tablets", "Smart watches", "Electronics (all)", "Computers and laptops", "TV and video equipment", "Audio and music equipment", "Home, furniture and appliances", "Furniture", "Home appliances", "Kitchen appliances", "Fashion (all)", "Women's fashion", "Men's fashion", "Shoes", "Beauty and personal care", "Jobs", "Seeking work (CVs)", "Services", "Animals and pets", "Babies and kids", "Repair and construction", "Food, agriculture and farming", "Business and industry", "Leisure and activities" ] }, "default": [] }, "keywords": { "title": "Keywords", "type": "array", "description": "Search words, for example iphone 13 or toyota camry. Each keyword is searched on its own inside every selected country, category and region. Leave empty to read the whole category.", "default": [], "items": { "type": "string" } }, "sellerIds": { "title": "Seller IDs", "type": "array", "description": "Numeric seller IDs from the sellerId output column. Reads that seller's full inventory, useful for tracking one dealer or shop.", "default": [], "items": { "type": "string" } }, "regions": { "title": "Regions or towns", "type": "array", "description": "Region or town names as they appear in Jiji addresses, for example lagos, abuja, nairobi, accra. Each region is searched on its own.", "default": [], "items": { "type": "string" } }, "priceMin": { "title": "Minimum price", "minimum": 0, "type": "integer", "description": "Lowest price in the local currency of the site, for example 500000 for Nigeria (naira)." }, "priceMax": { "title": "Maximum price", "minimum": 0, "type": "integer", "description": "Highest price in the local currency of the site." }, "postedWithin": { "title": "Posted within", "enum": [ "any", "hour", "day" ], "type": "string", "description": "Keep only listings posted recently. The site offers the last hour and the last 24 hours.", "default": "any" }, "sortBy": { "title": "Sort by", "enum": [ "new", "rel", "price", "price_desc" ], "type": "string", "description": "Order of the results. Newest first is best for fresh leads and for monitoring.", "default": "new" }, "verifiedSellersOnly": { "title": "Verified sellers only", "type": "boolean", "description": "Keep only listings from sellers who verified their identity on Jiji.", "default": false }, "excludePromoted": { "title": "Skip promoted ads", "type": "boolean", "description": "Drop boosted and top-placed ads so that only organic listings are saved.", "default": false }, "brands": { "title": "Make or brand", "type": "array", "description": "Car makes (Toyota, Lexus) or phone brands (Apple, Samsung). Several values are combined. Applies to the Cars and Mobile phones categories.", "default": [], "items": { "type": "string" } }, "models": { "title": "Model", "type": "array", "description": "Models to keep, for example Camry or iPhone 13. Matched against the listing title and model; for cars the site filters by model when a make is also set.", "default": [], "items": { "type": "string" } }, "condition": { "title": "Condition", "type": "array", "description": "Brand new, used or refurbished, as the site words it for the category. Cars use Local Used or Foreign Used, phones use Used or Refurbished, property uses Newly Built or Renovated.", "items": { "type": "string", "enum": [ "Brand New", "Foreign Used", "Local Used", "Used", "Refurbished", "Newly Built", "Fairly Used", "Renovated", "Old" ], "enumTitles": [ "Brand New", "Foreign Used", "Local Used", "Used", "Refurbished", "Newly Built", "Fairly Used", "Renovated", "Old" ] }, "default": [] }, "yearMin": { "title": "Earliest year", "minimum": 1950, "maximum": 2100, "type": "integer", "description": "Oldest model year for cars." }, "yearMax": { "title": "Latest year", "minimum": 1950, "maximum": 2100, "type": "integer", "description": "Newest model year for cars." }, "maxMileageKm": { "title": "Maximum mileage (km)", "minimum": 0, "type": "integer", "description": "Highest odometer reading in kilometres for cars." }, "transmissions": { "title": "Transmission", "type": "array", "description": "Gearbox type for cars.", "items": { "type": "string", "enum": [ "Automatic", "Manual", "CVT", "AMT" ], "enumTitles": [ "Automatic", "Manual", "CVT", "AMT" ] }, "default": [] }, "fuelTypes": { "title": "Fuel", "type": "array", "description": "Fuel type for cars.", "items": { "type": "string", "enum": [ "Petrol", "Diesel", "CNG" ], "enumTitles": [ "Petrol", "Diesel", "CNG" ] }, "default": [] }, "bedrooms": { "title": "Bedrooms", "type": "array", "description": "Number of bedrooms for houses and apartments. Several values are combined.", "items": { "type": "string", "enum": [ "1", "2", "3", "4", "5", "6", "7", "8" ], "enumTitles": [ "1 bedroom", "2 bedrooms", "3 bedrooms", "4 bedrooms", "5 bedrooms", "6 bedrooms", "7 bedrooms", "8 bedrooms" ] }, "default": [] }, "bathrooms": { "title": "Bathrooms", "type": "array", "description": "Number of bathrooms for houses and apartments.", "items": { "type": "string", "enum": [ "1", "2", "3", "4", "5", "6" ], "enumTitles": [ "1 bathroom", "2 bathrooms", "3 bathrooms", "4 bathrooms", "5 bathrooms", "6 bathrooms" ] }, "default": [] }, "furnishing": { "title": "Furnishing", "type": "array", "description": "Furnishing level for property.", "items": { "type": "string", "enum": [ "Furnished", "Semi-Furnished", "Unfurnished" ], "enumTitles": [ "Furnished", "Semi-Furnished", "Unfurnished" ] }, "default": [] }, "propertyTypes": { "title": "Property type", "type": "array", "description": "Kind of property for houses and apartments.", "items": { "type": "string", "enum": [ "Apartment", "Bedsitter", "Block of Flats", "Bungalow", "Chalet", "Condo", "Duplex", "Farm House", "House", "Maisonette", "Mansion", "Mini Flat", "Penthouse", "Room & Parlour", "Shared Apartment", "Studio Apartment", "Townhouse / Terrace", "Villa" ], "enumTitles": [ "Apartment", "Bedsitter", "Block of Flats", "Bungalow", "Chalet", "Condo", "Duplex", "Farm House", "House", "Maisonette", "Mansion", "Mini Flat", "Penthouse", "Room & Parlour", "Shared Apartment", "Studio Apartment", "Townhouse / Terrace", "Villa" ] }, "default": [] }, "storage": { "title": "Phone storage", "type": "array", "description": "Internal storage for phones.", "items": { "type": "string", "enum": [ "16 GB", "32 GB", "64 GB", "128 GB", "256 GB", "512 GB", "1 TB", "2 TB" ], "enumTitles": [ "16 GB", "32 GB", "64 GB", "128 GB", "256 GB", "512 GB", "1 TB", "2 TB" ] }, "default": [] }, "ram": { "title": "Phone memory (RAM)", "type": "array", "description": "Memory size for phones.", "items": { "type": "string", "enum": [ "2 GB", "3 GB", "4 GB", "6 GB", "8 GB", "12 GB", "16 GB" ], "enumTitles": [ "2 GB", "3 GB", "4 GB", "6 GB", "8 GB", "12 GB", "16 GB" ] }, "default": [] }, "siteFilters": { "title": "Raw Jiji filters", "type": "array", "description": "Advanced. Any filter from a Jiji address as name and value, for example filter_attr_88_colour = Black. Apply the filters on Jiji, copy the address and paste it above, or copy the parameters here.", "default": [], "items": { "type": "object", "required": [ "key", "value" ], "properties": { "key": { "type": "string", "title": "Key" }, "value": { "type": "string", "title": "Value" } } } }, "includeDetails": { "title": "Open each listing for full details", "type": "boolean", "description": "Adds post date, renewal date, views, favourites, the full description, all photos, Jiji's own fair-price range and the seller profile. Billed as an extra event per listing and slower.", "default": false }, "includeSellerContact": { "title": "Include seller phone and WhatsApp when shown", "type": "boolean", "description": "Needs the full details option. Adds the seller phone number and WhatsApp link only when Jiji shows them to anonymous visitors. Many listings have none, and the Actor never logs in to reveal numbers.", "default": false }, "addUsdPrice": { "title": "Add US dollar price", "type": "boolean", "description": "Converts each price to US dollars with a free public daily exchange rate and adds the rate and its date. Rows keep no dollar value when no rate source answers.", "default": false }, "maxItems": { "title": "Max results", "minimum": 1, "maximum": 30000, "type": "integer", "description": "Total listings saved in this run, shared fairly across all searches. Searches larger than the site serves in one go are split by price band automatically.", "default": 20 }, "dedupeRelisted": { "title": "Merge re-posted ads", "type": "boolean", "description": "Collapses ads that the same seller posted again with the same title and price into one row with a duplicateCount.", "default": true }, "monitorName": { "title": "Monitor name", "type": "string", "description": "Give the search a name to track it between runs. The next run labels each listing NEW, PRICE_DROP, PRICE_UP, RENEWED (needs full details), UPDATED, UNCHANGED or REMOVED and keeps price history. Reuse the same name on a schedule." }, "onlyChanges": { "title": "Save only changes", "type": "boolean", "description": "With a monitor name, save only new, changed and removed listings and skip unchanged ones.", "default": 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 } } } } } } } } } }