{"components":{"responses":{"Error":{"content":{"application/json":{"schema":{"properties":{"error":{"properties":{"code":{"type":"string"},"message":{"type":"string"}},"type":"object"}},"type":"object"}}},"description":"Error"}},"schemas":{"Brokerage":{"properties":{"active_listings":{"type":"integer"},"city":{"type":["string","null"]},"domain":{"type":["string","null"]},"name":{"type":"string"},"public_id":{"type":"string"},"state":{"type":["string","null"]},"website":{"type":["string","null"]}},"type":"object"},"Listing":{"properties":{"address":{"description":"Street address.","type":"string"},"attributes":{"description":"Source key/value attributes (fields=all).","type":"object"},"brochure_link":{"description":"Brochure / flyer PDF URL.","type":"string"},"brokerage":{"description":"Brokerage {public_id, name, website}.","type":"object"},"brokers":{"description":"[{name, email, phone}] \u2014 email/phone on paid plans only.","items":{},"type":"array"},"building_sf":{"description":"Building square feet.","type":"integer"},"cap_rate":{"description":"Cap rate, percent.","type":"number"},"city":{"description":"City.","type":"string"},"country":{"description":"ISO country (US).","type":"string"},"county":{"description":"County (subset of listings).","type":"string"},"county_fips":{"description":"County FIPS (subset of listings).","type":"string"},"date_created":{"description":"Created date on the source, when known.","type":"string"},"date_updated":{"description":"Updated date on the source, when known.","type":"string"},"description":{"description":"Listing description (only with fields=all or fields=description).","type":"string"},"first_seen":{"description":"First observed by ListingsFeed.","type":"string"},"hash_id":{"description":"Stable public id (20 hex chars).","type":"string"},"highlights":{"description":"Bullet highlights from the listing page.","items":{},"type":"array"},"is_active":{"description":"False once the broker removed it.","type":"boolean"},"land_acres":{"description":"Land size in acres.","type":"number"},"last_seen":{"description":"Last observed by ListingsFeed.","type":"string"},"lat":{"description":"Latitude.","type":"number"},"lease_rate_max":{"description":"Lease rate maximum as published.","type":"number"},"lease_rate_min":{"description":"Lease rate minimum as published (unit not normalized).","type":"number"},"lease_type":{"description":"NNN, gross, \u2026 as published.","type":"string"},"link":{"description":"Listing page URL.","type":"string"},"listing_type":{"description":"sale | lease | sale_lease | unknown (the broker did not state it).","type":"string"},"lng":{"description":"Longitude.","type":"number"},"name":{"description":"Listing title.","type":"string"},"photos":{"description":"Photo URLs (fields=all).","items":{},"type":"array"},"price_text":{"description":"Price as written by the broker.","type":"string"},"price_upon_request":{"description":"True when the price is on request / negotiable.","type":"boolean"},"property_subtype":{"description":"Source subtype text.","type":"string"},"property_type":{"description":"land | industrial | office | retail | multifamily | hospitality | special | other.","type":"string"},"sale_ask_psf":{"description":"Asking price per building SF, derived.","type":"number"},"sale_ask_total":{"description":"Asking sale price (USD). Null when undisclosed.","type":"number"},"state":{"description":"Two-letter state.","type":"string"},"status":{"description":"active | under_contract | sold | leased | withdrawn | closed.","type":"string"},"stories":{"description":"Stories.","type":"integer"},"superseded_by":{"description":"hash_id of the canonical record when this one was merged.","type":"string"},"transaction_lease":{"description":"True when for lease.","type":"boolean"},"transaction_sale":{"description":"True when for sale.","type":"boolean"},"units":{"description":"Units.","type":"integer"},"updated_at":{"description":"Last time the record changed here.","type":"string"},"year_built":{"description":"Year built.","type":"integer"},"zip":{"description":"ZIP code.","type":"string"}},"type":"object"},"Meta":{"properties":{"count":{"type":"integer"},"next_cursor":{"type":["string","null"]},"quota":{"properties":{"hard_cap":{"type":"integer"},"limit":{"type":"integer"},"period_end":{"type":"string"},"remaining":{"type":"integer"},"used":{"type":"integer"}},"type":"object"},"records_billed":{"type":"integer"},"source":{"type":"string"},"total":{"type":"integer"}},"type":"object"}},"securitySchemes":{"bearerAuth":{"scheme":"bearer","type":"http"}}},"info":{"contact":{"email":"support@listingsfeed.com"},"description":"US commercial real estate listings, managed and refreshed weekly. Authenticate with `Authorization: Bearer <api key>`. Usage is metered on records returned.","title":"ListingsFeed API","version":"1.0.0"},"openapi":"3.1.0","paths":{"/v1/brokerages":{"get":{"operationId":"listBrokerages","parameters":[{"in":"query","name":"state","schema":{"type":"string"}},{"in":"query","name":"q","schema":{"type":"string"}},{"in":"query","name":"limit","schema":{"type":"integer"}},{"in":"query","name":"cursor","schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"data":{"items":{"$ref":"#/components/schemas/Brokerage"},"type":"array"},"links":{"properties":{"next":{"type":["string","null"]}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"}},"type":"object"}}},"description":"Brokerages (not metered)."}},"summary":"List brokerages"}},"/v1/brokerages/{public_id}":{"get":{"operationId":"getBrokerage","parameters":[{"in":"path","name":"public_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"data":{"$ref":"#/components/schemas/Brokerage"}},"type":"object"}}},"description":"The brokerage."},"404":{"$ref":"#/components/responses/Error"}},"summary":"Get one brokerage"}},"/v1/listings":{"get":{"operationId":"listListings","parameters":[{"description":"Two-letter state code(s), comma-separated. Example: TX,OK","in":"query","name":"state","required":false,"schema":{"type":"string"}},{"description":"City name (case-insensitive exact match).","in":"query","name":"city","required":false,"schema":{"type":"string"}},{"description":"ZIP code(s), comma-separated; trailing * matches a prefix (e.g. 973*).","in":"query","name":"zip","required":false,"schema":{"type":"string"}},{"description":"County name (case-insensitive). Populated for a subset of listings.","in":"query","name":"county","required":false,"schema":{"type":"string"}},{"description":"One or more of: land, industrial, office, retail, multifamily, hospitality, special, other","in":"query","name":"property_type","required":false,"schema":{"type":"string"}},{"description":"Substring match on the source's subtype (e.g. warehouse).","in":"query","name":"property_subtype","required":false,"schema":{"type":"string"}},{"description":"sale = for sale (incl. sale/lease); lease = for lease (incl. sale/lease).","in":"query","name":"transaction","required":false,"schema":{"enum":["sale","lease"],"type":"string"}},{"description":"One or more of: active, under_contract, sold, leased, withdrawn, closed","in":"query","name":"status","required":false,"schema":{"type":"string"}},{"description":"Minimum asking sale price (USD). Accepts 1.5m / 250k.","in":"query","name":"min_price","required":false,"schema":{"type":"number"}},{"description":"Maximum asking sale price (USD).","in":"query","name":"max_price","required":false,"schema":{"type":"number"}},{"description":"Minimum building square feet.","in":"query","name":"min_sf","required":false,"schema":{"type":"number"}},{"description":"Maximum building square feet.","in":"query","name":"max_sf","required":false,"schema":{"type":"number"}},{"description":"Minimum land acres.","in":"query","name":"min_acres","required":false,"schema":{"type":"number"}},{"description":"Maximum land acres.","in":"query","name":"max_acres","required":false,"schema":{"type":"number"}},{"description":"Minimum cap rate (percent).","in":"query","name":"min_cap","required":false,"schema":{"type":"number"}},{"description":"Maximum cap rate (percent).","in":"query","name":"max_cap","required":false,"schema":{"type":"number"}},{"description":"west,south,east,north in decimal degrees.","in":"query","name":"bbox","required":false,"schema":{"type":"string"}},{"description":"lat,lng centre for a radius search (use with radius_mi).","in":"query","name":"near","required":false,"schema":{"type":"string"}},{"description":"Radius in miles around `near` (max 200).","in":"query","name":"radius_mi","required":false,"schema":{"type":"number"}},{"description":"Only listings changed after this ISO-8601 timestamp.","in":"query","name":"updated_since","required":false,"schema":{"format":"date-time","type":"string"}},{"description":"Only listings first observed after this timestamp.","in":"query","name":"first_seen_since","required":false,"schema":{"format":"date-time","type":"string"}},{"description":"Brokerage public id (from /v1/brokerages).","in":"query","name":"brokerage","required":false,"schema":{"type":"string"}},{"description":"Only listings with a numeric asking price.","in":"query","name":"has_price","required":false,"schema":{"type":"boolean"}},{"description":"Only listings with a brochure/flyer link.","in":"query","name":"has_brochure","required":false,"schema":{"type":"boolean"}},{"description":"Full-text search over name, address, city and description (web-search syntax: quoted phrases, OR, -excluded).","in":"query","name":"q","required":false,"schema":{"type":"string"}},{"description":"Include listings no longer published (plan-gated).","in":"query","name":"include_inactive","required":false,"schema":{"type":"boolean"}},{"description":"Sort column (default updated_at).","in":"query","name":"sort","required":false,"schema":{"enum":["updated_at","first_seen","sale_ask_total","building_sf","land_acres"],"type":"string"}},{"description":"Sort direction (default desc).","in":"query","name":"order","required":false,"schema":{"enum":["asc","desc"],"type":"string"}},{"description":"Page size (plan-capped; default 100).","in":"query","name":"limit","required":false,"schema":{"type":"integer"}},{"description":"Opaque cursor from the previous page's meta.next_cursor.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"description":"Comma list of fields to return, or `all`.","in":"query","name":"fields","required":false,"schema":{"type":"string"}},{"description":"Response format (default json).","in":"query","name":"format","required":false,"schema":{"enum":["json","geojson","csv"],"type":"string"}},{"description":"Add meta.total (a count query; rate-limited harder).","in":"query","name":"include_total","required":false,"schema":{"type":"boolean"}}],"responses":{"200":{"content":{"application/geo+json":{"schema":{"type":"object"}},"application/json":{"schema":{"properties":{"data":{"items":{"$ref":"#/components/schemas/Listing"},"type":"array"},"links":{"properties":{"next":{"type":["string","null"]}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"}},"type":"object"}},"text/csv":{"schema":{"type":"string"}}},"description":"A page of listings (json), a FeatureCollection (geojson) or CSV rows."},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"summary":"Search listings"}},"/v1/listings/{hash_id}":{"get":{"operationId":"getListing","parameters":[{"in":"path","name":"hash_id","required":true,"schema":{"type":"string"}},{"description":"Comma list of fields to return, or `all`.","in":"query","name":"fields","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"data":{"$ref":"#/components/schemas/Listing"},"meta":{"$ref":"#/components/schemas/Meta"}},"type":"object"}}},"description":"The listing."},"404":{"$ref":"#/components/responses/Error"}},"summary":"Get one listing"}},"/v1/stats":{"get":{"operationId":"getStats","responses":{"200":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"Counts by state, property type and transaction; last refresh."}},"summary":"Dataset statistics"}},"/v1/usage":{"get":{"operationId":"getUsage","responses":{"200":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"Quota and daily usage."}},"summary":"Your usage this period"}}},"security":[{"bearerAuth":[]}],"servers":[{"url":"https://listingsfeed.com"}]}