# Crexi API scraper — crexi.com, the US commercial real estate marketplace: search the for-sale listings and the spaces for lease of any city, county, ZIP or state with Crexi's own filters (property type, asking price, building size, lot acreage, cap rate, year built, opportunity zone, asking rate per square foot), and read one listing in full with its fact table, brokers, brokerage and per-suite lease availability. Listings with no published price — 'contact broker', auctions, offering-memorandum-only deals — are returned as an explicit unpriced answer with the reason, never as a guessed number and never as an error. No account, no browser.

> Search the FOR-SALE commercial listings on crexi.com. Give a market — city plus state, a county, a ZIP code or a whole state — and narrow it with the filters Crexi itself publishes: property type, asking price range, building size, lot acreage, cap rate, year built and opportunity-zone status. Every row carries the asking price in USD with an explicit status, the property types, the building size, the brokerage, the full geocoded address and the live crexi.com URL. Listings whose price the broker did not publish are included by default and say so; set include_unpriced to false for priced listings only. Page with offset. A market with no matching listing answers an honest empty result, not an error.
> ReefAPI engine `crexi` · 5 endpoints · clean JSON, no scraping or browsers to manage.

## How to call
- **Endpoint:** `POST https://api.reefapi.com/crexi/v1/<action>` with a JSON body.
- **Auth:** header `x-api-key: <YOUR_REEFAPI_KEY>` — create one free (1,000 credits, no card): https://reefapi.com/signup
- **Response (every call):** `{ ok: boolean, data: ..., meta: { record_count, credits, ... }, error: { code, message } }` — branch on `ok`. Failed calls are free.
- **One key + one shared credit pool** across every ReefAPI API. Per-call credits are listed on each endpoint below.
- **Use it from an AI agent (MCP):** connect `https://api.reefapi.com/mcp` (remote streamable-http). Clients that add connectors by URL, such as ChatGPT and the Claude app, connect with OAuth 2.1 (the user pastes their key once on a ReefAPI page; discovery at `/.well-known/oauth-protected-resource/mcp`). Config files send the key as `Authorization: Bearer <key>`. `?key=<key>` in the URL also works as a last-resort fallback.

## Endpoints

### POST https://api.reefapi.com/crexi/v1/search — 1 credit
Search the FOR-SALE commercial listings on crexi.com. Give a market — city plus state, a county, a ZIP code or a whole state — and narrow it with the filters Crexi itself publishes: property type, asking price range, building size, lot acreage, cap rate, year built and opportunity-zone status. Every row carries the asking price in USD with an explicit status, the property types, the building size, the brokerage, the full geocoded address and the live crexi.com URL. Listings whose price the broker did not publish are included by default and say so; set include_unpriced to false for priced listings only. Page with offset. A market with no matching listing answers an honest empty result, not an error.

**Parameters:**
- `city` (string, optional) — City name as Crexi spells it, e.g. 'Austin', 'Los Angeles', 'Fort Worth'. Pair it with `state` — a bare city name matches that city in EVERY state (Austin alone returns Austin TX and Austin MN together).
- `state` (string, optional) — Two-letter US state code (TX, CA, NY…). Works on its own for a whole-state sweep and narrows `city` when both are given.
- `county` (string, optional) — County name, e.g. 'Travis'. Crexi stores county names exactly as the listing agent typed them, so spelling varies between listings; `city` + `state` is the more reliable market filter.
- `zip_code` (string, optional) — Five-digit US ZIP code. The tightest geography filter Crexi publishes.
- `query` (string, optional) — Free-text search across the listing name, description and address — the same box Crexi's own header search uses. It is NOT a location filter: 'Austin, TX' also matches a San Antonio listing whose text mentions Austin. Use `city`/`state`/`zip_code` for geography and `query` for a tenant, a brand or a building name.
- `property_types` (array, optional) — Crexi's own top-level property categories. Several may be given and the listing matches if it carries ANY of them. A value Crexi does not know is rejected by the source, so a typo fails loudly rather than silently returning everything. [one of: Retail, Office, Industrial, Multifamily, Land, Mixed Use, Hospitality, Special Purpose, Business for Sale, Note/Loan, Self Storage, Health Care]
- `price_min` (number, optional) — Lowest asking price in USD. Listings with no published price are not excluded by this filter — set `include_unpriced` to false if you want only priced listings.
- `price_max` (number, optional) — Highest asking price in USD.
- `size_min` (number, optional) — Smallest building size in square feet.
- `size_max` (number, optional) — Largest building size in square feet.
- `acres_min` (number, optional) — Smallest lot size in acres — the size filter that matters for Land listings, which are the single biggest category on Crexi.
- `acres_max` (number, optional) — Largest lot size in acres.
- `cap_rate_min` (number, optional) — Lowest capitalisation rate, in percent (7.5 means 7.5%). Only investment listings publish a cap rate, so this filter also removes the ones that do not.
- `cap_rate_max` (number, optional) — Highest capitalisation rate, in percent.
- `opportunity_zone_only` (boolean, optional, default false) — Return only listings inside a federal Qualified Opportunity Zone.
- `include_unpriced` (boolean, optional, default true) — Keep the listings whose price the broker did not publish ('contact broker', auctions, offering-memorandum-only deals). They are a large and genuine part of the US commercial market, so they are included by default and come back with price.amount = null and price.status saying why. Set false for priced listings only.
- `limit` (integer, optional, default 50) — How many listings to return in this call (1-100). One call, one page: Crexi serves the whole page in a single request.
- `offset` (integer, optional, default 0) — How many listings to skip before the ones returned — this is how you page. offset=50 with limit=50 is the second page. Crexi ignores every other paging name it is offered, so this is the only one that moves the window.

