Сценарий использования

Отслеживайте цены на жильё и аренду по ZIP-коду по объявлениям Zillow

Получайте объявления Zillow о продаже, аренде и недавно проданных домах по ZIP-коду в JSON: цена, спальни, санузлы, площадь, адрес и Zestimate.

Предоплата, без подпискиREST или MCPОдин ключ для моделей, данных и агентов
Zillowlovelyjsonitems[0]"address": "412 Oak Ln, Austin, T…"price": 689000"beds": 3"baths": 2"living_area": 1840"zestimate": 672000

Если вы инвестируете в арендное жильё, оцениваете дома как агент или готовите обзор рынка, вам нужно знать, сколько просят за дома в ZIP-коде, за сколько они продались и сколько стоит аренда — в этом месяце, а не по квартальному PDF. Zillow это показывает, но по одному поиску за раз. Lovely Router выполняет поиск за вас. Отправьте ZIP-коды, получите по одному JSON-объекту на объявление и платите за каждое объявление с предоплаченного баланса. Запускайте из скрипта, задачи для таблицы или ИИ-агента с одним API-ключом.

Передайте это своему ИИ-агенту

Скопируйте этот промпт в Claude Code, Cursor, Codex или любой кодинг-агент. Он подскажет агенту, где документация и как использовать ваш API-ключ.

Отслеживайте цены на жильё и аренду по ZIP-коду по объявлениям Zillow. Use the Lovely Router data tools: each returns JSON and is billed per result.

- Docs (read first): https://lovelyrouter.com/docs/tools/find.md and https://lovelyrouter.com/docs/tools/run.md
- Plan first: POST https://lovelyrouter.com/v1/tools/suggest with `{"task": "<my task in plain words>"}` (free). It returns the tools to run in order, each with an example `input`, the `input_required` fields, an estimated cost and a ready-made `run` request. Replace the example values with my task's; if a field is unclear, read the tool with GET https://lovelyrouter.com/v1/tools/<id>. To browse instead, POST https://lovelyrouter.com/v1/tools/discover searches the catalog.
- Show me the plan and its estimated cost (`total_est_cost_usd`) before running anything large.
- Run: POST https://lovelyrouter.com/v1/tools/<id>/run with `{"input": {...}, "max_results": N}`. A 200 has the finished run with `items`; a 202 means it is still running, so poll the `poll` path until `status` is `succeeded`, `failed`, `timed_out` or `stopped`.
- Only delivered results are billed. Keep max_results small on the first run, check the output, then scale up.
- If you support MCP, connect https://lovelyrouter.com/mcp instead (Streamable HTTP, same key; https://lovelyrouter.com/docs/tools/mcp.md) and use suggest_tools, get_tool and run_tool.
- Auth: read my API key from the LOVELY_API_KEY environment variable and send it as `Authorization: Bearer $LOVELY_API_KEY`. Never print or commit the key. If it is not set, ask me to create one at https://lovelyrouter.com/app/keys.
- Billing is prepaid: every call is charged to my balance, so test with a small request before running anything large.
- Every docs page is plain Markdown; the full index is https://lovelyrouter.com/llms.txt.

My task: <the inputs (links, keywords or accounts) and how many results you need>
01

Как это работает

010203
  1. Составьте список ZIP-кодов

    Выберите ZIP-коды районов, за которыми вы следите: где у вас есть недвижимость, где вы хотите купить, где живут ваши клиенты.

  2. Запустите инструмент с лимитом

    Отправьте их в POST /v1/tools/zillow-listings/run с operation, равным buy, rent или sold, maxItems для числа объявлений и max_results как лимитом запуска. Запуск резервирует свою максимальную стоимость на балансе и возвращает объявления в виде JSON.

  3. Посчитайте и сравните

    Для каждого ZIP-кода посчитайте медианную цену, цену за квадратный фут жилой площади и разницу с Zestimate. Сохраните результат с датой и сравнивайте месяц к месяцу.

02

Объявления по ZIP-коду одним запросом

Поиск объявлений Zillow принимает ZIP-коды в locations. Сузить выборку можно через minPrice и maxPrice (0 означает «любая»; для аренды цена указывается за неделю, как подписано в поле). Для продаж agentListed и ownerPosted определяют, какие виды объявлений вернутся:

curl https://lovelyrouter.com/v1/tools/zillow-listings/run \
  -H "Authorization: Bearer $LOVELY_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "input": {
      "locations": ["78701"],
      "operation": "buy",
      "maxItems": 5
    },
    "max_results": 5
  }'

Запуск, который всё ещё идёт через 60 секунд, возвращает 202; как опрашивать его, показано в разделе «Запустить инструмент». Один запуск может вернуть до 200 объявлений.

03

Что есть в каждом объявлении

