{ "openapi": "3.0.1", "info": { "title": "Nursing Home Daily Nurse Staffing (CMS PBJ) Scraper", "description": "Nursing home staffing data from the CMS Payroll Based Journal (PBJ): daily RN, LPN and CNA hours per facility, employee vs contract, MDS census and hours per resident day. Filter by CCN, state, county, facility name or date. About 1.3M facility-days per quarter. $0.002/record.", "version": "1.1", "x-build-id": "djjoFprJkIueRS0Qv" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/jserle~cms-nursing-home-staffing-daily/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-jserle-cms-nursing-home-staffing-daily", "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/jserle~cms-nursing-home-staffing-daily/runs": { "post": { "operationId": "runs-sync-jserle-cms-nursing-home-staffing-daily", "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/jserle~cms-nursing-home-staffing-daily/run-sync": { "post": { "operationId": "run-sync-jserle-cms-nursing-home-staffing-daily", "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": { "providerCcns": { "title": "Provider numbers (CCN)", "uniqueItems": true, "type": "array", "description": "One or more six-digit CMS Certification Numbers, the `PROVNUM` column. A number that lost its leading zero in a spreadsheet is padded back out, so 15009 and 015009 both work. Up to 100 per run. Example: 015009", "items": { "type": "string" } }, "state": { "title": "State", "type": "string", "description": "Two-letter postal abbreviation, matched case-insensitively. Example: NY" }, "county": { "title": "County", "type": "string", "description": "County name exactly as CMS spells it, matched case-insensitively and without the word \"County\". Pair it with a state, because county names repeat across states. Example: Westchester" }, "facilityNameKeyword": { "title": "Facility name keyword", "type": "string", "description": "Case-insensitive substring of the facility name, useful for finding a chain. The CMS API has no text search, so this is matched after fetching and REQUIRES at least one of state, county, providerCcns, workDateFrom or workDateTo alongside it. The keyword scan reads at most 10 pages (50,000 rows). Example: GENESIS" }, "workDateFrom": { "title": "Work date from", "type": "string", "description": "ISO date, for example 2026-02-01. Keeps days on or after this date. The dataset covers one calendar quarter, so a range outside it returns nothing." }, "workDateTo": { "title": "Work date to", "type": "string", "description": "ISO date, for example 2026-02-28. Keeps days on or before this date." }, "maxResults": { "title": "Maximum records", "minimum": 1, "maximum": 50000, "type": "integer", "description": "How many facility-day records to deliver. You are charged per delivered record, so this is also your cost cap.", "default": 100 }, "allowPartialScan": { "title": "Allow a partial sample", "type": "boolean", "description": "By default a run FAILS if it hits its page budget before delivering `maxResults`, because a truncated scan is an incomplete answer that would otherwise look complete. Turn this on to accept a best-effort partial sample instead; the run summary reports `scanTruncated: true`.", "default": false }, "includeRaw": { "title": "Include the raw source row", "type": "boolean", "description": "Attach a `raw` object holding the CMS row exactly as the API returned it, under the original column names and as strings. Useful for auditing the normalization; roughly doubles item size.", "default": false } } }, "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 } } } } } } } } } }