플랫폼 가용성
- 24시간 상태
- 정상
최근 30일
제공 기능
각 Crexi 액션의 기능, 가격, 최근 24시간 상태를 확인할 수 있습니다. 액션을 열면 파라미터, 응답 필드, 코드 예제를 볼 수 있습니다.
Crexi 액션별로 어떤 입력을 받나요?
아래 각 답변은 호출 가능한 액션 하나와 실제 입력값을 짝지어 보여 줍니다. 파라미터의 의미와 허용 값은 액션마다 다릅니다. 익숙한 이름이라도 모든 플랫폼에서 같은 의미를 갖지는 않습니다.
공식 출처 링크는 옆에 있는 플랫폼 용어를 설명하기 위한 것입니다. 플랫폼의 승인이나 보증을 의미하지 않으며, 이 페이지에 명시되지 않은 공식 사이트의 기능은 EveryInfra API에 포함되지 않습니다.
| 액션 | 필수 | 선택 | 전달 방식 | 한도 | 1,000건당 | 응답 필드 |
|---|---|---|---|---|---|---|
search검색 Crexi에서 매매 또는 임대용 상업용 부동산을 찾습니다. 주소, 호가, 면적(제곱피트), 부동산 유형, 상태, 중개사, 기회 구역(opportunity zone) 여부를 가져옵니다. | keyword | max_price, min_price, property_types, sort, state, states, transaction_type | Sync 응답 | 카탈로그 값: defaultLimit=20, maxLimit=100. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $1.39 | id · url · name · text · address · city · county · state · postal_code · latitude · longitude · price · area_sqft · property_types · status · brokerage_name · posted_at · updated_at · image_url · is_sold · is_unpriced · in_opportunity_zone · platform |
property_detail매물 상세 정보 숫자 ID나 /properties/ 링크로 Crexi 상업용 부동산 매물 하나를 조회해 주요 특징, 호가, 전체 주소, 세부 유형, 임차 현황, 점유율, 층수, 등록일을 가져옵니다. 텍스트로만 된 슬러그와 /lease/ 경로는 조회되지 않으며, 누락된 값을 추정해서는 안 됩니다. | url | — | Sync 응답 | — | 요청 1,000개당 $1.39 | id · url · name · text · highlights · status · price · address · city · county · state · postal_code · lat · lng · property_types · property_subtypes · tenancy · occupancy · stories · listed_at · updated_at · platform |
Crexi search 파라미터는 각각 무엇을 의미하나요?
Crexi에서 매매 또는 임대용 상업용 부동산을 찾습니다. 주소, 호가, 면적(제곱피트), 부동산 유형, 상태, 중개사, 기회 구역(opportunity zone) 여부를 가져옵니다. keyword, state, states에 미국 주 코드를 넣으면 주별로 필터링됩니다. 가격 필터를 적용해도 가격이 없는 매물이 반환될 수 있습니다.
keyword필수- Crexi 상업용 부동산 검색의 필수 파라미터이며, 미국 주 우편 코드(예: TX, CA, FL)로 지정하면 자유 텍스트 매물 제목 검색이 아니라 주 필터로 동작합니다. state나 states를 지정하면 이 선택보다 우선하지만, keyword는 여전히 필수입니다.
max_price선택- Crexi 매물을 최대 호가(USD) 기준으로 필터링합니다. 소수점 값은 검색 요청 전에 정수로 올림 처리됩니다. 공개 호가가 없는 매물도 결과에 포함될 수 있으므로, 이 파라미터를 지정해도 반환되는 모든 매물에 가격이 있다고 보장되지 않습니다.
min_price선택- 최저 호가(USD)로 매물을 필터링합니다. 숫자 값을 받으며 정수를 권장합니다. 이 파라미터는 자본환원율이나 평방피트당 가격을 평가하지 않으며, property_detail 직접 요청에서는 무시됩니다. 소수점 이하는 버립니다.
property_types선택- Office, Retail, Multifamily 등 자산 유형을 문자열 또는 문자열 배열로 지정해 상업용 부동산을 필터링합니다. 주거용 평면 구조가 아닌 검색 필터링에만 적용되며, property_detail로 매물을 직접 조회하는 요청에서는 무시됩니다.
sort선택- Crexi 검색 결과를 relevance(디렉터리 일치도, 기본값) 또는 newest(등록일 순) 기준 내림차순으로 정렬합니다. last_updated 타임스탬프나 자본환원율로는 정렬하지 않으며, ID로 매물을 직접 조회할 때는 무시됩니다.허용 값:
newestrelevance state선택- TX 같은 미국 주 우편 코드 하나로 필터링합니다. states를 생략한 경우에만 읽으며, keyword를 통한 주 필터링보다 우선합니다. 여러 주를 동시에 조회하려면 states 배열을 사용해야 합니다.
states선택- TX 또는 ["TX", "CA"]처럼 미국 주 우편 코드를 문자열 또는 문자열 배열로 지정해 검색 결과를 필터링하며, 값은 자동으로 대문자로 변환됩니다. 우선순위는 states, state, keyword 순입니다. 주 코드만 허용하며 도시 이름이나 국가 코드는 받지 않습니다.
transaction_type선택- 거래 유형으로 매물을 필터링하며, sale(기본값) 또는 lease를 지정합니다. 대소문자는 구분하지 않습니다. rent 등 그 밖의 값은 sale로 전환되지 않고 422를 반환합니다.허용 값:
leasesaleCrexi: 매매 및 임대 매물 검색 — Crexi 검색 문서는 매매(Sale) 매물과 임대(Lease) 매물을 구분합니다. 이 참고 자료는 거래 유형만 다루며, 원문에 언급된 지도 레이어, 인구통계 데이터, 교통량 기능이 이 엔드포인트에 포함된다는 뜻은 아닙니다. · 확인일
Crexi property_detail 파라미터는 각각 무엇을 의미하나요?
숫자 ID나 /properties/ 링크로 Crexi 상업용 부동산 매물 하나를 조회해 주요 특징, 호가, 전체 주소, 세부 유형, 임차 현황, 점유율, 층수, 등록일을 가져옵니다. 텍스트로만 된 슬러그와 /lease/ 경로는 조회되지 않으며, 누락된 값을 추정해서는 안 됩니다.
전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태url필수- 숫자 매물 ID가 포함된 Crexi 전체 URL(예: /properties/<ID>) 또는 검색 결과의 id 필드에서 추출한 숫자 ID 문자열로 대상 매물을 지정합니다. 텍스트 슬러그만 있는 URL은 해석할 수 없으며, /lease/<ID> 링크는 상세 정보 조회에 사용할 수 없습니다.
Crexi API 사용 방법
- 01공개 카탈로그에서 플랫폼 액션을 선택합니다.
- 02플랫폼, 액션, 필수 파라미터를 POST /api/v1/social로 보냅니다.
- 03응답에서 결과를 읽습니다. 비동기 액션이면 반환된 작업 ID를 폴링합니다.
- 04애플리케이션에 필요한 응답 필드를 저장합니다.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"crexi","action":"search","params":{"keyword":"<keyword>"}}'
Crexi API 자주 묻는 질문
Crexi API로 무엇을 가져올 수 있나요?
platform을 crexi 값으로 설정하세요. 현재 카탈로그에 등록된 항목은 검색 및 매물 상세 정보입니다. 각 액션 이름은 서로 다른 Crexi 객체나 뷰를 가리키며, 서로 바꿔 쓸 수 있는 검색 모드가 아닙니다.
Crexi search 요청에는 어떤 입력이 필요한가요?
Crexi 상업용 부동산 검색의 필수 파라미터이며, 미국 주 우편 코드(예: TX, CA, FL)로 지정하면 자유 텍스트 매물 제목 검색이 아니라 주 필터로 동작합니다. state나 states를 지정하면 이 선택보다 우선하지만, keyword는 여전히 필수입니다. params 안의 keyword 필드로 전달하세요.
Crexi search 액션은 어떤 필드를 반환하나요?
선언된 스키마에 포함된 필드는 name, text, address 및 city입니다. 선언된 필드라도 개별 레코드에는 없을 수 있으며, 다른 액션은 각각 고유한 필드 목록을 가집니다.
모든 Crexi 액션이 즉시 결과를 반환하나요?
비동기로 표시된 액션은 폴링할 작업 ID를 반환합니다. 그 밖의 모든 액션도 비동기로 실행할 수 있습니다. 요청 본문에 "mode": "async"를 추가하면 작업 ID를 즉시 받을 수 있어, 오래 걸리는 작업이나 조회 한도가 큰 요청에 유용합니다. 현재 카탈로그의 액션 구성은 sync 응답입니다.