Search NYC property signals
search_nyc_signalsLists NYC lots that carry one or more property signals: reasons a deal can happen, such as a loan coming due, an old mortgage not refinanced, a long-time owner, an absentee or company owner, a foreclosure case, the tax lien sale list, open code violations, a vacate order, unused air rights, a teardown lot or a rezoning. Use it for asks like these, with these keys: loans coming due or maturing: loan_maturing; old mortgage, not refinanced: aging_mortgage; long holds or long-time owners: long_hold; likely or motivated sellers: long_hold, absentee_owner, serial_seller, value_below_loan; tired landlords or distressed owners: code_violations, hpd_litigation, tax_lien, vacate_order; underwater or over-leveraged: value_below_loan; free and clear, no mortgage: no_recorded_debt; development sites or air rights: underbuilt, teardown, vacant_land, assemblage; new construction or rezonings: new_building_permit, rezoning_filed, entitled_not_built; recent sales or active buyers: just_sold, serial_buyer. Narrow by boroughs, ZIP codes, neighborhoods (ntas) and building types. Each row gives the BBL, address, owner of record and every signal on the lot with its date. Signals marked likely are estimates; say likely when you repeat them. The result also counts lots per signal in the area. Never spends credits. On any paid plan the first 25 rows each day are free; other workspaces pay for every row. Rows already pulled are free again. Past the free rows, rows cost 1 credit per row, and this tool returns them as a quote: tell the user the credit cost and ask before calling run_nyc_signals_search with the quote_id. No contacts in the result: use unlock_nyc_property_report and then unlock_nyc_owner_contacts on a BBL for the owner's phones and emails. Up to 50 rows per call (default 25), newest signal first; page with offset.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"signals": "<signals>"
},
"name": "search_nyc_signals"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ntas | No | 2020 neighborhood codes from find_nyc_area, for example BK0102 Williamsburg. Use them whenever the person names a neighborhood. | |
| zips | No | NYC ZIP codes. Boroughs, ZIPs and ntas combine as any of them. | |
| limit | No | ||
| match | No | any keeps lots with at least one of the signals; all keeps lots with every one. | any |
| offset | No | ||
| signals | Yes | One or more signal keys: long_hold, absentee_owner, entity_owner, portfolio_owner, just_sold, serial_buyer, serial_seller, recorded_mortgage, no_recorded_debt, aging_mortgage, value_below_loan, foreclosure_filed, auction_scheduled, tax_lien, code_violations, vacate_order, fire_vacate, hpd_litigation, vacant_storefront, underbuilt, vacant_land, teardown, land_just_bought, assemblage, rezoning_filed, new_building_permit, new_co, entitled_not_built, loan_maturing, io_balloon, weak_coverage, occupancy_down, noi_down, dscr_below_1, loan_modified, maturity_extended, servicer_advancing, special_servicing, delinquent, ll97_covered, ll97_fine_2024, ll97_fine_2030, evictions, facade_unsafe, j51_ending, 421a_ending, low_inspection_grade, lihtc_year15, subsidy_expiring, oz_year10. | |
| boroughs | No | Whole NYC boroughs. All five when omitted. | |
| asset_classes | No | Building types, for example multifamily_walkup, multifamily_elevator, mixed_use, office, retail, one_two_family, condo, coop. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| rows | Yes | ||
| quote | Yes | ||
| counts | Yes | ||
| offset | Yes | ||
| notYetBuilt | Yes | ||
| totalMatches | Yes | ||
| creditsCharged | Yes | ||
| freeRowsPerDay | Yes | ||
| freeRowsUsedToday | Yes | ||
| possibleIsEstimate | Yes |