Группа полейЧто вы получаете
ЦенаЗапрашиваемая цена или цена продажи
РазмерСпальни, санузлы и жилая площадь
РасположениеАдрес
ОценкаZestimate от Zillow
04

Рецепты

Ежемесячный снимок рынка

Первого числа каждого месяца запускайте buy для каждого отслеживаемого ZIP-кода, сохраняйте медианную запрашиваемую цену и число объявлений и стройте график.

Отбор по соотношению аренды и цены

Запустите rent и buy для одного ZIP-кода и сравните типичную аренду с типичной ценой в пересчёте на спальню, чтобы найти районы, где сдача в аренду окупается.

Оценка дома по проданным аналогам

Запустите sold для ZIP-кода, оставьте дома с похожим числом спален, санузлов и жилой площадью и используйте их цены как аналоги.

Поиск переоценённых объявлений

Для результатов buy сравните запрашиваемую цену с Zestimate и выпишите те, что сильно выше оценки.

Выгодные предложения в рамках бюджета

Задайте minPrice и maxPrice и каждое утро отправляйте себе новые объявления.

Удобнее обычными словами? Подключите MCP-сервер и скажите Claude Code или Cursor: «Для ZIP-кодов 78701, 78702 и 78704 получи по 40 домов на продажу и покажи медианную цену, медианную жилую площадь и медианную разницу с Zestimate. Задай max_results равным 120.»

05

Сочетайте с другими источниками

Объявления — это сторона предложения. Вокруг них:

Zillow
Поиск объявлений Zillow

Дома на Zillow на продажу, в аренду или недавно проданные в указанных ZIP-кодах: цена, спальни, санузлы, жилая площадь, адрес, Zestimate.

$0.00225 / listingПодробности →
Airbnb
Поиск жилья на Airbnb

Объявления Airbnb по месту и датам: цена за проживание и за ночь, рейтинг, отзывы, хозяин, удобства, правила дома, фото.

$0.00075 / listingПодробности →
Google Maps
Поиск мест в Google Maps

Поиск местных компаний в Google Maps по ключевому слову и местоположению: название, адрес, телефон, сайт, рейтинг, число отзывов, часы работы, координаты.

$0.000238 / place + $0.00075 / callПодробности →
Google News
Поиск в Google News

Новостные статьи из Google News по запросу (работают операторы "exact phrase", OR, -word, site:, intitle:), при желании за указанный период: заголовок, источник, дата и ссылка на статью на сайте издания.

$0.006 / articleПодробности →
Google Trends
Интерес в Google Trends

Динамика интереса в Google Trends по времени и регионам для ключевого слова.

$0.039 / callПодробности →
  • airbnb-listings показывает цены краткосрочной аренды для сравнения с долгосрочной.
  • google-maps-places перечисляет магазины, школы и инфраструктуру вокруг объекта.
  • google-news отслеживает местные новости, которые двигают рынок, например появление нового крупного работодателя.
  • google-trends показывает, растёт ли поисковый интерес к городу.

Данные о путешествиях и недвижимости вместе описаны в сценарии «Данные о путешествиях и недвижимости».

06

Сколько это стоит

Вы платите за каждое объявление: при старте запуска резервируется его максимальная стоимость — плата за вызов плюс плата за объявление, умноженная на max_results, — а итоговое списание соответствует тому, что запуск вернул. Остаток резерва возвращается на баланс. Запуск, который завершился ошибкой или по тайм-ауту, оплачивается только за выданные объявления, а запуск, отклонённый на старте, ничего не стоит.

Отслеживание 12 ZIP-кодов по 50 объявлений оплачивается как 600 объявлений. Нет ни подписки, ни ежемесячного минимума: пополняйте баланс от $5, и один баланс оплачивает и инструменты, и модели. На карточке выше указана текущая цена; на странице «Цены» перечислены все инструменты.

07

Частые вопросы

?
Можно ли искать по городу или адресу?+

Этот инструмент ищет только по ZIP-коду. Укажите ZIP-коды в locations.

Можно ли получить проданные дома и аренду?+

Да. operation принимает buy, rent или sold.

Включён ли Zestimate?+

Да. В описании инструмента для каждого объявления указаны цена, спальни, санузлы, жилая площадь, адрес и Zestimate.

Сколько объявлений можно получить?+

maxItems задаёт число объявлений на запуск, а лимит запуска max_results — до 200 объявлений. Если нужно больше, запустите несколько запусков.

Можно ли фильтровать по цене?+

Да, через minPrice и maxPrice. 0 означает «любая».

Нужна ли подписка?+

Нет. Вы пополняете предоплаченный баланс, и каждый запуск списывает с него средства. Неудачные запуски оплачиваются только за выданные результаты, и ничего не продлевается автоматически.

Один предоплаченный ключ для моделей, данных и агентов

Без подписки. Пополняйте баланс, используйте сколько нужно и смотрите каждое списание в логах.