{ "openapi": "3.0.1", "info": { "title": "Sittercity Caregiver Listings Scraper", "description": "Scrape Sittercity city/state caregiver listings - babysitters, nannies, child care, companion/senior care, pet care, and special needs caregivers. Get names, rates, experience, ratings, reviews, and trust & safety badges. No auth, no proxy needed.", "version": "1.0", "x-build-id": "e05GaalFjXi66EVnu" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlerbros~sittercity-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlerbros-sittercity-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/crawlerbros~sittercity-scraper/runs": { "post": { "operationId": "runs-sync-crawlerbros-sittercity-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/crawlerbros~sittercity-scraper/run-sync": { "post": { "operationId": "run-sync-crawlerbros-sittercity-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": "Caregiver category", "enum": [ "babysitters", "nannies", "childCare", "companionCare", "petSitting", "specialNeeds", "babysittingJobs", "nannyJobs", "petSittingJobs", "companionCareJobs", "specialNeedsJobs", "housekeepingJobs", "advancedSearch", "discoverCities" ], "type": "string", "description": "Which Sittercity caregiver listing category to scrape. Pick \"Discover Cities\" to enumerate valid city/state combinations from Sittercity's public sitemap instead of scraping caregivers.", "default": "babysitters" }, "discoverCategory": { "title": "Category to discover cities for", "enum": [ "babysitters", "nannies", "childCare", "companionCare", "petSitting", "specialNeeds", "babysittingJobs", "nannyJobs", "petSittingJobs", "companionCareJobs", "specialNeedsJobs" ], "type": "string", "description": "Only used when `mode` is \"Discover Cities\". Which category's valid city/state listing pages to enumerate from Sittercity's sitemap — either a caregiver-listing category or a job-postings category (both have real, distinct sitemap-listed city pages).", "default": "babysitters" }, "searchCategory": { "title": "Category (Advanced Search)", "enum": [ "babysitters", "nannies", "childCare", "companionCare", "petSitting", "specialNeeds" ], "type": "string", "description": "Only used when `mode` is \"Advanced Search\". Which caregiver category to search for. Advanced Search hits Sittercity's real full-database search endpoint (ZIP + radius based) rather than a curated top-N city landing page, so it returns the true full result count with real pagination and real server-side filters.", "default": "babysitters" }, "zipCode": { "title": "ZIP code (Advanced Search, required for this mode)", "type": "string", "description": "5-digit US ZIP code to search near. Only used (and required) when `mode` is \"Advanced Search\", e.g. \"48228\".", "default": "" }, "searchDistance": { "title": "Search radius, miles (Advanced Search)", "enum": [ "1", "2", "5", "10", "15", "25", "40", "50" ], "type": "string", "description": "Only used when `mode` is \"Advanced Search\". Maximum distance from `zipCode` to search.", "default": "25" }, "rateFacet": { "title": "Hourly rate filter (Advanced Search)", "enum": [ "", "11-15", "16-20", "21-30", "31-40", "40+" ], "type": "string", "description": "Only used when `mode` is \"Advanced Search\". Filter caregivers by their listed hourly rate range. Not reliably supported upstream for the Babysitters category — silently ignored (with a status-message note) if combined with `searchCategory: \"babysitters\"`.", "default": "" }, "backgroundCheckFacet": { "title": "Background check filter (Advanced Search)", "enum": [ "", "any", "basic_criminal", "enhanced_criminal", "motor_vehicle" ], "type": "string", "description": "Only used when `mode` is \"Advanced Search\". Filter to caregivers with a completed background check of this level.", "default": "" }, "yearsExperienceFacet": { "title": "Years experience filter (Advanced Search)", "enum": [ "", "1-2", "3-5", "6-10", "11+" ], "type": "string", "description": "Only used when `mode` is \"Advanced Search\". Filter caregivers by years of paid experience.", "default": "" }, "lastLoginFacet": { "title": "Recently active filter (Advanced Search)", "enum": [ "", "one_week", "two_weeks", "one_month", "three_months" ], "type": "string", "description": "Only used when `mode` is \"Advanced Search\". Filter to caregivers who last logged in within this window.", "default": "" }, "languageFacet": { "title": "Language spoken filter (Advanced Search)", "enum": [ "", "american_sign_language", "arabic", "armenian", "bengali", "bulgarian", "burmese", "chinese_cantonese", "chinese_mandarin", "chinese_other_dialects", "haitian_creole", "czech", "danish", "dutch", "English", "esperanto", "estonian", "fante", "farsi", "finnish", "french", "german", "greek", "hausa", "hawaiian", "hebrew", "hindi", "Hungarian", "igbo", "irish", "italian", "japanese", "korean", "norwegian", "other", "polish", "portuguese", "punjabi", "russian", "sinhala", "spanish", "swahali", "swedish", "teme", "thai", "tigre", "tigrinya", "turkish", "twi", "ukrainian", "urdu", "welsh", "yiddish" ], "type": "string", "description": "Only used when `mode` is \"Advanced Search\". Filter to caregivers who speak this language. Not reliably supported upstream for the Pet Care category — silently ignored (with a status-message note) if combined with `searchCategory: \"petSitting\"`.", "default": "" }, "petTypeFacet": { "title": "Type of pet experience (Advanced Search, Pet Care only)", "enum": [ "", "dogs", "cats", "birds", "horses", "farm_animals", "reptiles_amphibians", "exotic_pets", "small_mammals", "other" ], "type": "string", "description": "Only used when `mode` is \"Advanced Search\" and `searchCategory` is \"Pet Care Providers\". Filter to caregivers experienced with this type of pet. Ignored (with a status-message note) for any other `searchCategory`.", "default": "" }, "seniorAgeFacet": { "title": "Senior age range (Advanced Search, Companion Care only)", "enum": [ "", "under_55", "from_55_to_64", "from_65_to_74", "from_75_to_84", "over_85" ], "type": "string", "description": "Only used when `mode` is \"Advanced Search\" and `searchCategory` is \"Companion Care / Senior Care\". Filter to caregivers experienced with seniors in this age range. Ignored (with a status-message note) for any other `searchCategory`.", "default": "" }, "specialNeedsAgeFacet": { "title": "Special needs age group (Advanced Search, Special Needs only)", "enum": [ "", "infant", "toddler", "youth", "adult", "senior" ], "type": "string", "description": "Only used when `mode` is \"Advanced Search\" and `searchCategory` is \"Special Needs Caregivers\". Filter to caregivers experienced with this age group. Ignored (with a status-message note) for any other `searchCategory`.", "default": "" }, "requiresTransportation": { "title": "Must have a car (Advanced Search)", "type": "boolean", "description": "Only used when `mode` is \"Advanced Search\". If true, only returns caregivers who indicated they have access to transportation. Not reliably supported upstream for the Companion Care / Senior Care and Pet Care categories — silently ignored (with a status-message note) if combined with those `searchCategory` values.", "default": false }, "sortBy": { "title": "Sort order (Advanced Search)", "enum": [ "relevance", "distance", "rate", "experience" ], "type": "string", "description": "Only used when `mode` is \"Advanced Search\". Result ordering for the real search-database results. All 4 options verified live across every `searchCategory`.", "default": "relevance" }, "searchKeyword": { "title": "Keyword (Advanced Search)", "type": "string", "description": "Only used when `mode` is \"Advanced Search\". Free-text keyword to search caregiver bios for, e.g. \"CPR\" or \"newborn\".", "default": "" }, "state": { "title": "US state", "enum": [ "", "al", "ak", "az", "ar", "ca", "co", "ct", "de", "dc", "fl", "ga", "hi", "id", "il", "in", "ia", "ks", "ky", "la", "me", "md", "ma", "mi", "mn", "ms", "mo", "mt", "ne", "nv", "nh", "nj", "nm", "ny", "nc", "nd", "oh", "ok", "or", "pa", "ri", "sc", "sd", "tn", "tx", "ut", "vt", "va", "wa", "wv", "wi", "wy" ], "type": "string", "description": "US state to search in. When `mode` is \"Discover Cities\", this optionally filters the discovered cities to one state — leave blank to discover cities nationwide.", "default": "mi" }, "careNiche": { "title": "Child-care specialty (optional)", "enum": [ "", "beforeSchool", "afterSchool", "tutoring", "homeschool", "hybridLearning", "elearning", "bilingual", "aslSpeaking", "overnight" ], "type": "string", "description": "Optional specialty filter for a real, distinct set of caregivers. Only applies when `mode` is \"Child Care Providers\" (all 9 options) or \"Nannies\" (Before-School through eLearning only) — every other mode, or a specialty not offered for the chosen mode, is ignored and the normal unfiltered listing is scraped instead.", "default": "" }, "city": { "title": "City", "type": "string", "description": "City name, lowercase with hyphens instead of spaces (e.g. \"detroit\", \"new-york\", \"los-angeles\"). Must be a city Sittercity has a listing page for (Job Postings modes use the same city/state as the matching caregiver category). Not used when `mode` is \"Discover Cities\" — use that mode to find valid city slugs instead of guessing.", "default": "detroit" }, "maxItems": { "title": "Max caregivers / cities", "minimum": 1, "maximum": 500, "type": "integer", "description": "Maximum number of records to return. Babysitters / Nannies / Child Care pages show a fixed top-10 list per city (no further pagination exists on that curated landing-page template), so those 3 categories cap at 10 regardless of this value when using their normal `mode`. Companion Care / Pet Sitting / Special Needs support full pagination up to this limit. Job Postings modes show a single page of real postings per city (typically 1-15, varies by city and category — robots.txt disallows further job-listing pagination) so those 6 categories cap at whatever is actually posted. \"Advanced Search\" mode searches the real full database (ZIP + radius) with real pagination for all 6 caregiver categories, up to this limit. In \"Discover Cities\" mode this caps the number of city/state combinations returned.", "default": 20 } } }, "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 } } } } } } } } } }