{ "openapi": "3.0.1", "info": { "title": "US Nursing Homes Scraper - Owners, Ratings & Staffing", "description": "Scrape US Medicare-certified nursing homes with CCN, address, phone, ownership type, beds, 5-star ratings, staffing, fines and the full list of owners and managers (name, type, role, percentage). Filter by state, city, ZIP, ownership, rating and beds. Export to JSON, CSV or Excel.", "version": "0.1", "x-build-id": "ukKL2unk2dlZ161qq" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapers_lat~cms-nursing-homes-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapers_lat-cms-nursing-homes-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/scrapers_lat~cms-nursing-homes-scraper/runs": { "post": { "operationId": "runs-sync-scrapers_lat-cms-nursing-homes-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/scrapers_lat~cms-nursing-homes-scraper/run-sync": { "post": { "operationId": "run-sync-scrapers_lat-cms-nursing-homes-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": { "states": { "title": "States", "type": "array", "description": "Filter by 2-letter US state code, for example CA, TX, NY. One run can scan several.", "items": { "type": "string" } }, "cities": { "title": "Cities", "type": "array", "description": "Optional. Filter by city, for example HOUSTON, DALLAS.", "items": { "type": "string" } }, "zipCodes": { "title": "ZIP codes", "type": "array", "description": "Optional. Filter by 5-digit ZIP code.", "items": { "type": "string" } }, "counties": { "title": "Counties", "type": "array", "description": "Optional. Filter by county / parish name as spelled by CMS, for example Harris, Franklin.", "items": { "type": "string" } }, "nameContains": { "title": "Facility name contains", "type": "string", "description": "Optional. Keep only nursing homes whose name contains this text." }, "chainNameContains": { "title": "Chain name contains", "type": "string", "description": "Optional. Keep only nursing homes whose chain / group name contains this text." }, "ownershipTypes": { "title": "Ownership types", "type": "array", "description": "Optional. Filter by ownership type. Use exact CMS labels.", "items": { "type": "string", "enum": [ "For profit - Corporation", "For profit - Individual", "For profit - Limited Liability company", "For profit - Partnership", "Non profit - Corporation", "Non profit - Church related", "Non profit - Other", "Government - City", "Government - County", "Government - State", "Government - Federal", "Government - Hospital district" ] } }, "minOverallRating": { "title": "Minimum overall star rating", "minimum": 1, "maximum": 5, "type": "integer", "description": "Optional. Keep only facilities with an overall 5-star rating at or above this value (1-5)." }, "maxOverallRating": { "title": "Maximum overall star rating", "minimum": 1, "maximum": 5, "type": "integer", "description": "Optional. Keep only facilities with an overall 5-star rating at or below this value (1-5)." }, "minBeds": { "title": "Minimum certified beds", "minimum": 0, "type": "integer", "description": "Optional. Keep only facilities with at least this many certified beds." }, "maxBeds": { "title": "Maximum certified beds", "minimum": 0, "type": "integer", "description": "Optional. Keep only facilities with at most this many certified beds." }, "changedOwnershipLast12Months": { "title": "Only facilities that changed ownership in last 12 months", "type": "boolean", "description": "When on, keep only nursing homes that changed ownership in the last 12 months.", "default": false }, "specialFocusOnly": { "title": "Only Special Focus Facilities", "type": "boolean", "description": "When on, keep only Special Focus Facilities or candidates (a CMS watch list).", "default": false }, "ccnNumbers": { "title": "CCN numbers", "type": "array", "description": "Optional. Look up specific facilities by their CMS Certification Number (CCN).", "items": { "type": "string" } }, "includeOwnership": { "title": "Include owners and managers", "type": "boolean", "description": "When on (default), attach the full list of registered owners and managers to each facility.", "default": true }, "maxFacilities": { "title": "Max Facilities To Scrape", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Maximum number of nursing homes to collect." } } }, "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 } } } } } } } } } }