{ "openapi": "3.0.1", "info": { "title": "CMS Nursing Home Ratings Scraper", "description": "Extract nursing home five-star ratings, inspection results, staffing data, and penalties for all 14,700 US facilities from the official CMS database. Filter by state, city, ratings, ownership, or name. Get 47 fields per facility including quality scores, staffing hours, fines, and deficiency counts.", "version": "1.0", "x-build-id": "st60Vq3h2LrLcHs8J" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/parseforge~cms-nursing-home-ratings-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-parseforge-cms-nursing-home-ratings-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/parseforge~cms-nursing-home-ratings-scraper/runs": { "post": { "operationId": "runs-sync-parseforge-cms-nursing-home-ratings-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/parseforge~cms-nursing-home-ratings-scraper/run-sync": { "post": { "operationId": "run-sync-parseforge-cms-nursing-home-ratings-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": { "maxItems": { "title": "Maximum nursing homes", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "How many nursing homes to collect per run." }, "state": { "title": "State", "type": "string", "description": "Filter by US state (2-letter code, e.g. CA, TX, NY). Leave empty for all states." }, "city": { "title": "City", "type": "string", "description": "Filter by city name (e.g. Los Angeles, Houston)." }, "zipCode": { "title": "ZIP Code", "type": "string", "description": "Filter by ZIP code." }, "providerName": { "title": "Provider Name", "type": "string", "description": "Search by nursing home name. Supports partial matches (e.g. 'sunrise' finds all providers with 'sunrise' in the name)." }, "ccn": { "title": "CMS Certification Number (CCN)", "type": "string", "description": "Look up a specific nursing home by its 6-digit CMS Certification Number." }, "overallRating": { "title": "Overall Rating", "enum": [ "1", "2", "3", "4", "5" ], "type": "string", "description": "Filter by overall five-star rating (1-5)." }, "healthInspectionRating": { "title": "Health Inspection Rating", "enum": [ "1", "2", "3", "4", "5" ], "type": "string", "description": "Filter by health inspection rating (1-5)." }, "qualityMeasureRating": { "title": "Quality Measure Rating", "enum": [ "1", "2", "3", "4", "5" ], "type": "string", "description": "Filter by quality measure rating (1-5)." }, "staffingRating": { "title": "Staffing Rating", "enum": [ "1", "2", "3", "4", "5" ], "type": "string", "description": "Filter by staffing rating (1-5)." }, "ownershipType": { "title": "Ownership Type", "enum": [ "For profit - Corporation", "For profit - Individual", "For profit - Limited Liability company", "For profit - Partnership", "Government - City", "Government - City/county", "Government - County", "Government - Federal", "Government - Hospital district", "Government - State", "Non profit - Church related", "Non profit - Corporation", "Non profit - Other" ], "type": "string", "description": "Filter by ownership type." } } }, "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 } } } } } } } } } }