Доступность платформы
- Состояние за 24 ч
- Норма
За последние 30 дней
Доступные возможности
Все действия Zillow: что делает каждое, сколько стоит и как работало за последние 24 часа. Откройте действие, чтобы увидеть параметры, поля ответа и примеры кода.
| Возможность | Описание | За 1000 | Состояние за 24 часа |
|---|---|---|---|
Поискsearch | Находите дома на Zillow в городе, районе или по ZIP-коду, до 200 за вызов. | $1.39 за 1 000 запросов | Норма |
Поиск по почтовому индексу (ZIP)zip_search | Получите список домов на Zillow для одного или нескольких ZIP-кодов США, до 200 за вызов. | $1.39 за 1 000 запросов | Норма |
Данные объекта размещенияprofile | Найдите объект недвижимости на Zillow по ссылке homedetails: история цен, диапазон Zestimate, налоги, взнос HOA, школы, агент, указанный в объявлении, и номер MLS. | $1.39 за 1 000 запросов | Норма |
Сведения об объекте недвижимостиproperty_detail | Получите объект недвижимости Zillow по ссылке или адресу. | $1.39 за 1 000 запросов | Норма |
Агентыagents | Находите агентов по недвижимости на Zillow в штате США, до 200 за вызов. | $1.39 за 1 000 запросов | Норма |
Откройте возможность, чтобы посмотреть её параметры, поля ответа и примеры кода, а также попробовать её в работе.
Какие параметры принимает каждое действие API Zillow?
Каждый ответ ниже описывает одно вызываемое действие и его фактические входные данные. Значение параметров и допустимые значения зависят от действия: знакомое имя параметра не обязательно означает одно и то же на всех платформах.
Ссылки на официальные источники приводятся только для пояснения расположенного рядом термина, принятого на платформе. Они не означают, что платформа предоставила разрешение или выразила одобрение. Функции официального сайта не входят в API EveryInfra, если они не перечислены на этой странице.
| Действие | Обязательные | Необязательные | Способ получения результата | Лимит | За 1 000 | Поля ответа |
|---|---|---|---|---|---|---|
searchПоиск Находите дома на Zillow в городе, районе или по ZIP-коду, до 200 за вызов. Получите цену, статус, число спален и санузлов, площадь в квадратных футах, Zestimate и срок экспозиции. | keyword | category, max_price, min_price, sort | Режим выдачи: Sync | Значения в каталоге: defaultLimit=20, maxLimit=200. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $1.39 за 1 000 запросов | zpid · url · status · status_type · price · currency · address · street · city · state · zipcode · latitude · longitude · beds · baths · area_sqft · home_type · home_status · zestimate · rent_zestimate · tax_assessed_value · lot_area_value · lot_area_unit · days_on_zillow · broker_name · is_zillow_owned · has_3d_model · has_video · image_url · platform |
zip_searchПоиск по почтовому индексу (ZIP) Получите список домов на Zillow для одного или нескольких ZIP-кодов США, до 200 за вызов. Вы получите цену, статус, число спален и санузлов, площадь в квадратных футах, Zestimate и брокера, указанного в объявлении. Комбинируйте фильтры «продажа», «аренда» и «продано» с ценовым диапазоном или пресетом | zip | days_on_zillow, for_rent, for_sale_by_agent, for_sale_by_owner, max_price, min_price, sold | Режим выдачи: Sync | Значения в каталоге: defaultLimit=20, maxLimit=200. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $1.39 за 1 000 запросов | zpid · url · status · status_type · price · currency · address · street · city · state · zipcode · latitude · longitude · beds · baths · area_sqft · home_type · home_status · zestimate · rent_zestimate · tax_assessed_value · lot_area_value · lot_area_unit · days_on_zillow · broker_name · is_zillow_owned · has_3d_model · has_video · image_url · platform |
profileДанные объекта размещения Найдите объект недвижимости на Zillow по ссылке homedetails: история цен, диапазон Zestimate, налоги, взнос HOA, школы, агент, указанный в объявлении, и номер MLS. | url | property_status | Режим выдачи: Sync | — | $1.39 за 1 000 запросов | zpid · url · home_status · home_type · price · currency · address · city · state · zipcode · county · latitude · longitude · beds · baths · area_sqft · lot_area_value · lot_area_unit · year_built · price_per_sqft · hoa_fee · has_garage · parking_capacity · zestimate · rent_zestimate · zestimate_low_percent · zestimate_high_percent · tax_assessed_value · tax_assessed_year · property_tax_rate · last_sold_price · last_sold_at · days_on_zillow · photo_count · description · listing_agent · listing_agent_phone · listing_broker · mls_id · mls_name · platform · images · price_history · schools |
property_detailСведения об объекте недвижимости Получите объект недвижимости Zillow по ссылке или адресу. Вы получите адрес, координаты, цену, Zestimate, оценку арендной платы, налоговую стоимость, число спален и санузлов, площадь, участок и год постройки. | url | — | Режим выдачи: Sync | — | $1.39 за 1 000 запросов | id · url · address · city · state · postal_code · latitude · longitude · price · zestimate · rent_zestimate · tax_assessed_value · status · home_type · bedrooms · bathrooms · area_sqft · lot_size · year_built · days_on_market · text · image_url · photo_count · platform |
agentsАгенты Находите агентов по недвижимости на Zillow в штате США, до 200 за вызов. Получите брокерскую компанию, адрес, телефон, рейтинг, число отзывов и бейдж топ-агента. | keyword | brokerage, city, min_rating | Режим выдачи: Sync | Значения в каталоге: defaultLimit=20, maxLimit=200. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $1.39 за 1 000 запросов | id · url · name · business_name · types · address · city · state · postal_code · phone · rating · rating_scale · review_count · is_top_agent · avatar_url · platform |
Что означают параметры действия search в API Zillow?
Находите дома на Zillow в городе, районе или по ZIP-коду, до 200 за вызов. Получите цену, статус, число спален и санузлов, площадь в квадратных футах, Zestimate и срок экспозиции. category задаёт тип местоположения, а не тип жилья. Zestimate — модельная оценка, а не цена продажи или цена в объявлении.
keywordОбязательный- Город, регион или ZIP-код для
search. Вagentsэто аббревиатура штата США, напримерTX, а не запрос по имени агента. categoryНеобязательный- Тип местоположения для
search(не тип жилья):auto_detect,address,borough,city,county,flex_region,neighborhood,school,stateилиzipcode.Допустимые значения:addressauto_detectboroughcitycountyflex_regionneighborhoodschoolstatezipcode max_priceНеобязательный- Фильтр максимальной цены объявления для
searchиzip_search. Вzip_searchпереопределяетprice_max. Это не верхняя граница оценки стоимости жилья Zillow. Фильтрация использует целые числа: дробные значения округляются вверх (145.98 становится 146). min_priceНеобязательный- Стандартное поле минимальной цены для
searchиzip_search. Вzip_searchпереопределяетprice_min. Это не комиссия агента. Фильтрация использует целые числа: дробные значения округляются вниз (39.81 становится 39). sortНеобязательный- Порядок объявлений для
search:relevance,newest(новые объявления),recently_changed,price_ascилиprice_desc(по возрастанию или убыванию цены),bedrooms,bathrooms,sqft(внутренняя площадь),lot_sizeилиyear_built.Допустимые значения:bathroomsbedroomslot_sizenewestprice_ascprice_descrecently_changedrelevancesqftyear_built
Что означают параметры действия zip_search в API Zillow?
Получите список домов на Zillow для одного или нескольких ZIP-кодов США, до 200 за вызов. Вы получите цену, статус, число спален и санузлов, площадь в квадратных футах, Zestimate и брокера, указанного в объявлении. Комбинируйте фильтры «продажа», «аренда» и «продано» с ценовым диапазоном или пресетом days_on_zillow. При нескольких ZIP-кодах limit ограничивает общее число, а не число для каждого кода.
zipОбязательный- ZIP-код США для
zip_search, желательно строкой из пяти символов, чтобы сохранить ведущие нули. Также принимаются строка из ZIP-кодов, разделённых запятыми или пробелами, и массив ZIP-кодов. При указании нескольких ZIP-кодов применяются фактические правила оплаты запросов: такой запрос не считается бесплатным пакетным запросом. При нескольких ZIP-кодахlimitограничивает общее число объявлений, возвращаемых вызовом, а не число на каждый ZIP-код. days_on_zillowНеобязательный- Предустановленный период для
zip_search: пустое значение — без ограничения;1,7,14,30или90— в днях;6m,12m,24mили36m— в месяцах. Обычно это срок с момента публикации объявления, а для проданного жилья — срок с момента продажи. Это не произвольное число дней и не оценка качества.Допустимые значения:112m1424m3036m6m790 for_rentНеобязательный- Логическое значение JSON, включающее объявления об аренде в
zip_search. Не исключает другие статусы и может сочетаться с другими фильтрами статуса. Не передавайте строку"false". for_sale_by_agentНеобязательный- Логическое значение JSON, включающее объекты, выставленные агентами, в
zip_search. По умолчанию равно true, только если не выбран статус продажи собственником, аренды или проданного объекта; выбор другого статуса отменяет это неявное значение по умолчанию. for_sale_by_ownerНеобязательный- Логическое значение JSON, включающее объекты, выставленные собственниками, в
zip_search. Не доказывает, что сделка обходится без комиссии или расходов на посредников. max_priceНеобязательный- Фильтр максимальной цены объявления для
searchиzip_search. Вzip_searchпереопределяетprice_max. Это не верхняя граница оценки стоимости жилья Zillow. Фильтрация использует целые числа: дробные значения округляются вверх (145.98 становится 146). min_priceНеобязательный- Стандартное поле минимальной цены для
searchиzip_search. Вzip_searchпереопределяетprice_min. Это не комиссия агента. Фильтрация использует целые числа: дробные значения округляются вниз (39.81 становится 39). soldНеобязательный- Логическое значение JSON, включающее проданные объекты в
zip_search. Не гарантирует, что в каждом районе публикуется сумма сделки.
Что означают параметры действия profile в API Zillow?
Найдите объект недвижимости на Zillow по ссылке homedetails: история цен, диапазон Zestimate, налоги, взнос HOA, школы, агент, указанный в объявлении, и номер MLS. property_status лишь подсказывает известный статус дома и не является фильтром поиска, а Zestimate не является профессиональной оценкой.
urlОбязательный- URL страницы объекта Zillow в формате
homedetailsдля действия profile илиproperty_detail.property_detailтакже принимает в этом поле полный почтовый адрес. URL страницы объекта нельзя использовать вместо URL результатов поиска.Zillow: что такое Zestimate и каковы его ограничения — Zillow определяет Zestimate как модельную оценку рыночной стоимости жилья и уточняет, что это не профессиональная оценка недвижимости и заменить её не может; при недостатке надёжных данных оценка может быть недоступна. · ПровереноZillow: Rent Zestimate как ориентир для аренды — Zillow позиционирует Rent Zestimate как отправную точку для изучения рынка аренды и рекомендует параллельно смотреть объявления об аренде по соседству; это отдельная метрика, отличная от Zestimate, который оценивает стоимость продаваемой недвижимости. · Проверено property_statusНеобязательный- Подсказка об известном статусе целевого объекта для действия profile:
for_sale,recently_soldилиfor_rent. Помогает получить данные об одном указанном объекте и не является фильтром поиска.Допустимые значения:for_rentfor_salerecently_sold
Что означают параметры действия property_detail в API Zillow?
Получите объект недвижимости Zillow по ссылке или адресу. Вы получите адрес, координаты, цену, Zestimate, оценку арендной платы, налоговую стоимость, число спален и санузлов, площадь, участок и год постройки. days_on_market может отсчитываться с даты, предшествующей публикации на Zillow. Ничто из этого не является сертифицированной оценкой или инспекцией.
urlОбязательный- URL страницы объекта Zillow в формате
homedetailsдля действия profile илиproperty_detail.property_detailтакже принимает в этом поле полный почтовый адрес. URL страницы объекта нельзя использовать вместо URL результатов поиска.Zillow: что такое Zestimate и каковы его ограничения — Zillow определяет Zestimate как модельную оценку рыночной стоимости жилья и уточняет, что это не профессиональная оценка недвижимости и заменить её не может; при недостатке надёжных данных оценка может быть недоступна. · Проверено
Что означают параметры действия agents в API Zillow?
Находите агентов по недвижимости на Zillow в штате США, до 200 за вызов. Получите брокерскую компанию, адрес, телефон, рейтинг, число отзывов и бейдж топ-агента. keyword принимает аббревиатуру штата, например TX, а не его название. Фильтры по городу, брокерской компании и минимальному рейтингу сужают список.
keywordОбязательный- Город, регион или ZIP-код для
search. Вagentsэто аббревиатура штата США, напримерTX, а не запрос по имени агента. brokerageНеобязательный- Фильтрует агентов по подстроке в названии брокерской компании. Это не фильтр по типу постройки или жилья.
cityНеобязательный- Фильтрует агентов по городу. Город должен соответствовать штату, указанному в keyword.
min_ratingНеобязательный- Минимальный средний рейтинг для
agents, целое число от 0 до 5. Если задан, специалисты без рейтинга исключаются. Применяется только к категории агентов. Дробные значения округляются вниз.
Как использовать API Zillow
- 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":"zillow","action":"search","params":{"keyword":"<keyword>"}}'
Вопросы об API Zillow
Какие данные можно получить через API Zillow?
Укажите в platform значение zillow. В текущем каталоге: поиск, поиск по почтовому индексу (ZIP), данные объекта размещения, сведения об объекте недвижимости и агенты. Эти названия действий соответствуют разным объектам или представлениям Zillow; это не взаимозаменяемые режимы поиска.
Какие входные данные нужны для запроса search к платформе Zillow?
Город, регион или ZIP-код для search. В agents это аббревиатура штата США, например TX, а не запрос по имени агента. Передайте это значение в поле keyword объекта params.
Какие поля может вернуть search на платформе Zillow?
Объявленная схема включает zpid, status, status_type и price. Объявленное поле может отсутствовать в отдельной записи, а у каждого другого действия свой список полей.
Все ли действия Zillow возвращают результат сразу?
Действия с пометкой «асинхронное» возвращают ID задачи, по которому нужно опрашивать статус. Любое другое действие тоже можно запустить асинхронно: добавьте "mode": "async" в тело запроса, чтобы сразу получить ID задачи. Это удобно для длительных задач или запросов с большим лимитом. В текущем каталоге: режим выдачи: sync.