플랫폼 가용성
- 24시간 상태
- 정상
최근 30일
제공 기능
각 Realtor 액션의 기능, 가격, 최근 24시간 상태를 확인할 수 있습니다. 액션을 열면 파라미터, 응답 필드, 코드 예제를 볼 수 있습니다.
| 기능 | 설명 | 1,000건당 | 24시간 상태 |
|---|---|---|---|
검색search | keyword에 도시와 주를 지정해 Realtor에서 부동산 중개인을 찾습니다. | 요청 1,000개당 $1.39 | 정상 |
매물 검색property_search | keyword에 미국 ZIP 코드 또는 City, ST 형식을 넣어 Realtor 주택 매물을 검색하며, 가격, 침실 수, 욕실 수, 매물 상태, 정렬 순서로 필터링할 수 있습니다. | 요청 1,000개당 $1.39 | 정상 |
매물 상세 정보property_detail | 상세 URL, 매물 ID 또는 주소로 Realtor 매물 하나를 가져옵니다. | 요청 1,000개당 $1.39 | 정상 |
기능을 열면 파라미터, 응답 필드, 코드 샘플을 확인하고 직접 사용해 볼 수 있습니다.
Realtor 액션별로 어떤 입력을 받나요?
아래 각 답변은 호출 가능한 액션 하나와 실제 입력값을 짝지어 보여 줍니다. 파라미터의 의미와 허용 값은 액션마다 다릅니다. 익숙한 이름이라도 모든 플랫폼에서 같은 의미를 갖지는 않습니다.
공식 출처 링크는 옆에 있는 플랫폼 용어를 설명하기 위한 것입니다. 플랫폼의 승인이나 보증을 의미하지 않으며, 이 페이지에 명시되지 않은 공식 사이트의 기능은 EveryInfra API에 포함되지 않습니다.
| 액션 | 필수 | 선택 | 전달 방식 | 한도 | 1,000건당 | 응답 필드 |
|---|---|---|---|---|---|---|
search검색
| keyword | agent_type, min_rating | Sync 응답 | 카탈로그 값: defaultLimit=100, maxLimit=500. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $1.39 | id · name · url · title · text · office_name · broker_name · city · state · postal_code · country · license_no · rating · rating_scale · review_count · active_listings · recently_sold · price_min · price_max · specialties · languages · served_areas · emails · phones · image_url · platform |
property_search매물 검색
| keyword | baths_min, beds_min, city, max_price, min_price, sort, status | Sync 응답 | 카탈로그 값: defaultLimit=20, maxLimit=200. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $1.39 | id · url · title · status · price · sold_price · sold_at · listed_at · property_type · beds · baths · area_sqft · lot_sqft · year_built · address · city · state · postal_code · county · lat · lng · image_url · photo_count · is_new_listing · is_price_reduced · is_foreclosure · advertiser_emails · advertiser_phones · platform |
property_detail매물 상세 정보 상세 URL, 매물 ID 또는 주소로 Realtor 매물 하나를 가져옵니다. 상태, 등록 가격과 매매 가격, 매매일, 침실 수, 욕실 수, 실내 면적(제곱피트), 건축 연도를 받을 수 있습니다. 주택 점검, 감정평가, 권원 조사를 대신하지는 않습니다. | url | — | Sync 응답 | — | 요청 1,000개당 $1.39 | id · url · title · status · price · sold_price · sold_at · updated_at · property_type · beds · baths · area_sqft · year_built · address · city · state · postal_code · platform |
Realtor search 파라미터는 각각 무엇을 의미하나요?
keyword에 도시와 주를 지정해 Realtor에서 부동산 중개인을 찾습니다. 매수자 또는 매도자 중심 여부와 최소 평점으로 필터링할 수 있습니다. 사무소, 중개업체, 면허 번호, 리뷰를 받을 수 있습니다. 표시된 정보가 현재 유효한 면허를 확인하거나 중개인을 추천하는 것은 아닙니다.
keyword필수- Realtor 요청의 검색 위치를 지정합니다.
search에서는 도시와 주(예:Austin, TX)를 입력해 중개인을 찾습니다.property_search에서는 5자리 미국 ZIP 코드 또는City, ST약어 형식을 입력합니다. 임의의 매물 설명은 받지 않습니다. agent_type선택search의 중개인 유형을 지정합니다. 허용 값은both(매수·매도 측 중개인 모두 포함, 기본값),buyer(매수 측 중개인만),seller(매도 측 중개인만)입니다. 매물 상태를 나타내는 파라미터가 아닙니다.허용 값:bothbuyersellerRealtor: 매수인 측 에이전트와 매도인 측 에이전트의 차이 — Realtor의 에이전트 검색은 에이전트를 Buy, Sell, Both로 분류하며, 매수인 측 에이전트와 매물을 등록하는 매도인 측 에이전트의 역할이 다르다고 설명합니다. 이는 중개인 유형을 설명하기 위한 것이며, EveryInfra가 부동산 중개 대리 서비스를 제공한다는 뜻은 아닙니다. · 확인일min_rating선택search에서 최소 평점으로 중개인을 필터링합니다.["4"]처럼 문자열 배열을 전달해야 합니다. 허용 값은0,1,2,3,4,5이며,0은 필터링을 해제합니다. 매물 평점이 아니라 중개인 평점을 필터링합니다.허용 값:012345
Realtor property_search 파라미터는 각각 무엇을 의미하나요?
keyword에 미국 ZIP 코드 또는 City, ST 형식을 넣어 Realtor 주택 매물을 검색하며, 가격, 침실 수, 욕실 수, 매물 상태, 정렬 순서로 필터링할 수 있습니다. 등록 가격, 매매 가격과 각 날짜는 별도 필드로 제공되며, 결과가 해당 주택이 아직 매물로 나와 있음을 확인해 주지는 않습니다.
keyword필수- Realtor 요청의 검색 위치를 지정합니다.
search에서는 도시와 주(예:Austin, TX)를 입력해 중개인을 찾습니다.property_search에서는 5자리 미국 ZIP 코드 또는City, ST약어 형식을 입력합니다. 임의의 매물 설명은 받지 않습니다. baths_min선택- 최소 욕실 수를 설정합니다. 값은 정수로 처리되므로 욕실 1.5개처럼 반 욕실이 포함된 값은 유지할 수 없습니다.
beds_min선택- 최소 침실 수를 정수로 설정합니다. 매물의 전체 방 개수가 아닙니다.
city선택property_search의 도시 이름을 재정의합니다. ZIP 코드로 검색할 때 서로 모순되는 위치 조건이 생성되지 않도록 ZIP 코드와 일치하지 않는 도시를 전달해서는 안 됩니다.max_price선택- 표준 입력의 최대 매물 가격을 지정하며, 같은 요청에서
price_max보다 우선합니다. 매매 매물과 임대 매물의 가격은 별도로 해석해야 합니다. 필터링에는 정수를 사용하며 소수는 올림합니다. 예를 들어 145.98은 146이 됩니다. min_price선택- 표준 입력의 최소 매물 가격을 지정하며, 같은 요청에서
price_min보다 우선합니다. 중개 수수료가 아니라 매물 가격을 필터링합니다. 필터링은 정수 기준이며 소수점은 내림 처리됩니다(39.81은 39). sort선택property_search의 매물 정렬 순서로, 항상 내림차순입니다. 값은newest(최신 매물순, 기본값),price_desc(호가),sold_price_desc(매매가),recently_sold,bedrooms_desc,lot_size_desc,photo_count_desc,recently_updated중 하나입니다. 오름차순 옵션이 없으므로 최저가부터 정렬할 수 없습니다.허용 값:bedrooms_desclot_size_descnewestphoto_count_descprice_descrecently_soldrecently_updatedsold_price_descstatus선택property_search의 매물 상태 하나를 문자열로 전달하며, 기본값은for_sale입니다. 알려진 값은sold,for_rent,ready_to_build,off_market,other,new_community입니다. 고정 목록과 대조하지 않으므로 다른 문자열도 거부되지 않습니다. 배열이 아닌 단일 상태를 전달하세요.
Realtor property_detail 파라미터는 각각 무엇을 의미하나요?
상세 URL, 매물 ID 또는 주소로 Realtor 매물 하나를 가져옵니다. 상태, 등록 가격과 매매 가격, 매매일, 침실 수, 욕실 수, 실내 면적(제곱피트), 건축 연도를 받을 수 있습니다. 주택 점검, 감정평가, 권원 조사를 대신하지는 않습니다.
전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태url필수property_detail에 사용할 Realtor 상세 페이지 URL을 지정합니다.property_id를 추출할 수 있도록_M<digits>-<digits>접미사가 포함되어야 합니다. 이 필드에 매물 ID나 전체 주소를 전달해도 됩니다. 추출 가능한 ID가 없는 다른 URL은 정상 처리를 보장하지 않습니다.
Realtor 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":"realtor","action":"search","params":{"keyword":"<keyword>"}}'
Realtor API 자주 묻는 질문
Realtor API로 무엇을 가져올 수 있나요?
platform을 realtor 값으로 설정하세요. 현재 카탈로그에 등록된 항목은 검색, 매물 검색 및 매물 상세 정보입니다. 각 액션 이름은 서로 다른 Realtor 객체나 뷰를 가리키며, 서로 바꿔 쓸 수 있는 검색 모드가 아닙니다.
Realtor search 요청에는 어떤 입력이 필요한가요?
Realtor 요청의 검색 위치를 지정합니다. search에서는 도시와 주(예: Austin, TX)를 입력해 중개인을 찾습니다. property_search에서는 5자리 미국 ZIP 코드 또는 City, ST 약어 형식을 입력합니다. 임의의 매물 설명은 받지 않습니다. params 안의 keyword 필드로 전달하세요.
Realtor search 액션은 어떤 필드를 반환하나요?
선언된 스키마에 포함된 필드는 name, title, text 및 office_name입니다. 선언된 필드라도 개별 레코드에는 없을 수 있으며, 다른 액션은 각각 고유한 필드 목록을 가집니다.
모든 Realtor 액션이 즉시 결과를 반환하나요?
비동기로 표시된 액션은 폴링할 작업 ID를 반환합니다. 그 밖의 모든 액션도 비동기로 실행할 수 있습니다. 요청 본문에 "mode": "async"를 추가하면 작업 ID를 즉시 받을 수 있어, 오래 걸리는 작업이나 조회 한도가 큰 요청에 유용합니다. 현재 카탈로그의 액션 구성은 sync 응답입니다.