Доступность платформы
- Состояние за 24 ч
- Норма
За последние 30 дней
Доступные возможности
Все действия Airbnb: что делает каждое, сколько стоит и как работало за последние 24 часа. Откройте действие, чтобы увидеть параметры, поля ответа и примеры кода.
| Возможность | Описание | За 1000 | Состояние за 24 часа |
|---|---|---|---|
Поискsearch | Ищите жильё на Airbnb по направлению, переданному в keyword, с необязательными фильтрами по валюте, языку и диапазону цен. | $1.39 за 1 000 запросов | Норма |
Сведения об объекте недвижимостиproperty_detail | Получите одно объявление Airbnb по ссылке /rooms/ или ID объекта. | $1.39 за 1 000 запросов | Норма |
Отзывыreviews | Получите отзывы гостей об объявлении Airbnb. | $1.39 за 1 000 запросов | Норма |
Профили хозяев жильяhost | Найдите хозяина на Airbnb по ссылке на профиль или ID хозяина. | $1.39 за 1 000 запросов | Норма |
Календарь доступностиcalendar | Проверяйте доступность объявления Airbnb по дням. | $1.39 за 1 000 запросов | Норма |
Откройте возможность, чтобы посмотреть её параметры, поля ответа и примеры кода, а также попробовать её в работе.
Какие параметры принимает каждое действие API Airbnb?
Каждый ответ ниже описывает одно вызываемое действие и его фактические входные данные. Значение параметров и допустимые значения зависят от действия: знакомое имя параметра не обязательно означает одно и то же на всех платформах.
Ссылки на официальные источники приводятся только для пояснения расположенного рядом термина, принятого на платформе. Они не означают, что платформа предоставила разрешение или выразила одобрение. Функции официального сайта не входят в API EveryInfra, если они не перечислены на этой странице.
| Действие | Обязательные | Необязательные | Способ получения результата | Лимит | За 1 000 | Поля ответа |
|---|---|---|---|---|---|---|
searchПоиск Ищите жильё на Airbnb по направлению, переданному в | keyword | currency, lang, locale, max_price, min_price | Режим выдачи: Sync | Значения в каталоге: defaultLimit=20, maxLimit=100. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $1.39 за 1 000 запросов | id · url · title · text · property_type · person_capacity · price · rating · rating_scale · review_count · lat · lng · location · host_name · amenities · image_url · check_in · check_out · platform |
property_detailСведения об объекте недвижимости Получите одно объявление Airbnb по ссылке /rooms/ или ID объекта. Возвращаются тип жилья, вместимость, число спален, кроватей и ванных комнат, удобства, рейтинг и хозяин. Необязательный параметр | url | city, max_price, min_price | Режим выдачи: Sync | — | $1.39 за 1 000 запросов | id · url · title · text · property_type · room_type · person_capacity · bedrooms · bathrooms · beds · location · lat · lng · rating · rating_scale · review_count · price · currency · host_name · is_superhost · amenities · platform |
reviewsОтзывы Получите отзывы гостей об объявлении Airbnb. У каждого отзыва есть текст, оценка, дата, язык, имя и местоположение автора, а также ответ хозяина, если он есть. Ограничивайте выборку по языку, дате, указанной в | url | lang, locale, since, sort | Режим выдачи: Sync | Значения в каталоге: defaultLimit=20, maxLimit=100. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $1.39 за 1 000 запросов | id · url · text · rating · rating_scale · posted_at · language · author_name · author_location · response · platform |
hostПрофили хозяев жилья Найдите хозяина на Airbnb по ссылке на профиль или ID хозяина. Получите имя, описание, языки, рейтинг, статус суперхозяина, дату регистрации и число объявлений. Передайте ссылку /users/show/ или ID хозяина, а не ID объявления. Профиль не подтверждает личность хозяина. | url | — | Режим выдачи: Sync | — | $1.39 за 1 000 запросов | id · url · name · text · avatar_url · languages · listing_count · rating · rating_scale · review_count · is_superhost · joined_at · listing_urls · platform |
calendarКалендарь доступности Проверяйте доступность объявления Airbnb по дням. Для каждой даты указаны доступность заезда и выезда, минимальное и максимальное число ночей и цена. Если даты не указаны, период начинается с сегодняшнего дня и охватывает 30 дней. Проверка календаря не удерживает даты и не оформляет бронирование. | url | check_in, check_out, end_date, since, start_date, until | Режим выдачи: Sync | — | $1.39 за 1 000 запросов | id · date · available · available_for_checkin · available_for_checkout · bookable · min_nights · max_nights · price · currency · platform |
Что означают параметры действия search в API Airbnb?
Ищите жильё на Airbnb по направлению, переданному в keyword, с необязательными фильтрами по валюте, языку и диапазону цен. В каждой записи указаны тип жилья, вместимость, цена и рейтинг в том виде, как они показаны, но доступность на конкретные даты не подтверждается.
keywordОбязательный- Задаёт целевое место для действия search: город, регион или направление (например, Tokyo). Передавайте название места, а не имя пользователя хозяина или ID жилья.
currencyНеобязательный- Задаёт валюту отображения цен в результатах поиска Airbnb (по умолчанию USD; см. допустимые значения). Параметр меняет валюту цен на жильё, но не влияет на оплату запросов к API EveryInfra и валюту кошелька.Допустимые значения:
aedaudbgnbrlcadchfclpcnycopcrcczkdkkegpeurgbpghshkdhrkhufidrilsinrjpykeskrwkztmadmxnmyrnoknzdpenphpplnqarronsarseksgdthbtrytwduahugxusduyuvndzar langНеобязательный- Задаёт сочетание языка и региона компактными кодами, например enus для en-US, zhcn для zh-CN или jajp для ja-JP. Передавайте одно из перечисленных допустимых значений без изменений, а не общие двухбуквенные коды языка вроде en.Допустимые значения:
arxxazazbgbgbsbacaescsczdadkdeatdechdededeluelgrenaeenauencaengbengyenieeninennzensgenuses419esaresboesbzesclescoescresecesesesgteshnesmxesniespaespeespyessvesusesveeteefififrbefrcafrchfrfrfrlugaieheilhiinhrhrhuhuhyamididisisitchititjajpkagekokrltltlvlvmkmkmsmymtmtnlbenlnlnonoplplptbrptptrororuruskskslsisqalsrmesrrssvseswxxththtlphtrtrukuavivnxhzazhcnzhhkzhtwzhtwuszhuszuza localeНеобязательный- Задаёт локаль отображения страницы Airbnb (по умолчанию en-US), например en-US или zh-CN. Не передавайте locale вместе с lang: lang имеет приоритет и переопределяет выбор языка. Параметр не фильтрует отзывы по национальности их авторов.
max_priceНеобязательный- Задаёт фильтр максимальной цены жилья в виде числа. Значение должно быть больше или равно min_price. Используйте его для фильтрации результатов поиска, а не для ограничения стоимости отдельных запросов к API или общего бюджета на проживание. Фильтрация работает с целыми числами: дробные значения округляются вверх (145.98 становится 146).
min_priceНеобязательный- Задаёт фильтр минимальной цены жилья в виде числа вместе с max_price. Параметр фильтрует результаты поиска объявлений и не задаёт лимит использования API. Фильтрация работает с целыми числами: дробные значения округляются вниз (39.81 становится 39).
Что означают параметры действия property_detail в API Airbnb?
Получите одно объявление Airbnb по ссылке /rooms/ или ID объекта. Возвращаются тип жилья, вместимость, число спален, кроватей и ванных комнат, удобства, рейтинг и хозяин. Необязательный параметр city и фильтры по цене не превращают запрос в поиск или расчёт стоимости бронирования.
urlОбязательный- Задаёт целевой ресурс в зависимости от действия: для property_detail, reviews и calendar передайте URL вида /rooms/<property_id> или ID жилья, для host передайте URL вида /users/show/<host_id> или ID хозяина. Идентификаторы жилья и хозяина не взаимозаменяемы.Airbnb: отзывы о жилье и ограничения видимости — Airbnb отделяет публичные отзывы и общий звёздный рейтинг от оценок по категориям, которые видят только хозяева и платформа. Общая оценка жилья и оценка хозяина по нескольким объявлениям рассчитываются отдельно, и их нельзя смешивать. · Проверено
cityНеобязательный- Задаёт фильтр по названию города в свободной форме для запросов сведений о жилье. Укажите название города, а не ID жилья или код страны.
max_priceНеобязательный- Задаёт фильтр максимальной цены жилья в виде числа. Значение должно быть больше или равно min_price. Используйте его для фильтрации результатов поиска, а не для ограничения стоимости отдельных запросов к API или общего бюджета на проживание. Фильтрация работает с целыми числами: дробные значения округляются вверх (145.98 становится 146).
min_priceНеобязательный- Задаёт фильтр минимальной цены жилья в виде числа вместе с max_price. Параметр фильтрует результаты поиска объявлений и не задаёт лимит использования API. Фильтрация работает с целыми числами: дробные значения округляются вниз (39.81 становится 39).
Что означают параметры действия reviews в API Airbnb?
Получите отзывы гостей об объявлении Airbnb. У каждого отзыва есть текст, оценка, дата, язык, имя и местоположение автора, а также ответ хозяина, если он есть. Ограничивайте выборку по языку, дате, указанной в since, или порядку сортировки. Одна выборка не обязательно содержит всю историю отзывов.
urlОбязательный- Задаёт целевой ресурс в зависимости от действия: для property_detail, reviews и calendar передайте URL вида /rooms/<property_id> или ID жилья, для host передайте URL вида /users/show/<host_id> или ID хозяина. Идентификаторы жилья и хозяина не взаимозаменяемы.Airbnb: отзывы о жилье и ограничения видимости — Airbnb отделяет публичные отзывы и общий звёздный рейтинг от оценок по категориям, которые видят только хозяева и платформа. Общая оценка жилья и оценка хозяина по нескольким объявлениям рассчитываются отдельно, и их нельзя смешивать. · Проверено
langНеобязательный- Задаёт сочетание языка и региона компактными кодами, например enus для en-US, zhcn для zh-CN или jajp для ja-JP. Передавайте одно из перечисленных допустимых значений без изменений, а не общие двухбуквенные коды языка вроде en.Допустимые значения:
arxxazazbgbgbsbacaescsczdadkdeatdechdededeluelgrenaeenauencaengbengyenieeninennzensgenuses419esaresboesbzesclescoescresecesesesgteshnesmxesniespaespeespyessvesusesveeteefififrbefrcafrchfrfrfrlugaieheilhiinhrhrhuhuhyamididisisitchititjajpkagekokrltltlvlvmkmkmsmymtmtnlbenlnlnonoplplptbrptptrororuruskskslsisqalsrmesrrssvseswxxththtlphtrtrukuavivnxhzazhcnzhhkzhtwzhtwuszhuszuza localeНеобязательный- Задаёт локаль отображения страницы Airbnb (по умолчанию en-US), например en-US или zh-CN. Не передавайте locale вместе с lang: lang имеет приоритет и переопределяет выбор языка. Параметр не фильтрует отзывы по национальности их авторов.
sinceНеобязательный- Задаёт начальную дату в формате YYYY-MM-DD; её смысл зависит от действия. Для reviews это начальная дата отзывов, для calendar это начало диапазона дат, и значение переопределяет start_date и check_in.
sortНеобязательный- Сортирует отзывы гостей: newest (по умолчанию), relevance или top_rated. Параметр влияет только на порядок отзывов, а не на цены объявлений.Допустимые значения:
newestrelevancetop_rated
Что означают параметры действия host в API Airbnb?
Найдите хозяина на Airbnb по ссылке на профиль или ID хозяина. Получите имя, описание, языки, рейтинг, статус суперхозяина, дату регистрации и число объявлений. Передайте ссылку /users/show/ или ID хозяина, а не ID объявления. Профиль не подтверждает личность хозяина.
Полный справочник API: параметры, примеры кода, пример ответа и состояниеurlОбязательный- Задаёт целевой ресурс в зависимости от действия: для property_detail, reviews и calendar передайте URL вида /rooms/<property_id> или ID жилья, для host передайте URL вида /users/show/<host_id> или ID хозяина. Идентификаторы жилья и хозяина не взаимозаменяемы.Airbnb: рейтинг хозяина и рейтинг жилья — разные показатели — Airbnb вычисляет рейтинг хозяина, объединяя общие рейтинги его объявлений. Оценку из профиля хозяина нельзя напрямую переносить на отдельный объект. · Проверено
Что означают параметры действия calendar в API Airbnb?
Проверяйте доступность объявления Airbnb по дням. Для каждой даты указаны доступность заезда и выезда, минимальное и максимальное число ночей и цена. Если даты не указаны, период начинается с сегодняшнего дня и охватывает 30 дней. Проверка календаря не удерживает даты и не оформляет бронирование.
Полный справочник API: параметры, примеры кода, пример ответа и состояниеurlОбязательный- Задаёт целевой ресурс в зависимости от действия: для property_detail, reviews и calendar передайте URL вида /rooms/<property_id> или ID жилья, для host передайте URL вида /users/show/<host_id> или ID хозяина. Идентификаторы жилья и хозяина не взаимозаменяемы.
check_inНеобязательный- Задаёт начальную дату в формате YYYY-MM-DD для действия calendar (для совместимости). Если также передан start_date, приоритет у start_date; since переопределяет оба. Запрос дат календаря не создаёт бронирование.
check_outНеобязательный- Задаёт конечную дату в формате YYYY-MM-DD для действия calendar (для совместимости). Если также передан end_date, приоритет у end_date; until переопределяет оба. Запрос дат календаря не резервирует жильё.
end_dateНеобязательный- Задаёт конечную дату в формате YYYY-MM-DD для запросов доступности в календаре. Если параметр не указан, используется check_out или дата через 30 дней после даты запроса (а не start_date плюс 30 дней). until переопределяет этот параметр.
sinceНеобязательный- Задаёт начальную дату в формате YYYY-MM-DD; её смысл зависит от действия. Для reviews это начальная дата отзывов, для calendar это начало диапазона дат, и значение переопределяет start_date и check_in.
start_dateНеобязательный- Задаёт начальную дату в формате YYYY-MM-DD для запросов доступности в календаре. Если параметр не указан, используется check_in или текущая дата. since переопределяет этот параметр.
untilНеобязательный- Задаёт конечную дату в формате YYYY-MM-DD для действия calendar и переопределяет end_date и check_out. Параметр управляет диапазоном дат календаря и не фильтрует отзывы по дате публикации.
Как использовать API Airbnb
- 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":"airbnb","action":"search","params":{"keyword":"<keyword>"}}'
Вопросы об API Airbnb
Какие данные можно получить через API Airbnb?
Укажите в platform значение airbnb. В текущем каталоге: поиск, сведения об объекте недвижимости, отзывы, профили хозяев жилья и календарь доступности. Эти названия действий соответствуют разным объектам или представлениям Airbnb; это не взаимозаменяемые режимы поиска.
Какие входные данные нужны для запроса search к платформе Airbnb?
Задаёт целевое место для действия search: город, регион или направление (например, Tokyo). Передавайте название места, а не имя пользователя хозяина или ID жилья. Передайте это значение в поле keyword объекта params.
Какие поля может вернуть search на платформе Airbnb?
Объявленная схема включает title, text, property_type и person_capacity. Объявленное поле может отсутствовать в отдельной записи, а у каждого другого действия свой список полей.
Все ли действия Airbnb возвращают результат сразу?
Действия с пометкой «асинхронное» возвращают ID задачи, по которому нужно опрашивать статус. Любое другое действие тоже можно запустить асинхронно: добавьте "mode": "async" в тело запроса, чтобы сразу получить ID задачи. Это удобно для длительных задач или запросов с большим лимитом. В текущем каталоге: режим выдачи: sync.