{ "openapi": "3.0.1", "info": { "title": "Pennsylvania Business Registry Officers & New Filings", "description": "Pennsylvania registered businesses with their officers, organizers and incorporators from the PA Department of State open dataset. Filter by creation date, county, officer role, name and registration type. One record per officer or one per business. Monthly refresh. $0.002/record.", "version": "1.0", "x-build-id": "XtxUvYqsHZkZKIJdb" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/jserle~pa-business-registry-officers/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-jserle-pa-business-registry-officers", "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~pa-business-registry-officers/runs": { "post": { "operationId": "runs-sync-jserle-pa-business-registry-officers", "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~pa-business-registry-officers/run-sync": { "post": { "operationId": "run-sync-jserle-pa-business-registry-officers", "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": { "creationDateFrom": { "title": "Created on or after", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "ISO date (YYYY-MM-DD). Businesses whose creation date is on or after this day. Default: the first day of the month 45 days ago, which is always a month the Department has already published (refresh is monthly, a few days after month end)." }, "creationDateTo": { "title": "Created on or before", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "ISO date (YYYY-MM-DD), inclusive. Default: today." }, "county": { "title": "County", "type": "string", "description": "Pennsylvania county name, case-insensitive exact match. Examples: Philadelphia, Allegheny, Montgomery, Bucks, Delaware, Chester, Lancaster. Businesses with a non-Pennsylvania address carry the value Out of State." }, "partyType": { "title": "Officer role", "type": "string", "description": "Case-insensitive exact match on the role the Department recorded (the Governor/Principal Officer column). Most common values: Organizer (new LLCs), Incorporator (new corporations), President, Governor, Treasurer, Secretary, Vice President, General Partner, Member, Owner, Managing Member, Manager, CEO. The field is free text on the source, so Member and MEMBER both exist and both match \"member\"." }, "businessNameContains": { "title": "Business name contains", "type": "string", "description": "Case-insensitive substring matched against the business name. Example: plumbing" }, "registrationType": { "title": "Registration type", "enum": [ "any", "Domestic Limited Liability Company", "Domestic Business Corporation", "Domestic Nonprofit Corporation", "Foreign Business Corporation", "Foreign Limited Liability Company", "Domestic Limited Partnership (LP/LLLP)", "Foreign Nonprofit Corporation", "Foreign Limited Partnership", "Foreign Business Trust", "Domestic Business Trust", "Foreign Limited Liability General Partnership", "Domestic General Partnership (GP/LLP)", "Foreign Professional Association", "Authority", "Domestic Credit Union", "Domestic Land Bank", "Domestic Financial Institution", "Domestic Professional Association" ], "type": "string", "description": "Type of business registration as the Department classifies it. Any keeps all 18 types.", "default": "any" }, "dedupeByBusiness": { "title": "One record per business", "type": "boolean", "description": "Off: one record per business x officer row (the source grain), so a corporation with a president, a treasurer and a secretary is three records. On: one record per filing number with the officers collected in an officers array. maxResults then counts businesses.", "default": false }, "maxResults": { "title": "Maximum records", "minimum": 1, "maximum": 50000, "type": "integer", "description": "Stop after this many records. Each delivered record is one paid unit. Maximum 50000.", "default": 100 }, "allowPartial": { "title": "Accept fewer records than maxResults", "type": "boolean", "description": "Off: if the Actor has to read more than its scan cap of source rows (four per requested record, at least 65,000) without completing maxResults records, the run FAILS with nothing delivered, so a short delivery is never mistaken for a complete one. On: the complete records read so far are delivered and the run summary marks stoppedByScanCap. Only relevant for very large maxResults on duplicate-heavy windows or with one record per business.", "default": false }, "includeRaw": { "title": "Include raw source row", "type": "boolean", "description": "Attach the untouched Socrata row under raw (an array of rows when one record per business is on).", "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 } } } } } } } } } }