--- name: api.northeastdealintel.com description: api.northeastdealintel.com provides two skills for commercial real estate analysis in the Northeast US: one for searching active CRE listings with deal scoring, and one for retrieving quarterly cap rate benchmarks by state and property type. Together they support deal discovery and market-relative evaluation for acquisition workflows. host: api.northeastdealintel.com --- # api.northeastdealintel.com This host serves CRE investors, brokers, and acquisition analysts focused on the Northeast US (CT, MA, NJ, NY, PA, RI, NH, VT, ME). It provides scored listing search across commercial property types and benchmark cap rate data to contextualize deal quality. It does not cover other US regions, residential properties, off-market transactions, or full property appraisals. ## When to use this host Use this host when an agent needs to discover and score active commercial real estate listings in the Northeast US, or when it needs current cap rate benchmarks for Northeast states and commercial property types. It is the right choice for multifamily, industrial, retail, office, or life science deal screening in CT, MA, NJ, NY, PA, RI, NH, VT, or ME. Do not use it for markets outside the Northeast, for residential real estate, for off-market or historical transaction data, or for full property valuations or appraisals — those tasks require dedicated appraisal or national CRE data providers. ## Capabilities ### Market Benchmarks Returns current cap rate ranges and strong-buy thresholds by state and property type, providing the market context needed to evaluate any individual deal. - **`fetch-cap-rate-benchmarks`** — Returns live cap rate benchmarks (low, high, strong-buy threshold) by state and property type for Northeast US commercial real estate, updated quarterly. ### Listing Discovery and Deal Scoring Searches active Northeast CRE listings filtered by state, property type, price, cap rate, and deal score, returning ranked acquisition targets with flags and listing URLs. - **`search-northeast-cre-listings`** — Searches active commercial real estate listings in the Northeast US, returning deal-scored results with cap rates, asking prices, green/red flags, and listing URLs. ## Workflows ### Benchmark-Calibrated Deal Search *Use when an agent needs to find Northeast CRE listings and validate whether their cap rates are competitive against current market benchmarks before surfacing acquisition targets.* 1. **`fetch-cap-rate-benchmarks`** — Retrieve the current cap rate low, high, and strong-buy threshold for the target state and property type to establish market context. 2. **`search-northeast-cre-listings`** — Search active listings using the benchmark strong-buy threshold as the min_cap_rate filter, ensuring returned deals meet or exceed the market-defined quality bar. ## Skill reference ### `search-northeast-cre-listings` **Northeast Deal Search** — Searches active commercial real estate listings in the Northeast US, returning deal-scored results with cap rates, asking prices, green/red flags, and listing URLs. *Use when:* Use when an agent needs to find active CRE listings in Northeast US states filtered by state, property type, deal score, price ceiling, or minimum cap rate, and wants scored results to prioritize acquisition targets. *Not for:* Do not use for listings outside the Northeast US, for historical or off-market deal data, or for non-commercial property types not covered by the supported categories. **Inputs:** - `state` (string) — 2-letter state code to filter results by state (e.g. NY, PA, MA). - `property_type` (string) — Property type filter. Accepted values: industrial, multifamily, retail, office, land, mixed-use. - `min_score` (number) — Minimum deal score on a 1–10 scale to filter results. - `max_price` (integer) — Maximum asking price in dollars to filter results. - `min_cap_rate` (number) — Minimum cap rate (as a decimal, e.g. 0.07 for 7%) to filter results. - `limit` (integer) — Maximum number of results to return. Must be between 1 and 100. Defaults to 20. **Returns:** Returns a count and results array of up to 20 scored CRE listings, each with address, asking price, cap rate, deal score, green/red flags, Opportunity Zone and 1031 indicators, and a direct listing URL. **Example:** `GET https://api.northeastdealintel.com/v1/agent/search?state=NY&property_type=multifamily&min_score=7.5&max_price=5000000&min_cap_rate=0.07&limit=20` --- ### `fetch-cap-rate-benchmarks` **Northeast CRE Cap Rate Benchmarks** — Returns live cap rate benchmarks (low, high, strong-buy threshold) by state and property type for Northeast US commercial real estate, updated quarterly. *Use when:* Use when an agent needs to compare a deal's cap rate or pricing against current market benchmarks for a specific Northeast US state (CT, MA, NJ, NY, PA, RI, NH, VT, ME) and property type such as industrial, multifamily, retail, office, or life science. *Not for:* Do not use for non-Northeast US markets, for real-time transaction pricing, or for residential real estate benchmarks. Not a substitute for a full property valuation or appraisal. **Inputs:** - `state` (string) — 2-letter US state code to filter results. Supported values: CT, MA, NJ, NY, PA, RI, NH, VT, ME. If omitted, benchmarks for all states are returned. **Returns:** Returns a states object keyed by state code, each containing an array of property-type benchmarks with cap_rate_low, cap_rate_high, strong_buy_below, and notes, plus a last_updated quarter and source note. **Example:** `GET https://api.northeastdealintel.com/v1/agent/market-benchmarks?state=NY` ---