{
  "openapi": "3.0.1",
  "info": {
    "title": "NYC ACRIS Property Records Scraper — Deeds, Mortgages & Owners",
    "description": "Pull NYC property records (deeds, mortgages, parties, addresses) from ACRIS by borough, document type and date. Fresh buyer/seller/owner leads",
    "version": "0.0",
    "x-build-id": "clPtucEXHsPE0viK4"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/memo23~nyc-acris-property-records/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-memo23-nyc-acris-property-records",
        "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/memo23~nyc-acris-property-records/runs": {
      "post": {
        "operationId": "runs-sync-memo23-nyc-acris-property-records",
        "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/memo23~nyc-acris-property-records/run-sync": {
      "post": {
        "operationId": "run-sync-memo23-nyc-acris-property-records",
        "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": "Which NYC boroughs to pull. Leave empty for all five.",
            "items": {
              "type": "string",
              "enum": [
                "Manhattan",
                "Bronx",
                "Brooklyn",
                "Queens",
                "Staten Island"
              ],
              "enumTitles": [
                "Manhattan",
                "Bronx",
                "Brooklyn",
                "Queens",
                "Staten Island"
              ]
            },
            "default": []
          },
          "documentTypes": {
            "title": "Document types",
            "type": "array",
            "description": "Document types to include. Use plain names — DEED, MORTGAGE, ASSIGNMENT, SATISFACTION, AGREEMENT — or the raw ACRIS codes (DEED, MTGE, ASST, SAT, AGMT). Leave empty for all types.",
            "items": {
              "type": "string"
            }
          },
          "propertyTypes": {
            "title": "Property types (commercial / residential filter)",
            "type": "array",
            "description": "Filter by the property's building type (ACRIS Legals property-type code). Leave empty for ALL types. For COMMERCIAL-only, select the top group: Commercial real estate (CR), Office (OF), Retail (RB), Industrial (IB), Commercial condo (CC), Commercial coop (CP), Apartment building (AP), Entertainment (EA), Utility (UT), Non-residential vacant land (VN) — plus the mixed-use store/office types (F1/F4/FS/F5) if you want mixed-use included.",
            "items": {
              "type": "string",
              "enum": [
                "CR",
                "OF",
                "RB",
                "IB",
                "CC",
                "CP",
                "AP",
                "EA",
                "UT",
                "VN",
                "RS",
                "F1",
                "F4",
                "FS",
                "F5",
                "RE",
                "R1",
                "R2",
                "D1",
                "D2",
                "D3",
                "D4",
                "D5",
                "D6",
                "SC",
                "MC",
                "SP",
                "MP",
                "RG",
                "RP",
                "RV",
                "GR",
                "VR",
                "HC",
                "CA",
                "SA",
                "BS",
                "SM",
                "CK",
                "MR",
                "SR",
                "PS",
                "TS",
                "MU",
                "VL",
                "OT",
                "PA",
                "NA"
              ],
              "enumTitles": [
                "Commercial real estate (CR)",
                "Office building (OF)",
                "Retail building (RB)",
                "Industrial building (IB)",
                "Commercial condo unit(s) (CC)",
                "Commercial coop unit(s) (CP)",
                "Apartment building (AP)",
                "Entertainment / amusement (EA)",
                "Utility (UT)",
                "Non-residential vacant land (VN)",
                "Religious structure (RS)",
                "1-3 family with store/office (F1)",
                "4-6 family with store/office (F4)",
                "4 family with store/office (FS)",
                "5-6 family with store/office (F5)",
                "Real estate investment trust (RE)",
                "REIT 1-3 family (R1)",
                "REIT 4-6 family & commercial (R2)",
                "Dwelling - 1 family (D1)",
                "Dwelling - 2 family (D2)",
                "Dwelling - 3 family (D3)",
                "Dwelling - 4 family (D4)",
                "Dwelling - 5 family (D5)",
                "Dwelling - 6 family (D6)",
                "Single residential condo (SC)",
                "Multiple residential condo (MC)",
                "Single residential coop (SP)",
                "Multiple residential coop (MP)",
                "1-2 family dwelling w/ garage (RG)",
                "1-2 family w/ garage &/or vacant land (RP)",
                "1-2 family dwelling w/ vacant land (RV)",
                "Garage, 1-2 family (GR)",
                "Residential vacant land (VR)",
                "HDFC exemption property (HC)",
                "Adjacent condo to combine (CA)",
                "Adjacent coop to combine (SA)",
                "Bulk sale of condominiums (BS)",
                "Under $1M condo in $1M+ sale (SM)",
                "Condo unit without kitchen (CK)",
                "Maids room (MR)",
                "Storage room (SR)",
                "Parking space (PS)",
                "Timeshare (TS)",
                "Multiple properties (MU)",
                "Vacant land (VL)",
                "Other (OT)",
                "Pre-ACRIS (PA)",
                "Not applicable (NA)"
              ]
            },
            "default": []
          },
          "recordedSinceDays": {
            "title": "Recorded in the last N days",
            "type": "integer",
            "description": "Return documents recorded within this many days. A simple way to pull recent activity. Ignored if you set an explicit Date from below.",
            "default": 30
          },
          "dateFrom": {
            "title": "Date from (recorded, YYYY-MM-DD)",
            "type": "string",
            "description": "Only documents recorded on or after this date. Overrides \"Recorded in the last N days\"."
          },
          "dateTo": {
            "title": "Date to (recorded, YYYY-MM-DD)",
            "type": "string",
            "description": "Only documents recorded on or before this date. Optional."
          },
          "maxItems": {
            "title": "Maximum records",
            "type": "integer",
            "description": "Maximum number of documents to return. You are billed per record, so this bounds your spend.",
            "default": 1000
          },
          "includeParties": {
            "title": "Include parties (names + addresses)",
            "type": "boolean",
            "description": "Attach the party list for each document — buyers/sellers, borrowers/lenders — with their names and mailing addresses. This is the lead data.",
            "default": true
          },
          "includeProperty": {
            "title": "Include property (address + BBL)",
            "type": "boolean",
            "description": "Attach the property each document ties to — street address, unit, and Borough-Block-Lot (BBL).",
            "default": true
          },
          "appToken": {
            "title": "NYC Open Data app token (optional)",
            "type": "string",
            "description": "A free Socrata/NYC Open Data app token raises the API rate limit for large pulls. Optional — the actor works without one. Get one at data.cityofnewyork.us (Profile → Developer Settings)."
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}