Доступность платформы
- Состояние за 24 ч
- Норма
За последние 30 дней
Доступные возможности
Все действия Crexi: что делает каждое, сколько стоит и как работало за последние 24 часа. Откройте действие, чтобы увидеть параметры, поля ответа и примеры кода.
| Возможность | Описание | За 1000 | Состояние за 24 часа |
|---|---|---|---|
Поискsearch | Ищите коммерческую недвижимость для продажи или аренды на Crexi. | $1.39 за 1 000 запросов | Норма |
Сведения об объекте недвижимостиproperty_detail | Получите одно объявление коммерческой недвижимости на Crexi по числовому ID или ссылке /properties/: ключевые особенности, запрашиваемая цена, полный адрес, подтип, тип аренды, заполняемость, этажность и даты размещения. | $1.39 за 1 000 запросов | Норма |
Откройте возможность, чтобы посмотреть её параметры, поля ответа и примеры кода, а также попробовать её в работе.
Какие параметры принимает каждое действие API Crexi?
Каждый ответ ниже описывает одно вызываемое действие и его фактические входные данные. Значение параметров и допустимые значения зависят от действия: знакомое имя параметра не обязательно означает одно и то же на всех платформах.
Ссылки на официальные источники приводятся только для пояснения расположенного рядом термина, принятого на платформе. Они не означают, что платформа предоставила разрешение или выразила одобрение. Функции официального сайта не входят в API EveryInfra, если они не перечислены на этой странице.
| Действие | Обязательные | Необязательные | Способ получения результата | Лимит | За 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.39 за 1 000 запросов | 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Сведения об объекте недвижимости Получите одно объявление коммерческой недвижимости на Crexi по числовому ID или ссылке /properties/: ключевые особенности, запрашиваемая цена, полный адрес, подтип, тип аренды, заполняемость, этажность и даты размещения. Текстовые слаги и пути /lease/ не распознаются, а отсутствующие значения не следует додумывать. | url | — | Режим выдачи: Sync | — | $1.39 за 1 000 запросов | 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 |
Что означают параметры действия search в API Crexi?
Ищите коммерческую недвижимость для продажи или аренды на 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, завершается ошибкой 422, а не переключается на sale.Допустимые значения:
leasesaleCrexi: поиск объектов на продажу и в аренду — Документация Crexi по поиску разделяет объявления Sale (продажа) и Lease (аренда). Этот источник описывает только типы сделок и не означает, что эндпоинт включает картографические слои, демографические данные или данные о транспортном потоке, упомянутые в источнике. · Проверено
Что означают параметры действия property_detail в API Crexi?
Получите одно объявление коммерческой недвижимости на Crexi по числовому ID или ссылке /properties/: ключевые особенности, запрашиваемая цена, полный адрес, подтип, тип аренды, заполняемость, этажность и даты размещения. Текстовые слаги и пути /lease/ не распознаются, а отсутствующие значения не следует додумывать.
Полный справочник API: параметры, примеры кода, пример ответа и состояниеurlОбязательный- Определяет целевой объект по полному URL Crexi с числовым ID объявления (например, /properties/<ID>) или по самому числовому ID в виде строки, извлечённому из поля id результата поиска. Ссылки со слагами, состоящими только из текста, не распознаются, а ссылки вида /lease/<ID> нельзя использовать для получения подробных данных.
Как использовать API Crexi
- 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>"}}'
Вопросы об API Crexi
Какие данные можно получить через API Crexi?
Укажите в platform значение crexi. В текущем каталоге: поиск и сведения об объекте недвижимости. Эти названия действий соответствуют разным объектам или представлениям Crexi; это не взаимозаменяемые режимы поиска.
Какие входные данные нужны для запроса search к платформе Crexi?
Обязательный поисковый параметр для коммерческой недвижимости на Crexi. Если передать в нём почтовый код штата США (например, TX, CA или FL), он работает как фильтр по штату, а не как поиск по названию объекта с запросом в свободной форме. Параметры state или states переопределяют это значение, но keyword всё равно остаётся обязательным. Передайте это значение в поле keyword объекта params.
Какие поля может вернуть search на платформе Crexi?
Объявленная схема включает name, text, address и city. Объявленное поле может отсутствовать в отдельной записи, а у каждого другого действия свой список полей.
Все ли действия Crexi возвращают результат сразу?
Действия с пометкой «асинхронное» возвращают ID задачи, по которому нужно опрашивать статус. Любое другое действие тоже можно запустить асинхронно: добавьте "mode": "async" в тело запроса, чтобы сразу получить ID задачи. Это удобно для длительных задач или запросов с большим лимитом. В текущем каталоге: режим выдачи: sync.