{ "openapi": "3.0.1", "info": { "title": "Crexi Scraper - Commercial Property Listings for Sale", "description": "Scrape crexi.com commercial listings: asking price, cap rate, square footage, units, year built, lot size, APN, zoning, address, coordinates, status, photos plus agent and brokerage contacts and 100+ fields. Search by city, ZIP or keyword with type, price and sort filters, or paste URLs.", "version": "1.1", "x-build-id": "xjtvDP077FpV3v7Kc" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/abotapi~crexi-commercial-listings-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-abotapi-crexi-commercial-listings-scraper", "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/abotapi~crexi-commercial-listings-scraper/runs": { "post": { "operationId": "runs-sync-abotapi-crexi-commercial-listings-scraper", "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/abotapi~crexi-commercial-listings-scraper/run-sync": { "post": { "operationId": "run-sync-abotapi-crexi-commercial-listings-scraper", "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", "required": [ "mode" ], "properties": { "mode": { "title": "Mode", "enum": [ "search", "url" ], "type": "string", "description": "How to start the scrape. 'search' builds crexi.com searches from your locations, property types and filters. 'url' loads the crexi.com listing URLs you paste (filter fields below are ignored in URL mode).", "default": "search" }, "locations": { "title": "Locations or keywords", "type": "array", "description": "One or more locations or keywords to search (e.g. 'Austin, TX', '90001', 'warehouse Dallas'). Each entry is scraped as its own search. Leave empty to search all listings nationwide.", "default": [], "items": { "type": "string" } }, "propertyTypes": { "title": "Property types", "type": "array", "description": "Optional property types to narrow the search (e.g. 'Multifamily', 'Office', 'Retail', 'Industrial', 'Land'). Applied across all locations.", "items": { "type": "string" } }, "states": { "title": "States (2-letter codes)", "type": "array", "description": "Only return listings located in these US states (e.g. TX, CA). Applied across all locations. Verified against the live search: TX narrows 256,631 listings to about 34,000.", "items": { "type": "string" } }, "cities": { "title": "Cities", "type": "array", "description": "Only return listings in these cities (e.g. Austin). Combine with States to disambiguate a city name.", "items": { "type": "string" } }, "priceMin": { "title": "Minimum asking price (USD)", "minimum": 0, "type": "integer", "description": "Only return listings with an asking price at or above this amount." }, "priceMax": { "title": "Maximum asking price (USD)", "minimum": 0, "type": "integer", "description": "Only return listings with an asking price at or below this amount." }, "includeUnpriced": { "title": "Include unpriced listings", "type": "boolean", "description": "Include listings that do not publish an asking price (auctions, call-for-offers). Turn off to return only priced listings.", "default": true }, "moreResults": { "title": "Get more than ~1,500 results per search", "type": "boolean", "description": "Crexi refuses to page past about 1,500 results for a single search. Turn this on to split each search into asking-price bands (plus one pass for unpriced listings) and merge the de-duplicated results. Each band is still capped at about 1,500. Search mode only.", "default": false }, "sortBy": { "title": "Sort by", "enum": [ "rank", "price", "activatedOn", "capRate" ], "type": "string", "description": "Order crexi.com returns results in.", "default": "rank" }, "sortDirection": { "title": "Sort direction", "enum": [ "Descending", "Ascending" ], "type": "string", "description": "Ascending (low to high / oldest first) or descending (high to low / newest first).", "default": "Descending" }, "urls": { "title": "Crexi.com URLs", "type": "array", "description": "Paste crexi.com links. Supported: listing detail pages (with or without the slug), api.crexi.com/assets/, search pages with a property-type filter (?types[]=Office) and state/city pages (/properties/TX/Austin). Lease listing pages (index, state and city) are not supported and are skipped with a warning. Leave the default to scrape one example of each distinct shape (a listing detail page, a property-type search and a state/city page).", "default": [ "https://www.crexi.com/properties/2597217/new-york-48-w-48th-street", "https://www.crexi.com/properties?types%5B%5D=Office", "https://www.crexi.com/properties/TX/Austin" ], "items": { "type": "string" } }, "fetchDetails": { "title": "Fetch full details", "type": "boolean", "description": "Load each listing page to add square footage, units, year built, stories, lot size, cap rate, APN, marketing description, the full image gallery and the agent and brokerage contact details. Slower and adds a small per-item charge; leave off for fast basic listings.", "default": true }, "maxItems": { "title": "Max items", "minimum": 0, "type": "integer", "description": "The single cap on this run: stop after collecting this many listings (across all searches and URLs). Set 0 for unlimited.", "default": 20 }, "maxPages": { "title": "Max pages per search", "minimum": 0, "type": "integer", "description": "Optional safety bound on how many result pages to include per search. Defaults to unlimited (leave empty or set 0) and does NOT cap the run; it defers to Max items, which is the single cap. The run stops at Max items, not here." }, "proxy": { "title": "Proxy configuration", "type": "object", "description": "Apify Proxy configuration. The datacenter default returns the same results at the lowest cost.", "default": { "useApifyProxy": true } }, "maxResidentialMB": { "title": "Residential traffic budget (MB)", "minimum": 0, "type": "integer", "description": "When using a Residential proxy group, cap residential traffic at this many MB. After the budget is reached the run auto-downgrades to the lower-cost tier (identical results). 0 = unlimited.", "default": 0 }, "resumeFromRunId": { "title": "Resume from a previous run", "type": "string", "description": "Paste a previous run ID or dataset ID to continue a large crawl of listings without returning or charging for listings already collected there. Use this after an interrupted run, or when continuing a listing pull in another run. For recurring daily monitoring of the same search, use Incremental mode below instead." }, "incrementalMode": { "title": "Incremental changes for scheduled runs", "type": "boolean", "description": "Turn this on for daily or recurring monitoring. The first run returns all matching listings as NEW. Later runs normally return only NEW, UPDATED, and REAPPEARED listings. Turn on \"Emit unchanged\" or \"Emit expired\" only when you also want those listings returned (and billed). State is kept separately for each search/URL and filter setup; use State key when you want to name or deliberately share a monitoring campaign. What is compared: every output field of the listing (price, status, type, size, cap rate, address, description, agent and brokerage details and so on) decides UPDATED, and changedFields names the ones that moved. What is excluded: scrapedAt, the result-count metadata, image, logo and photo URLs and the photo gallery list, the listing's rank in the result page, session-specific flags (saved to board, owner, download rights), and the order of lists. Use \"Ignore fields when detecting changes\" to exclude more. To continue one specific interrupted run instead, use Resume from a previous run above.", "default": false }, "stateKey": { "title": "State key (optional, incremental mode only)", "type": "string", "description": "Optional. Name this monitoring campaign to keep its state stable, or to deliberately share state across differently-configured runs. Leave empty to let the actor derive a key automatically from the location/property-type/price/sort/URL and detail settings — different searches then never mix state with each other." }, "emitUnchanged": { "title": "Emit unchanged listings (incremental mode only)", "type": "boolean", "description": "Off by default. Turn on to also return listings that have not changed since the last run, marked UNCHANGED. This returns — and bills — extra rows you already have, so leave it off unless you specifically want the full snapshot every run.", "default": false }, "emitExpired": { "title": "Emit expired listings (incremental mode only)", "type": "boolean", "description": "Off by default. Turn on to also return listings that were present in a previous run but are no longer found, marked EXPIRED. Only produced once a run has fully scanned the tracked search — not when Max items capped it or when Resume was used. This returns — and bills — extra synthetic rows, so leave it off unless you need expiry tracking.", "default": false }, "ignoreFieldsForChanges": { "title": "Ignore fields when detecting changes (incremental mode only)", "type": "array", "description": "Optional. Field names to also exclude from UPDATED detection, on top of the built-in exclusions. A plain name (for example \"description\") is ignored wherever it appears, including inside nested lists; a dotted path (for example \"details.zoning\") ignores just that path. Excluded fields stay in the output; they only stop triggering UPDATED and stop being listed in changedFields.", "items": { "type": "string" } }, "mcpConnectors": { "title": "Pipe results into your apps (optional)", "type": "array", "description": "Optionally send results into the apps you already use, via Model Context Protocol (MCP) connectors. Authorize one under Apify, Settings, API & Integrations, then select it here. Notion gets a rich page-per-item export; other connectors get a best-effort write/digest. Leave empty to skip; never changes the dataset output. Supported: Notion (https://mcp.notion.com/mcp), Linear (https://mcp.linear.app/sse), Airtable (https://mcp.airtable.com/mcp), Apify (https://mcp.apify.com)." }, "notionParentPageUrl": { "title": "Notion parent page (Notion connector only)", "type": "string", "description": "URL (or id) of the Notion page under which item pages are created. Required to enable the Notion export; ignored by other connectors." }, "maxNotifyListings": { "title": "Max items to export per connector", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Cap on items written to each connector per run. Does not affect the dataset.", "default": 50 } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }