# Crexi 关键词搜索 API (crexi.search)

- Canonical page: [https://everyinfra.com/crexi-api/search](https://everyinfra.com/crexi-api/search?utm_medium=ai_doc&utm_campaign=page_md)
- Endpoint: POST https://api.everyinfra.com/api/v1/social with {"platform": "crexi", "action": "search", "params": {...}}
- Price: $0.001389 per call ($1.39 per 1,000 requests); failed calls and empty results are not charged
- Returns: list, default 20, max 100 per call
- Mode: sync; add "mode": "async" for slow tasks

## Health

- Live health (24h percent, hourly and daily trends): https://api.everyinfra.com/api/v1/social/availability?platform=crexi&action=search

## Parameters

| name | type | required | default | description |
|---|---|---|---|---|
| keyword | not declared | yes | not declared | Crexi 商业地产搜索的美国州代码，例如 TX、CA、FL，不是物业名称全文搜索；提供 states 或 state 时会覆盖这个州选择，但请求仍需包含必填 keyword。 |
| max_price | integer | no | not declared | 搜索挂牌要价上限，以 USD 表示，带小数时向上取整。即使有价格条件，结果仍可能包含未公开要价的物业；不能保证每条都有价格。 |
| min_price | integer | no | not declared | 搜索挂牌要价下限，以 USD 表示；传数字，建议整数。它不是资本化率或每平方英尺价格；直接 property_detail 查询忽略搜索筛选。带小数时向下取整。 |
| property_types | not declared | no | not declared | 商业地产资产类型，英文字符串或字符串数组，例如 Office（办公）、Retail（零售）、Multifamily（多户住宅）。这是搜索筛选，不是住宅户型；property_detail 的直接 ID 查询忽略这些筛选。 |
| sort | enum: newest / relevance | no | not declared | 搜索排序：relevance 为目录相关度，newest 为房源发布顺序；均按降序，默认 relevance。不是 last_updated 或资本化率排序；直接 ID 查询不使用排序。 |
| state | not declared | no | not declared | 单个美国州代码，例如 TX；states 未提供时才读取，并优先于 keyword。查询多个州建议使用 states 数组。 |
| states | not declared | no | not declared | 美国州代码，可传字符串或数组，例如 TX 或 ["TX", "CA"]，会转换为大写。优先级为 states > state > keyword；不是城市名或国家码。 |
| transaction_type | enum: lease / sale | no | not declared | 搜索交易类型只接受 sale（出售）或 lease（出租），忽略大小写；省略时默认 sale。rent 等其他显式值会在公开 API 参数校验阶段返回 422，不会静默改成出售。 |
| limit | integer (1–100) | no | 20 | 这次调用最多返回的条数，整数，1–100；不传按默认值，实际返回可能少于这个数。超过上限会在扣费前返回 422。 |

## Response fields (items in `results`)

| field | meaning |
|---|---|
| id | 该记录在原平台上的唯一标识。仅在同一平台内唯一，跨平台可能重复。 |
| url | 该记录在原平台上的可访问链接。 |
| name | 名称。用于账号/商品/商家类能力，指该对象本身的名字。 |
| text | 正文内容，已去除 HTML 标签，全文返回、不截断（个别平台的列表结果本身只有摘要，以该平台的字段说明为准）。 |
| address | 详细地址，原文透传。 |
| city | 城市名，用原平台的语言书写，未做中英归一。 |
| county | 所属县。 |
| state | 州。 |
| postal_code | 邮编。 |
| latitude | 纬度。 |
| longitude | 经度。 |
| price | 价格数值，不含货币符号；币种见 currency。 |
| area_sqft | 面积，平方英尺。 |
| property_types | 物业类型（办公/零售/工业/多户）。 |
| status | 状态。 |
| brokerage_name | 经纪公司。 |
| posted_at | 发布时间，ISO 8601 格式、UTC 时区（如 2026-08-07T12:34:56+00:00）。平台只给非标准字符串时原样透传，解析前建议做容错。null 表示平台未公开。 |
| updated_at | 更新时间。 |
| image_url | 图片链接。多图能力可能返回 image_urls 数组。 |
| is_sold | 是否已成交。 |
| is_unpriced | 是否未标价。商业地产大量标的是「询价」，筛选时注意。 |
| in_opportunity_zone | 是否在机会区（美国税收优惠区，影响投资回报计算）。 |
| platform | 数据来源平台标识，与请求里的 platform 一致（如 xiaohongshu、tiktok）。 |

## Example

```bash
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "crexi",
  "action": "search",
  "params": {
    "keyword": "TX"
  }
}'
```

```python
import os
import requests

response = requests.post(
    "https://api.everyinfra.com/api/v1/social",
    headers={"Authorization": f"Bearer {os.environ['EVERYINFRA_API_KEY']}"},
    json={
        "platform": "crexi",
        "action": "search",
        "params": {
            "keyword": "TX",
        },
    },
    timeout=120,
)
print(response.status_code)
print(response.json())
```

## Response example

Real response to the example request above, captured 2026-10-24T18:28:34Z. `results` and `count` are real with personal information (names, handles, avatars, profile links, contact details) removed; the list keeps the first 2 of 20. `id`, `billing` and `quota` differ on every call, so only their shape is shown.

```text
{
  "id": "req_…",
  "platform": "crexi",
  "action": "search",
  "results": [
    {
      "id": 2732214,
      "url": "https://www.crexi.com/properties/texas-san-antonio-express-car-wash-scrub-a-doo",
      "name": "San Antonio Express Car Wash - Scrub-a-Doo",
      "text": "Surrounded by dense residential growth, national retailers, and ongoing infrastructure",
      "address": "8050 Culebra Road, San Antonio, Bexar County, TX 78251",
      "city": "San Antonio",
      "county": "Bexar County",
      "state": "TX",
      "postal_code": "78251",
      "latitude": 29.46587805,
      "longitude": -98.64623452,
      "price": 500000,
      "area_sqft": 4411,
      "property_types": [
        "Special Purpose"
      ],
      "status": "Auction",
      "brokerage_name": "Attlee Realty LLC",
      "posted_at": "2026-10-07T18:53:24.221000+00:00",
      "updated_at": "2026-10-22T16:08:31.758000+00:00",
      "image_url": "https://crexi.com/images/format=auto,width=716,height=444,fit=cover/assets/2732214/8b2b7081ca804b56ba797b76ee4dcac4.jpg",
      "is_sold": false,
      "is_unpriced": false,
      "in_opportunity_zone": false,
      "platform": "crexi"
    },
    {
      "id": 2725313,
      "url": "https://www.crexi.com/properties/texas-former-preschool-facility",
      "name": "Former Preschool Facility",
      "text": "Ideal for an Owner-User | Dallas-Fort Worth MSA",
      "address": "427 Boss Range Rd, Justin, Denton County, TX 76247",
      "city": "Justin",
      "county": "Denton County",
      "state": "TX",
      "postal_code": "76247",
      "latitude": 33.0791318,
      "longitude": -97.3083275,
      "price": 225000,
      "area_sqft": 9619,
      "property_types": [
        "Retail"
      ],
      "status": "Auction",
      "brokerage_name": "SRS Real Estate Partners - Global Company",
      "posted_at": "2026-10-13T17:35:03.613000+00:00",
      "updated_at": "2026-10-22T15:37:34.775000+00:00",
      "image_url": "https://crexi.com/images/format=auto,width=716,height=444,fit=cover/assets/2725313/270a42217143400b9dbc2986945aefa8.JPG",
      "is_sold": false,
      "is_unpriced": false,
      "in_opportunity_zone": false,
      "platform": "crexi"
    }
  ],
  "count": 20,
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}
```

## Also

- Capability catalog (no key): https://api.everyinfra.com/api/v1/social/catalog?platform=crexi
- OpenAPI: https://everyinfra.com/openapi.json · Agents guide: https://everyinfra.com/agents.md
