{
"openapi": "3.0.1",
"info": {
"title": "99.co Property Scraper — Singapore Listings & Agent Leads",
"description": "Scrape Singapore property from 99.co — HDB, condos, landed & commercial, for sale or rent. Get prices, PSF, beds, floor area, tenure, MRT distance, geo-coordinates, photos plus the listing agent name, phone & WhatsApp. Monitoring mode returns only new listings. Export to JSON, CSV, Excel.",
"version": "1.0",
"x-build-id": "y5DKiAugUxRq6KYAb"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/scrapesage~99-co-property-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-scrapesage-99-co-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/scrapesage~99-co-property-scraper/runs": {
"post": {
"operationId": "runs-sync-scrapesage-99-co-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/scrapesage~99-co-property-scraper/run-sync": {
"post": {
"operationId": "run-sync-scrapesage-99-co-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": {
"searchUrls": {
"title": "99.co search URLs",
"type": "array",
"description": "One or more 99.co search/listing pages. Open 99.co, apply any filters you like (location, district, MRT, price, bedrooms, property type, freehold, etc.), then paste the resulting URL here — the scraper reproduces that exact search and paginates through every page. Examples: https://www.99.co/singapore/sale, https://www.99.co/singapore/rent/hdb, https://www.99.co/singapore/sale/condos-apartments?price_max=2000000&num_beds=3. Leave empty to use the simple search builder below.",
"items": {
"type": "string"
}
},
"listingType": {
"title": "Sale or rent (search builder)",
"enum": [
"sale",
"rent"
],
"type": "string",
"description": "Used only when no search URLs are provided above. Build a basic island-wide search.",
"default": "sale"
},
"propertyType": {
"title": "Property type (search builder)",
"enum": [
"any",
"hdb",
"condo",
"landed",
"ec",
"room",
"commercial"
],
"type": "string",
"description": "Used only when no search URLs are provided above.",
"default": "any"
},
"sortBy": {
"title": "Sort results by",
"enum": [
"relevance",
"recency",
"price_low",
"price_high"
],
"type": "string",
"description": "How 99.co orders the results. Choose Newest first for monitoring runs so the freshest listings come first.",
"default": "relevance"
},
"maxResults": {
"title": "Max results per search",
"minimum": 0,
"type": "integer",
"description": "Maximum number of listings to scrape per search URL. Set 0 for no limit (scrapes every available page — can be tens of thousands of listings). 99.co caps deep pagination, so very large searches stop when no more pages are returned.",
"default": 200
},
"monitoringMode": {
"title": "Monitoring mode — only new listings",
"type": "boolean",
"description": "Remember which listings were returned on previous runs (per search) and output only listings that are new since the last run. Combine with Apify Schedules and Newest first sorting to get a clean feed of just-listed properties. This is purely a result filter — it does not keep the Actor running, so it never conflicts with the Apify scheduler.",
"default": false
},
"includeAgentContacts": {
"title": "Include agent contact details",
"type": "boolean",
"description": "Include the listing agent's name, phone and WhatsApp number (as publicly shown on each 99.co listing) so results double as ready-to-contact agent leads. Turn off to exclude all agent personal data.",
"default": true
},
"maxConcurrency": {
"title": "Max concurrency",
"minimum": 1,
"maximum": 20,
"type": "integer",
"description": "Maximum number of pages fetched in parallel.",
"default": 5
},
"proxyConfiguration": {
"title": "Proxy configuration",
"type": "object",
"description": "99.co is served from Singapore and protected by Cloudflare, so a Singapore residential proxy is required for reliable results. The default below is recommended; do not disable it.",
"default": {
"useApifyProxy": true,
"apifyProxyGroups": [
"RESIDENTIAL"
],
"apifyProxyCountry": "SG"
}
}
}
},
"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
}
}
}
}
}
}
}
}
}
}