{ "openapi": "3.0.1", "info": { "title": "Jiji Tanzania Property Scraper - Real Estate Listings", "description": "Scrape property ads from Jiji.co.tz, Tanzania's biggest classifieds site: houses and apartments for rent or sale, land and plots, shops and offices, by region, district or neighbourhood. Rows carry the price in TSh, size, rooms, agent or owner, and photos.", "version": "1.0", "x-build-id": "KJkHw9Q7ggNhtH7f1" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/sian.agency~jiji-tz-property-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-sian.agency-jiji-tz-property-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/sian.agency~jiji-tz-property-scraper/runs": { "post": { "operationId": "runs-sync-sian.agency-jiji-tz-property-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/sian.agency~jiji-tz-property-scraper/run-sync": { "post": { "operationId": "run-sync-sian.agency-jiji-tz-property-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": { "operation": { "title": "🎯 What do you want to scrape?", "enum": [ "search", "detail" ], "type": "string", "description": "Search returns Jiji Tanzania property ads for the regions, districts or neighbourhoods you name, newest first. Listing Details opens Jiji ad addresses you already have and returns the full record. Tick Add full details on a search to get both in one run.", "default": "search" }, "locations": { "title": "📍 Regions, districts or neighbourhoods", "type": "array", "description": "Places in Tanzania, one per line: a region such as Dar es Salaam, Arusha, Mwanza or Dodoma, a district such as Kinondoni or Temeke, or a neighbourhood such as Mbezi Beach, Masaki or Ada Estate. Use Tanzania for the whole country. Each one runs its own search. A name Jiji doesn't list gets an error row and isn't charged.", "default": [ "Dar es Salaam" ], "items": { "type": "string" } }, "category": { "title": "🏠 Property category", "enum": [ "any", "houseRent", "houseSale", "landSale", "landRent", "commercialRent", "commercialSale", "shortLet", "eventVenue", "newBuilds" ], "type": "string", "description": "Which Jiji Property section to search. Rentals are the biggest, about four in ten property ads, then land for sale and houses for sale.", "default": "houseRent" }, "maxResults": { "title": "🔢 Max listings", "minimum": 1, "maximum": 30000, "type": "integer", "description": "Stop after this many listings across all places. The run stops exactly at this number. Free accounts stop at 25. Results come newest first. Listing Details ignores it and returns every ad you pasted.", "default": 100 }, "includeDetails": { "title": "📄 Add full details", "type": "boolean", "description": "Opens each ad's own page and adds the full description, property type, condition, facilities, toilets, posting and update dates, views, saves, price per m² and full-size photos. Each listing also bills one Listing Details event.", "default": false }, "minPrice": { "title": "💵 Min price (TSh)", "minimum": 0, "type": "integer", "description": "Lowest price in Tanzanian shillings. For rentals this is the rent as the seller priced it, usually per month." }, "maxPrice": { "title": "💰 Max price (TSh)", "minimum": 0, "type": "integer", "description": "Highest price in Tanzanian shillings. Leave it empty for no ceiling." }, "bedrooms": { "title": "🛏️ Bedrooms", "minimum": 1, "maximum": 12, "type": "integer", "description": "Only ads with exactly this many bedrooms. Applies to houses, apartments and short lets; leave it empty for land and commercial property." }, "listingUrls": { "title": "📄 Listing URLs", "type": "array", "description": "Jiji Tanzania ad addresses, one per line, such as https://jiji.co.tz/ada-estate/houses-apartments-for-rent/furnished-2bdrm-apartment-in-coolest-agent-ada-estate-for-rent-2HTq2OapQhYA6xnS8rNUQYk.html", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } } } }, "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 } } } } } } } } } }