{ "openapi": "3.0.1", "info": { "title": "NYC ACRIS Deed Transfer Intel - LLC, Cash & Out-of-State Buyers", "description": "NYC deed-transfer intel from ACRIS: each deed joined across Master, Legals & Parties into one row with BBL, price, buyer/seller names, plus LLC-buyer, out-of-state-buyer and cash-sale flags. Delta mode emits only new deeds. For agents farming just-sold, investors and title/proptech teams.", "version": "1.1", "x-build-id": "snldZlOFCwqgQUfI5" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/malonestar~acris-deed-transfer-intel/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-malonestar-acris-deed-transfer-intel", "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/malonestar~acris-deed-transfer-intel/runs": { "post": { "operationId": "runs-sync-malonestar-acris-deed-transfer-intel", "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/malonestar~acris-deed-transfer-intel/run-sync": { "post": { "operationId": "run-sync-malonestar-acris-deed-transfer-intel", "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": { "boroughs": { "title": "Boroughs", "type": "array", "description": "Select deeds by the PROPERTY borough recorded in ACRIS Legals: 1 = Manhattan, 2 = Bronx, 3 = Brooklyn, 4 = Queens, 5 = Staten Island. Leave empty for all boroughs. Note Staten Island is thinly represented in ACRIS (206,662 of 22.7M Legals records) because Richmond County keeps its own index.", "items": { "type": "string", "enum": [ "1", "2", "3", "4", "5" ], "enumTitles": [ "1 - Manhattan", "2 - Bronx", "3 - Brooklyn", "4 - Queens", "5 - Staten Island" ] } }, "docTypes": { "title": "Document types", "type": "array", "description": "ACRIS document type codes to include (e.g. DEED, DEEDO, RPTT&RET). Default DEED covers standard deed transfers. Leave empty to include all recorded document types (not recommended).", "items": { "type": "string" } }, "lookbackDays": { "title": "Lookback window (days)", "minimum": 1, "maximum": 365, "type": "integer", "description": "How many days of recordings to include, counted back from the LATEST recorded date in the ACRIS dataset (not from today - ACRIS recordings lag by several weeks to ~2-3 months).", "default": 60 }, "mode": { "title": "Run mode", "enum": [ "inventory", "delta" ], "type": "string", "description": "\"inventory\" emits every deed in the window on every run. \"delta\" keeps a cross-run baseline in the NAMED key-value store \"acris-deed-transfer-intel-state\", scoped to your borough/doc-type/window combination, and emits only documents it has not seen before. The first delta run for a given scope seeds the baseline and emits the full window; every row carries delta_baseline_status so you can tell a seeded run from an incremental one.", "default": "inventory" }, "maxResults": { "title": "Max results", "minimum": 1, "maximum": 50000, "type": "integer", "description": "Maximum number of deed records to emit (each emitted record is one billable result). Because borough selection happens after the Legals join, the actor scans up to 20x this many recorded documents to fill a borough-filtered request.", "default": 100 }, "cashSaleToleranceDays": { "title": "Cash-sale tolerance (days)", "minimum": 1, "maximum": 180, "type": "integer", "description": "A deed is flagged cash_sale=true when no mortgage (MTGE) is recorded against the same borough-block-lot within this many days of the deed recording date. cash_sale is null (never true) when the mortgage lookup could not be completed for that parcel - see mortgage_status.", "default": 45 } } }, "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 } } } } } } } } } }