**Returns:** listing_id, title, url (the live crexi.com page), listing_type, price (amount in USD, currency, status = published | unpriced | auction, note, and Crexi's own formatted rendering on the detail routes), property_types, property_subtypes, investment_type, building_size_sqft, status, description, brokerage_name, location (address, city, county, state, state_code, zip, country, latitude, longitude, full_address), other_locations for portfolio listings, in_opportunity_zone, is_new, activated_on, updated_on and media (thumbnail, image_count, has_video, has_virtual_tour, has_offering_memorandum, has_flyer). Plus total_results and returned_count on the envelope.

**Example request body:**
```json
{
  "city": "Austin",
  "state": "TX",
  "limit": 25
}
```

### POST https://api.reefapi.com/crexi/v1/lease_search — 1 credit
Search the SPACES FOR LEASE on crexi.com. Same geography filters as `search`, plus the lease-side one: rentable space size. Every row carries the rate range with Crexi's own formatted twin next to the number (so you can cross-check it), the rate type the broker quoted, the rentable square-foot range, how many suites the building has, the brokerage, the geocoded address and the live crexi.com/lease URL. Spaces whose rate the broker withheld are included by default and say so. The lease side is a separate Crexi product with its own listing ids and its own property-type list.

**Parameters:**
- `city` (string, optional) — City name as Crexi spells it, e.g. 'Austin', 'Los Angeles', 'Fort Worth'. Pair it with `state` — a bare city name matches that city in EVERY state (Austin alone returns Austin TX and Austin MN together).
- `state` (string, optional) — Two-letter US state code (TX, CA, NY…). Works on its own for a whole-state sweep and narrows `city` when both are given.
- `county` (string, optional) — County name, e.g. 'Travis'. Crexi stores county names exactly as the listing agent typed them, so spelling varies between listings; `city` + `state` is the more reliable market filter.
- `zip_code` (string, optional) — Five-digit US ZIP code. The tightest geography filter Crexi publishes.
- `query` (string, optional) — Free-text search across the listing name, description and address — the same box Crexi's own header search uses. It is NOT a location filter: 'Austin, TX' also matches a San Antonio listing whose text mentions Austin. Use `city`/`state`/`zip_code` for geography and `query` for a tenant, a brand or a building name.
- `property_types` (array, optional) — Crexi's own top-level space categories on the lease side. The lease and sale category trees are NOT the same list. [one of: Retail, Office, Industrial, Restaurant, Land, Special Purpose, Flex, Medical, Coworking]
- `space_sqft_min` (number, optional) — Smallest rentable space, in square feet.
- `space_sqft_max` (number, optional) — Largest rentable space, in square feet.
- `include_undisclosed_rate` (boolean, optional, default true) — Keep the spaces whose asking rate the broker withheld. They come back with rate.per_sqft_year_min = null and rate.status = 'undisclosed'. Set false for spaces with a published rate only.
- `limit` (integer, optional, default 50) — How many listings to return in this call (1-100). One call, one page: Crexi serves the whole page in a single request.
- `offset` (integer, optional, default 0) — How many listings to skip before the ones returned — this is how you page. offset=50 with limit=50 is the second page. Crexi ignores every other paging name it is offered, so this is the only one that moves the window.

**Returns:** listing_id, title, url, listing_type, rate (per_sqft_year_min/max in USD, rate_type, Crexi's formatted yearly and monthly twins, status = published | undisclosed), property_types, rentable_sqft_min/max, suite_count, status, description, brokerage_name, location, is_new, is_outdated, activated_on, updated_on and media. Plus total_results and returned_count.

**Example request body:**
```json
{
  "city": "Los Angeles",
  "state": "CA",
  "limit": 25
}
```

### POST https://api.reefapi.com/crexi/v1/property_detail — 1 credit
Read one FOR-SALE listing in full: everything the search row carries plus Crexi's own fact table (asking price, property type and sub type, lot size, ground-lease flag, sale condition, and whatever else that listing publishes), the investment highlights and marketing copy as plain text, whether the listing is sold, paused, unpriced, a note/loan or run by an auctioneer, and the brokers with their title, licence number, brokerage and brokerage address. Facts Crexi keeps behind a login come back as null rather than as the row of asterisks the source sends. A listing id that is not live answers NOT_FOUND.

**Parameters:**
- `listing_id` (string, required) — Crexi's numeric listing id. It is the first number in the listing URL (https://www.crexi.com/properties/2725055/michigan-taco-bell → 2725055) and the `listing_id` of every search row. Sale and lease ids are separate number spaces: a sale id given to lease_detail answers NOT_FOUND, and the other way round.

**Returns:** listing_id, title, url (the live crexi.com page), listing_type, price (amount in USD, currency, status = published | unpriced | auction, note, and Crexi's own formatted rendering on the detail routes), property_types, property_subtypes, investment_type, building_size_sqft, status, description, brokerage_name, location (address, city, county, state, state_code, zip, country, latitude, longitude, full_address), other_locations for portfolio listings, in_opportunity_zone, is_new, activated_on, updated_on and media (thumbnail, image_count, has_video, has_virtual_tour, has_offering_memorandum, has_flyer). Plus total_results and returned_count on the envelope. Plus detail_level, facts (Crexi's own label→value table), investment_highlights, marketing_description, sale_condition, is_sold, is_unpriced, is_note_loan, is_outdated, has_auctioneer, address_hidden, created_on and brokers[] (name, title, licence number, brokerage, brokerage address).

**Example request body:**
```json
{
  "listing_id": "2725055"
}
```

### POST https://api.reefapi.com/crexi/v1/lease_detail — 1 credit
Read one LEASE listing in full: everything the lease search row carries plus Crexi's building fact table, the building highlights and marketing copy as plain text, and — the reason this action exists — the SUITE TABLE: every available space in the building with its name, rentable square feet, asking rate per square foot, rate type, space subtypes and whether a floor plan is published. A suite whose rate is undisclosed comes back with a null rate, not a zero. Lease ids are a separate number space from sale ids.

**Parameters:**
- `listing_id` (string, required) — Crexi's numeric listing id. It is the first number in the listing URL (https://www.crexi.com/properties/2725055/michigan-taco-bell → 2725055) and the `listing_id` of every search row. Sale and lease ids are separate number spaces: a sale id given to lease_detail answers NOT_FOUND, and the other way round.

**Returns:** listing_id, title, url, listing_type, rate (per_sqft_year_min/max in USD, rate_type, Crexi's formatted yearly and monthly twins, status = published | undisclosed), property_types, rentable_sqft_min/max, suite_count, status, description, brokerage_name, location, is_new, is_outdated, activated_on, updated_on and media. Plus total_results and returned_count. Plus detail_level, facts, building_highlights, marketing_description, is_single_tenant, aggregate_display_rate, created_on, brokers[] and suites[] (suite_id, name, rentable_sqft, rate_per_sqft, total_rate, rate_type, subtypes, has_floor_plan).

**Example request body:**
```json
{
  "listing_id": "2725055"
}
```

### POST https://api.reefapi.com/crexi/v1/suggest — 1 credit
Crexi's own type-ahead: turn a few typed characters into the things Crexi knows — a listing at that street address (with its listing_id, ready for property_detail), a broker, or a brokerage. Use it to go from an address a user typed to the listing id. It is NOT a place gazetteer: it never returns a city, county or ZIP id, and it is not needed for search — search takes plain city, state, county and ZIP names.

**Parameters:**
- `query` (string, required) — What the user typed. Two characters is enough.

**Returns:** A list of suggestions, each with kind (AssetAddress | Broker | Brokerage), value (what Crexi would show), subtitle (the city and state), listing_id and listing_url when the suggestion is a listing, and broker_profile_id when it is a broker. An unknown term answers an empty list, not an error.

**Example request body:**
```json
{
  "query": "Los Angeles"
}
```

## At scale
- **Volume:** 5M+ requests a day, measured at 60 requests a second across the fleet with no
  central bottleneck. Per-key limits are raised for high-volume accounts; volume pricing on request.
- **Missing a source:** tell us a site we do not cover and it becomes an engine. A customer asked
  for bestprice.gr on 21 Sep 2026 and it was in the catalog on 22 Sep.
- **Support:** 2 minute median time from a question in the live chat to the first answer. Setup
  help included, no support tier to buy.
- **One key, one credit pool** across every API. No per-site plans, no separate subscriptions.

## More
- Try it live, no code: https://reefapi.com/playground?engine=crexi
- Human docs page: https://reefapi.com/docs/crexi
- Overview page: https://reefapi.com/crexi-api
- Every ReefAPI API in one file (for your AI): https://reefapi.com/llms-full.txt
