{ "openapi": "3.0.1", "info": { "title": "Suffolk County NY Liens: UCC, Tax, Judgment & Lis Pendens", "description": "Search Suffolk County, NY recorded liens by debtor, creditor or document number. Get UCC filings, federal and state tax liens, mechanics liens, judgments and lis pendens with parties, amounts and tax-map data.", "version": "0.1", "x-build-id": "hhfEFhhP7sesmUxQS" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/lienintel~suffolk-county-ny-lien-filings/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-lienintel-suffolk-county-ny-lien-filings", "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/lienintel~suffolk-county-ny-lien-filings/runs": { "post": { "operationId": "runs-sync-lienintel-suffolk-county-ny-lien-filings", "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/lienintel~suffolk-county-ny-lien-filings/run-sync": { "post": { "operationId": "run-sync-lienintel-suffolk-county-ny-lien-filings", "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": { "debtorNames": { "title": "Debtor, defendant or property-owner names", "type": "array", "description": "Names to search on the debtor or defendant side, up to 20. Partial names are supported, for example SMITH, MIKOLAENKO or 460 OLD TOWN ROAD. Each name is searched separately and results are deduplicated.", "items": { "type": "string" } }, "securedPartyNames": { "title": "Creditor, plaintiff or lien-claimant names", "type": "array", "description": "Names to search on the secured-party, plaintiff or lien-claimant side, up to 20, for example M&T BANK or COMMISSIONER OF TAXATION. Applies to liens, judgments and lis pendens; the UCC index is searched on the debtor side.", "items": { "type": "string" } }, "documentNumbers": { "title": "Document, index or UCC numbers", "type": "array", "description": "Exact Suffolk County Clerk document, index, lien or UCC numbers, up to 20, for example U20260006438, LMEC00018159 or 26 630350.", "items": { "type": "string" } }, "lienTypes": { "title": "Record categories", "type": "array", "description": "Categories to include. Allowed values: ucc, tax_lien, mechanics_lien, judgment_lien, lis_pendens, other_lien. Leave empty for all categories.", "default": [ "ucc", "tax_lien", "mechanics_lien", "judgment_lien", "lis_pendens", "other_lien" ], "items": { "type": "string" } }, "includeReleases": { "title": "Include terminations and releases", "type": "boolean", "description": "Include UCC terminations and releases and released lien or judgment records. Turn off to return only new liens, active filings, continuations, amendments and assignments.", "default": true }, "nameMatch": { "title": "Name match mode", "enum": [ "contains", "starts_with", "exact" ], "type": "string", "description": "How party names are matched: contains, starts_with or exact. Contains is the broadest and is the default.", "default": "contains" }, "dateFrom": { "title": "Recorded from", "type": "string", "description": "Earliest recorded date in YYYY-MM-DD format. Leave empty for the last 30 days in browse mode, or the last 10 years when searching by name or document number." }, "dateTo": { "title": "Recorded to", "type": "string", "description": "Latest recorded date in YYYY-MM-DD format. Leave empty for today." }, "maxFilings": { "title": "Maximum records", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum number of unique lien, judgment, lis pendens or UCC records to return and charge. Free Apify users receive up to 10 results per run.", "default": 100 } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }