# Careforkids AU Scraper (`abotapi/careforkids-com-au-scraper`) Actor

Scrape Australia’s largest childcare directory with long day care, preschool, family day care, OSHC, and vacation care services. Returns centre profiles with address, fees, ratings, vacancies, features, images, and ACECQA approval numbers.

- **URL**: https://apify.com/abotapi/careforkids-com-au-scraper.md
- **Developed by:** [AbotAPI](https://apify.com/abotapi) (community)
- **Categories:** Lead generation, Automation, Developer tools
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.00 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).


# README

## CareForKids.com.au Childcare Scraper

Scrape Australia's largest childcare directory: long day care, family day care, preschool, occasional care, before-school, after-school, and vacation care services. Returns full centre profiles with name, address, GPS, phone, daily fees, NQS rating, parent ratings, vacancies by day-of-week, age-group fee bands, services and features, gallery images, contact name and hours, social URLs, provider group, and the official ACECQA service approval number.

### Why this scraper

- **45+ fields per centre**, including precise GPS, phone, full fee table by age band, vacancy schedule per day-of-week, NQS quality area ratings (all 7 areas), gallery images, parent reviews, and the ACECQA service approval number.
- **Two input modes**: Search builder (suburbs + postcodes + care types) or URL paste (any careforkids.com.au URL). Add the `reviewsOnly` toggle to flip the output shape from one row per centre to one row per parent review.
- **Multi care-type fan-out**: pick `["longdaycare", "preschool"]` and the scraper runs both for every suburb you list.
- **Detail enrichment optional**: SERP cards already carry 25+ fields; flip `fetchDetails` ON for the full provider profile + top 10 parent reviews.
- **Datacenter-friendly**: works on the free Apify plan with the default Datacenter proxy; residential AU is optional for higher volume.
- **Single SERP per locality**: each suburb + postcode page returns every centre in that postcode (typically 5 to 50). No pagination to walk.

### Data You Get

> Sample shape, values are illustrative placeholders, not from a live listing.

| Field | Example |
|---|---|
| id | `00000` |
| url | `https://www.careforkids.com.au/child-care/00000/sample-centre-suburb-2000` |
| name | `Sample Childcare Centre` |
| suburb | `Sample Suburb` |
| postcode | `2000` |
| state | `NSW` |
| address | `Sample Address, Sample Suburb, NSW` |
| latitude | `-33.0000` |
| longitude | `151.0000` |
| phone | `+61200000000` |
| rating | `4.5` |
| reviewCount | `0` |
| dailyFee | `200` |
| hasVacancies | `true` |
| isVerified | `true` |
| listingType | `Premium` |
| careTypes | `["Long Day Care", "Preschool"]` |
| requestedCareType | `longdaycare` |
| services | `["Meals Provided", "Nappies & Wipes Supplied", "SunSmart Aware"]` |
| nqsRating | `Meeting` |
| hoursSummary | `7:30am to 6:00pm` |
| logoUrl | `https://img-service-cdn-...azurewebsites.net/api/img?type=UserPhoto&id=0` |
| description | `Full provider description text appears here when fetchDetails=true.` |
| contactName | `Sample Contact, Director` |
| contactTime | `7:30am to 6:00pm` |
| websiteUrl | `https://www.example.com/sample-centre` |
| facebookUrl | `https://www.facebook.com/sample` |
| instagramUrl | `https://www.instagram.com/sample` |
| serviceApprovalNumber | `SE-00000000` |
| approvedPlaces | `90` |
| nqsRatingOverall | `Meeting` |
| nqsRatingLabel | `Meeting National Quality Standard` |
| nqsAreaRatings | `["Meeting NQS", "Meeting NQS", ...]` (7 areas) |
| providerGroup | `Sample Provider Group` |
| googlePlaceId | `ChIJ0000000000` |
| galleryImageUrls | `[...image URLs...]` |
| feeGroups | `[{careType: "Long Day Care", fees: [{fromYears, toYears, maxPrice, ...}]}]` |
| vacancies | `[{careType, ageGroup, daysOfWeek: [bool x 7], ...}]` |
| highlights | `Pipe-separated highlight bullets` |
| hasWaitlist | `false` |
| dailyAverageFee | `200` |
| ratingC4k / ratingGoogle | `4.5 / 4.8` |
| reviewCountC4k / reviewCountGoogle | `0 / 0` |
| scrapedAt | `2026-01-01T00:00:00.000Z` |

