Доступность платформы
- Состояние за 24 ч
- Норма
За последние 30 дней
Доступные возможности
Все действия Realtor: что делает каждое, сколько стоит и как работало за последние 24 часа. Откройте действие, чтобы увидеть параметры, поля ответа и примеры кода.
| Возможность | Описание | За 1000 | Состояние за 24 часа |
|---|---|---|---|
Поискsearch | Находите агентов по недвижимости на Realtor по городу и штату в keyword. | $1.39 за 1 000 запросов | Норма |
Поиск недвижимостиproperty_search | Ищите объявления о продаже жилья на Realtor по почтовому индексу США или «City, ST» в keyword с фильтрами по цене, числу спален и ванных, статусу объявления и сортировке. | $1.39 за 1 000 запросов | Норма |
Сведения об объекте недвижимостиproperty_detail | Получите один объект недвижимости на Realtor по URL страницы, ID объекта или адресу: статус, цену предложения и цену продажи, дату продажи, число спален и ванных, жилую площадь в квадратных футах и год постройки. | $1.39 за 1 000 запросов | Норма |
Откройте возможность, чтобы посмотреть её параметры, поля ответа и примеры кода, а также попробовать её в работе.
Какие параметры принимает каждое действие API Realtor?
Каждый ответ ниже описывает одно вызываемое действие и его фактические входные данные. Значение параметров и допустимые значения зависят от действия: знакомое имя параметра не обязательно означает одно и то же на всех платформах.
Ссылки на официальные источники приводятся только для пояснения расположенного рядом термина, принятого на платформе. Они не означают, что платформа предоставила разрешение или выразила одобрение. Функции официального сайта не входят в API EveryInfra, если они не перечислены на этой странице.
| Действие | Обязательные | Необязательные | Способ получения результата | Лимит | За 1 000 | Поля ответа |
|---|---|---|---|---|---|---|
searchПоиск Находите агентов по недвижимости на Realtor по городу и штату в | keyword | agent_type, min_rating | Режим выдачи: Sync | Значения в каталоге: defaultLimit=100, maxLimit=500. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $1.39 за 1 000 запросов | 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Поиск недвижимости Ищите объявления о продаже жилья на Realtor по почтовому индексу США или «City, ST» в | keyword | baths_min, beds_min, city, max_price, min_price, sort, status | Режим выдачи: Sync | Значения в каталоге: defaultLimit=20, maxLimit=200. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $1.39 за 1 000 запросов | 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Сведения об объекте недвижимости Получите один объект недвижимости на Realtor по URL страницы, ID объекта или адресу: статус, цену предложения и цену продажи, дату продажи, число спален и ванных, жилую площадь в квадратных футах и год постройки. Эти данные не заменяют осмотр, оценку или проверку права собственности. | url | — | Режим выдачи: Sync | — | $1.39 за 1 000 запросов | 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 |
Что означают параметры действия search в API Realtor?
Находите агентов по недвижимости на Realtor по городу и штату в keyword. Фильтруйте по работе с покупателями или продавцами и по минимальному рейтингу. Вы получите офис, брокера, номер лицензии и отзывы. Указанные данные не подтверждают действующую лицензию и не являются рекомендацией агента.
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
Что означают параметры действия property_search в API Realtor?
Ищите объявления о продаже жилья на Realtor по почтовому индексу США или «City, ST» в keyword с фильтрами по цене, числу спален и ванных, статусу объявления и сортировке. Цена предложения, цена продажи и их даты хранятся в отдельных полях, а результат не подтверждает, что дом ещё доступен.
keywordОбязательный- Место поиска для запросов к Realtor. В
searchукажите город и штат (например,Austin, TX), чтобы найти агентов. Вproperty_searchукажите 5-значный почтовый индекс США (ZIP) или сокращениеCity, ST. Произвольные описания объектов не принимаются. baths_minНеобязательный- Минимальное количество ванных комнат. Значение используется как целое число, поэтому половинные значения вроде 1.5 не сохраняются.
beds_minНеобязательный- Минимальное количество спален (целое число). Это не общее число комнат в объекте.
cityНеобязательный- Переопределяет название города для
property_search. При поиске по 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_desc statusНеобязательный- Один статус объявления для
property_search, передаётся строкой; по умолчаниюfor_sale. Известные значения:sold,for_rent,ready_to_build,off_market,otherиnew_community. Значение не проверяется по фиксированному списку, поэтому другие строки не отклоняются. Передавайте один статус, а не массив.
Что означают параметры действия property_detail в API Realtor?
Получите один объект недвижимости на Realtor по URL страницы, ID объекта или адресу: статус, цену предложения и цену продажи, дату продажи, число спален и ванных, жилую площадь в квадратных футах и год постройки. Эти данные не заменяют осмотр, оценку или проверку права собственности.
Полный справочник API: параметры, примеры кода, пример ответа и состояниеurlОбязательный- URL страницы объекта Realtor для
property_detail. Он должен содержать суффикс_M<digits>-<digits>, из которого извлекаетсяproperty_id. В этом поле можно также передать ID объекта или полный адрес. Для других URL без извлекаемого ID результат не гарантируется.
Как использовать API Realtor
- 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>"}}'
Вопросы об API Realtor
Какие данные можно получить через API Realtor?
Укажите в platform значение realtor. В текущем каталоге: поиск, поиск недвижимости и сведения об объекте недвижимости. Эти названия действий соответствуют разным объектам или представлениям Realtor; это не взаимозаменяемые режимы поиска.
Какие входные данные нужны для запроса search к платформе Realtor?
Место поиска для запросов к Realtor. В search укажите город и штат (например, Austin, TX), чтобы найти агентов. В property_search укажите 5-значный почтовый индекс США (ZIP) или сокращение City, ST. Произвольные описания объектов не принимаются. Передайте это значение в поле keyword объекта params.
Какие поля может вернуть search на платформе Realtor?
Объявленная схема включает name, title, text и office_name. Объявленное поле может отсутствовать в отдельной записи, а у каждого другого действия свой список полей.
Все ли действия Realtor возвращают результат сразу?
Действия с пометкой «асинхронное» возвращают ID задачи, по которому нужно опрашивать статус. Любое другое действие тоже можно запустить асинхронно: добавьте "mode": "async" в тело запроса, чтобы сразу получить ID задачи. Это удобно для длительных задач или запросов с большим лимитом. В текущем каталоге: режим выдачи: sync.