### How to Use

#### Search by suburb + postcode

```json
{
  "mode": "search",
  "locations": [
    { "suburb": "Sydney", "postcode": "2000" }
  ],
  "careTypes": ["all"],
  "fetchDetails": false,
  "maxListings": 50
}
````

#### Search multiple suburbs and care types

```json
{
  "mode": "search",
  "locations": [
    { "suburb": "Surry Hills", "postcode": "2010" },
    { "suburb": "Bondi", "postcode": "2026" },
    { "suburb": "Manly", "postcode": "2095" }
  ],
  "careTypes": ["longdaycare", "preschool"],
  "vacanciesOnly": true,
  "fetchDetails": true
}
```

#### URL mode (paste any careforkids URL)

```json
{
  "mode": "url",
  "urls": [
    "https://www.careforkids.com.au/child-care/sydney/2000",
    "https://www.careforkids.com.au/family-day-care/melbourne/3000",
    "https://www.careforkids.com.au/child-care/00000/sample-centre-detail-page"
  ],
  "fetchDetails": true
}
```

#### Detail-only single fetch

```json
{
  "mode": "url",
  "urls": ["https://www.careforkids.com.au/child-care/00000/sample-centre-suburb-2000"],
  "fetchDetails": true,
  "maxListings": 1
}
```

#### Reviews-only output (one record per parent review)

Set `reviewsOnly: true` and the dataset becomes ONE row per review (reviewer name, rating, date, full text, source, avatar URL) with centre context fields (centreId, centreName, suburb, postcode, state, GPS) attached to each row. The site renders the top 10 reviews in the SSR HTML. Pairs with either Search or URL mode.

```json
{
  "mode": "search",
  "locations": [{ "suburb": "Sydney", "postcode": "2000" }],
  "careTypes": ["all"],
  "reviewsOnly": true,
  "maxListings": 50,
  "maxReviewsPerCentre": 10
}
```

Or pull reviews for specific centres via URL list:

```json
{
  "mode": "url",
  "urls": [
    "https://www.careforkids.com.au/child-care/00000/sample-centre-a-suburb-2000",
    "https://www.careforkids.com.au/child-care/00001/sample-centre-b-suburb-2010"
  ],
  "reviewsOnly": true,
  "maxReviewsPerCentre": 10
}
```

### Input Parameters

| Parameter | Type | Default | Description |
|---|---|---|---|
| `mode` | string | `search` | `search` builds URLs from `locations` and `careTypes`; `url` passes through `urls` directly. |
| `reviewsOnly` | boolean | `false` | When ON, emit one row per parent review instead of one per centre. Forces detail-page fetch internally. Pairs with either Search or URL mode. |
| `locations` | array | Sydney 2000 | Each entry is `{ "suburb": "...", "postcode": "0000" }`. Suburb name is slugified automatically. Multiple locations supported. |
| `careTypes` | array | `["all"]` | Service types to search. `all` fetches every type at once. Multi-select supported: each (location × type) becomes a separate fetch. |
| `verifiedOnly` | boolean | `false` | Drop centres not flagged as verified by careforkids.com.au. |
| `vacanciesOnly` | boolean | `false` | Drop centres reporting no current vacancies. |
| `minRating` | integer | (off) | Minimum 1-5 parent rating. Centres without a rating are kept. |
| `maxDailyFee` | integer | (off) | Maximum advertised average daily fee in AUD. Centres without an advertised fee are kept. |
| `urls` | array | (one example) | URL mode only. Paste any careforkids.com.au URL: search SERP, care-type-filtered SERP, or single-centre detail page. |
| `maxListings` | integer | `0` (no cap) | Hard cap across all searches. |
| `fetchDetails` | boolean | `false` | When ON, fetch each centre's profile page for description, full fee schedule by age band, vacancy schedule per day, NQS area ratings, gallery, contact name + hours, website + socials, ACECQA service approval number, and top 10 parent reviews. |
| `maxReviewsPerCentre` | integer | `0` (no cap) | Reviews mode only. Cap reviews emitted per centre. The site renders the top 10 in SSR; setting above 10 has no effect. |
| `proxy` | object | Apify Datacenter | Free plans get the default Datacenter group. For higher volume, switch to `groups: ["RESIDENTIAL"], country: "AU"`. |

### Output Example

> Sample shape, values are illustrative placeholders, not from a live listing.

```json
{
  "id": "00000",
  "url": "https://www.careforkids.com.au/child-care/00000/sample-centre-suburb-2000",
  "name": "Sample Childcare Centre",
  "suburb": "Sample Suburb",
  "postcode": "2000",
  "state": "NSW",
  "address": "Sample Address, Sample Suburb, NSW",
  "latitude": -33.0000,
  "longitude": 151.0000,
  "phone": "+61200000000",
  "rating": 4.5,
  "reviewCount": 0,
  "dailyFee": 200,
  "hasVacancies": true,
  "isVerified": true,
  "listingType": "Premium",
  "careTypes": ["Long Day Care"],
  "requestedCareType": "longdaycare",
  "services": ["Meals Provided", "Nappies & Wipes Supplied"],
  "nqsRating": "Meeting",
  "nqsRatingOverall": "Meeting",
  "nqsRatingLabel": "Meeting National Quality Standard",
  "nqsAreaRatings": [
    "Meeting NQS", "Meeting NQS", "Meeting NQS",
    "Meeting NQS", "Meeting NQS", "Meeting NQS", "Meeting NQS"
  ],
  "providerGroup": "Sample Provider Group",
  "googlePlaceId": "ChIJ0000000000",
  "logoUrl": "https://img-service-cdn-h2avfjg4bcb8a0gw.australiaeast-01.azurewebsites.net/api/img?type=UserPhoto&id=0",
  "galleryImageUrls": [
    "https://img-service-cdn-h2avfjg4bcb8a0gw.australiaeast-01.azurewebsites.net/api/img?type=UserImage&id=00001",
    "https://img-service-cdn-h2avfjg4bcb8a0gw.australiaeast-01.azurewebsites.net/api/img?type=UserImage&id=00002"
  ],
  "feeGroups": [
    {
      "careType": "Long Day Care",
      "fees": [
        { "fromWeeks": 6, "toYears": 2, "maxPrice": 200, "feeTypeDisplay": "/day" },
        { "fromYears": 2, "toYears": 5, "maxPrice": 200, "feeTypeDisplay": "/day" }
      ]
    }
  ],
  "vacancies": [
    {
      "careType": "Long Day Care",
      "ageGroup": "6 wks to 2 yrs",
      "ageGroupLabel": "Babies",
      "daysOfWeek": [false, true, true, true, true, true, false]
    }
  ],
  "serviceExtras": [
    { "id": 1, "name": "Allergy & Anaphylaxis Aware", "iconId": "allergy-aware" }
  ],
  "highlights": "Sample highlight bullet|Another sample bullet|Final sample bullet",
  "hasWaitlist": false,
  "dailyAverageFee": 200,
  "approvedPlaces": 90,
  "serviceApprovalNumber": "SE-00000000",
  "contactName": "Sample Contact, Director",
  "contactTime": "7:30am to 6:00pm",
  "websiteUrl": "https://www.example.com/sample",
  "facebookUrl": "https://www.facebook.com/sample",
  "instagramUrl": "https://www.instagram.com/sample",
  "scrapedAt": "2026-01-01T00:00:00.000Z"
}
```

### Plan Requirement

- **Free plan**: works with the default Apify Datacenter proxy (no group). Most suburbs return all centres on the first request.
- **Starter and above**: switch to residential AU (`groups: ["RESIDENTIAL"], country: "AU"`) for stable rotation under high volume or repeated runs.
- **Geo**: the source is Australia-only. Datacenter US works for the directory pages because the upstream edge accepts a warmed cookie session.

# Actor input Schema

## `mode` (type: `string`):

Search mode = pick suburbs/postcodes + care types below. URL mode = paste any careforkids.com.au URL straight from a browser.

## `locations` (type: `array`):

One or more {suburb, postcode} pairs. Each pair becomes a SERP page on careforkids.com.au. Suburb names are slugified automatically ("Surry Hills" → "surry-hills"). Postcode is the 4-digit Australian postcode. Examples: {"suburb":"Sydney","postcode":"2000"} or {"suburb":"Melbourne","postcode":"3000"}.

## `careTypes` (type: `array`):

Filter by childcare service type. Each (location × type) pair becomes a separate SERP fetch. Pick "all" to grab every service in a suburb in one fetch (covers all the types below). Default "all" returns every centre advertising any of the seven care types.

## `verifiedOnly` (type: `boolean`):

Drop cards where the centre is not flagged as verified by careforkids.com.au. Applied client-side after fetch.

## `vacanciesOnly` (type: `boolean`):

Drop cards that report no current vacancies. Applied client-side after fetch.

## `minRating` (type: `integer`):

Drop cards rated below this 1-5 score (applied client-side after fetch). Centres with no rating are kept.

## `maxDailyFee` (type: `integer`):

Drop cards with an advertised average daily fee above this amount (applied client-side after fetch). Centres with no advertised fee are kept.

## `urls` (type: `array`):

One or more careforkids.com.au URLs. Examples: https://www.careforkids.com.au/child-care/sydney/2000 (all care types in Sydney CBD), https://www.careforkids.com.au/child-care-centre/melbourne/3000 (long day care in Melbourne CBD), or a single centre detail URL like https://www.careforkids.com.au/child-care/k60qk/ku-phillip-park-childrens-centre-woolloomooloo-2011. Multi-URL supported. Filter fields above (verifiedOnly, vacanciesOnly, minRating, maxDailyFee) still apply.

## `maxListings` (type: `integer`):

Stop after this many centres across all searches. 0 = no cap. Each suburb+postcode page returns roughly 5-50 centres (no pagination, single page exhausts the locality). Default 20 keeps runs bounded; raise it (or set 0) when scraping multiple suburbs.

## `fetchDetails` (type: `boolean`):

When ON, also fetch each centre's profile page for the full fee breakdown by age group, vacancy availability per day, NQS quality area ratings, gallery image URLs, contact name, contact hours, website + social links, service approval number, full feature list, and the top 10 parent reviews. SERP cards already include name, address, GPS, phone, rating, average fee, vacancies, and abbreviated feature list, so simple feeds work fine with this OFF. Forced ON when Reviews-only output is enabled.

## `reviewsOnly` (type: `boolean`):

When ON, the dataset becomes one row per parent review (reviewer name, rating, date, full text, source, avatar) with centre context attached (centreId, centreName, suburb, postcode, state, GPS) instead of one row per centre. Pairs with either Search or URL mode. The site renders the top ~10 reviews in SSR per centre.

## `maxReviewsPerCentre` (type: `integer`):

Only used when Reviews-only output is ON. Cap how many reviews to emit per centre. The site renders the top 10 reviews in SSR; setting this above 10 has no effect. 0 = no cap (default).

## `proxy` (type: `object`):

CareForKids.com.au accepts naked Apify proxy out of the box, including the default Datacenter group available on Free plans. For higher volume or stable Australian routing, add groups: \["RESIDENTIAL"], country: "AU".

## Actor input object example

```json
{
  "mode": "search",
  "locations": [
    {
      "suburb": "Sydney",
      "postcode": "2000"
    }
  ],
  "careTypes": [
    "all"
  ],
  "verifiedOnly": false,
  "vacanciesOnly": false,
  "urls": [
    "https://www.careforkids.com.au/child-care/sydney/2000"
  ],
  "maxListings": 20,
  "fetchDetails": false,
  "reviewsOnly": false,
  "maxReviewsPerCentre": 0,
  "proxy": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

## `overview` (type: `string`):

No description

## `reviews` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "locations": [
        {
            "suburb": "Sydney",
            "postcode": "2000"
        }
    ],
    "urls": [
        "https://www.careforkids.com.au/child-care/sydney/2000"
    ],
    "proxy": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("abotapi/careforkids-com-au-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "locations": [{
            "suburb": "Sydney",
            "postcode": "2000",
        }],
    "urls": ["https://www.careforkids.com.au/child-care/sydney/2000"],
    "proxy": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("abotapi/careforkids-com-au-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "locations": [
    {
      "suburb": "Sydney",
      "postcode": "2000"
    }
  ],
  "urls": [
    "https://www.careforkids.com.au/child-care/sydney/2000"
  ],
  "proxy": {
    "useApifyProxy": true
  }
}' |
apify call abotapi/careforkids-com-au-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=abotapi/careforkids-com-au-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Careforkids AU Scraper",
        "description": "Scrape Australia’s largest childcare directory with long day care, preschool, family day care, OSHC, and vacation care services. Returns centre profiles with address, fees, ratings, vacancies, features, images, and ACECQA approval numbers.",
        "version": "1.0",
        "x-build-id": "EovZ6pJdhlLhKdB7z"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/abotapi~careforkids-com-au-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-abotapi-careforkids-com-au-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/abotapi~careforkids-com-au-scraper/runs": {
            "post": {
                "operationId": "runs-sync-abotapi-careforkids-com-au-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/abotapi~careforkids-com-au-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-abotapi-careforkids-com-au-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": [
                    "mode"
                ],
                "properties": {
                    "mode": {
                        "title": "1. Search mode",
                        "enum": [
                            "search",
                            "url"
                        ],
                        "type": "string",
                        "description": "Search mode = pick suburbs/postcodes + care types below. URL mode = paste any careforkids.com.au URL straight from a browser.",
                        "default": "search"
                    },
                    "locations": {
                        "title": "Suburb + postcode pairs",
                        "type": "array",
                        "description": "One or more {suburb, postcode} pairs. Each pair becomes a SERP page on careforkids.com.au. Suburb names are slugified automatically (\"Surry Hills\" → \"surry-hills\"). Postcode is the 4-digit Australian postcode. Examples: {\"suburb\":\"Sydney\",\"postcode\":\"2000\"} or {\"suburb\":\"Melbourne\",\"postcode\":\"3000\"}.",
                        "items": {
                            "type": "object",
                            "properties": {
                                "suburb": {
                                    "type": "string",
                                    "title": "Suburb",
                                    "description": "Suburb name. Spaces and special characters are slugified automatically."
                                },
                                "postcode": {
                                    "type": "string",
                                    "title": "Postcode",
                                    "description": "4-digit Australian postcode."
                                }
                            },
                            "required": [
                                "suburb",
                                "postcode"
                            ]
                        }
                    },
                    "careTypes": {
                        "title": "Care types",
                        "uniqueItems": true,
                        "type": "array",
                        "description": "Filter by childcare service type. Each (location × type) pair becomes a separate SERP fetch. Pick \"all\" to grab every service in a suburb in one fetch (covers all the types below). Default \"all\" returns every centre advertising any of the seven care types.",
                        "items": {
                            "type": "string",
                            "enum": [
                                "all",
                                "longdaycare",
                                "familydaycare",
                                "occasionalcare",
                                "preschool",
                                "beforeschoolcare",
                                "vacationcare",
                                "afterschoolcare"
                            ],
                            "enumTitles": [
                                "All care types (single fetch per suburb)",
                                "Long Day Care (formal centre)",
                                "Family Day Care (educator at home)",
                                "Occasional Care",
                                "Preschool / Kindergarten",
                                "Before School Care",
                                "Vacation / Holiday Care",
                                "After School Care"
                            ]
                        },
                        "default": [
                            "all"
                        ]
                    },
                    "verifiedOnly": {
                        "title": "Verified centres only (post-filter)",
                        "type": "boolean",
                        "description": "Drop cards where the centre is not flagged as verified by careforkids.com.au. Applied client-side after fetch.",
                        "default": false
                    },
                    "vacanciesOnly": {
                        "title": "Centres with vacancies only (post-filter)",
                        "type": "boolean",
                        "description": "Drop cards that report no current vacancies. Applied client-side after fetch.",
                        "default": false
                    },
                    "minRating": {
                        "title": "Minimum parent rating (post-filter)",
                        "minimum": 1,
                        "maximum": 5,
                        "type": "integer",
                        "description": "Drop cards rated below this 1-5 score (applied client-side after fetch). Centres with no rating are kept."
                    },
                    "maxDailyFee": {
                        "title": "Maximum average daily fee, AUD (post-filter)",
                        "minimum": 50,
                        "maximum": 500,
                        "type": "integer",
                        "description": "Drop cards with an advertised average daily fee above this amount (applied client-side after fetch). Centres with no advertised fee are kept."
                    },
                    "urls": {
                        "title": "Search URLs (URL mode)",
                        "type": "array",
                        "description": "One or more careforkids.com.au URLs. Examples: https://www.careforkids.com.au/child-care/sydney/2000 (all care types in Sydney CBD), https://www.careforkids.com.au/child-care-centre/melbourne/3000 (long day care in Melbourne CBD), or a single centre detail URL like https://www.careforkids.com.au/child-care/k60qk/ku-phillip-park-childrens-centre-woolloomooloo-2011. Multi-URL supported. Filter fields above (verifiedOnly, vacanciesOnly, minRating, maxDailyFee) still apply.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "maxListings": {
                        "title": "Max listings (total)",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Stop after this many centres across all searches. 0 = no cap. Each suburb+postcode page returns roughly 5-50 centres (no pagination, single page exhausts the locality). Default 20 keeps runs bounded; raise it (or set 0) when scraping multiple suburbs.",
                        "default": 20
                    },
                    "fetchDetails": {
                        "title": "Fetch detail pages (richer data)",
                        "type": "boolean",
                        "description": "When ON, also fetch each centre's profile page for the full fee breakdown by age group, vacancy availability per day, NQS quality area ratings, gallery image URLs, contact name, contact hours, website + social links, service approval number, full feature list, and the top 10 parent reviews. SERP cards already include name, address, GPS, phone, rating, average fee, vacancies, and abbreviated feature list, so simple feeds work fine with this OFF. Forced ON when Reviews-only output is enabled.",
                        "default": false
                    },
                    "reviewsOnly": {
                        "title": "Reviews-only output (one record per review)",
                        "type": "boolean",
                        "description": "When ON, the dataset becomes one row per parent review (reviewer name, rating, date, full text, source, avatar) with centre context attached (centreId, centreName, suburb, postcode, state, GPS) instead of one row per centre. Pairs with either Search or URL mode. The site renders the top ~10 reviews in SSR per centre.",
                        "default": false
                    },
                    "maxReviewsPerCentre": {
                        "title": "Max reviews per centre (Reviews-only)",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Only used when Reviews-only output is ON. Cap how many reviews to emit per centre. The site renders the top 10 reviews in SSR; setting this above 10 has no effect. 0 = no cap (default).",
                        "default": 0
                    },
                    "proxy": {
                        "title": "Proxy configuration",
                        "type": "object",
                        "description": "CareForKids.com.au accepts naked Apify proxy out of the box, including the default Datacenter group available on Free plans. For higher volume or stable Australian routing, add groups: [\"RESIDENTIAL\"], country: \"AU\"."
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
