npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

airbnbapijs

v0.10.5

Published

Unofficial airbnb.com REST API wrapper for node.js

Downloads

78

Readme

Breaking changes ahead!

Version 0.11.0, due to be released sometime after July 1st. Errors will no longer return null values. Instead, errors will be thrown.

Unofficial airbnb.com REST API wrapper for node.js


Coverage Status


Hi there! 👋 This is a javascript library for interacting with airbnb's API.
Disclaimer: this library is not associated with airbnb and should only be used for educational reasons. It is an interface for a private API used by airbnb's mobile applications.
This is a pre 1.0 library. Please request endpoints and functionality as repo issues. Collaborators wanted!

Essential Info

  • All functions return promises.
  • The returned data format is pre-parsed JSON, i.e. a javascript object. Multiple records will be returned as an array.
  • The auth system is a simple crypto token. For the uninitiated, this is like a username and password in one. If you're only using a single account, you can supply a token with .setDefaultToken(), otherwise, you will have to supply a token with every function call.
  • Yeah, I know, airlock is a massive pain in the posterior.
  • Error reporting and data validation is spotty at this stage!
  • This library only has one dependency - request-promise.

Getting started 👨‍💻

Installing

npm install airbnbapijs

Importing

var airbnb = require('airbnbapijs')

or es6...

import airbnb from 'airbnbapijs'

Reference 📗

Contents

  1. Authorization
  2. Users
  3. Calendars
  4. Listings
  5. Threads
  6. Reservations
  7. Posting
  8. Configuration

AUTHORIZATION

testAuth

Test a token

airbnb.testAuth('faketoken3sDdfvtF9if5398j0v5nui')
// returns bool

newAccessToken

Request a new token

airbnb.newAccessToken({ username: '[email protected]', password: 'hunter2' })
// returns {token: 'faketoken3sDdfvtF9if5398j0v5nui'} or {error: {error obj}}

login

Request a new token (v2 endpoint). Similar to the above function but returns a user info summary with much more information.

airbnb.login({ username: '[email protected]', password: 'hunter2' })
// returns a user info object (includes token) or {error: {error obj}}

setDefaultToken

Set the token to use if a token is not supplied for an endpoint function.

airbnb.setDefaultToken('faketoken3sDdfvtF9if5398j0v5nui')

TODO: support other login methods (facebook, twitter, etc...)


USERS

getGuestInfo

Get a user's public facing information

airbnb.getGuestInfo(2348485493)
// returns public info about user (JSON)

getOwnUserInfo

Obtain user data for the logged in account

airbnb.getOwnUserInfo('faketoken3sDdfvtF9if5398j0v5nui')
// returns private info about user (JSON)

CALENDARS

getPublicListingCalendar

Public availability and price data on a listing. count is the duration in months.

airbnb.getPublicListingCalendar({
    id: 109834757,
    month: 1,
    year: 2018,
    count: 1
})
// returns array of calendar days, with availability and price

getCalendar

Private calendar data regarding your listings. Reservations, cancellations, prices, blocked days.

airbnb.getCalendar({
    token: 'faketoken3sDdfvtF9if5398j0v5nui',
    id: 109834757,
    startDate: '2018-01-01',
    endDate: '2018-02-28'
})
// returns array of calendar days with extended info, for your listings

setPriceForDay

Set a price for a day.

airbnb.setPriceForDay({
    token: 'faketoken3sDdfvtF9if5398j0v5nui',
    id: 109834757,
    date: '2018-01-01',
    price: 1203
})
// returns a result of the operation

setAvailabilityForDay

Set availability for a day.

airbnb.setAvailabilityForDay({
    token: 'faketoken3sDdfvtF9if5398j0v5nui',
    id: 109834757,
    date: '2018-01-01',
    availability: 'available' // or 'blocked'?
})
// returns a result of the operation

LISTINGS

listingSearch

Airbnb's mighty search bar in JSON form. All arguments are optional.

airbnb.listingSearch({
    location: 'Akihabara, Tokyo',
    checkin: '2020-01-21',
    checkout: '2020-02-10',
    offset: 0,
    limit: 20,
    language: 'en-US',
    currency: 'USD',
    guests: 6, // Number of guests for price quote
    instantBook: true, // only list instant bookable listings.
    minBathrooms: 0,
    minBedrooms: 2,
    minBeds: 6,
    minPrice: 0,
    maxPrice: 0,
    superhost: true,
    amenities: [1, 2, 4, 23], // array of IDs.
    hostLanguages: [1, 3, 6], // array of IDs.
    keywords: 'ocean view,garden,quiet', //comma separated
    roomTypes: ['Entire home/apt', 'Private room', 'Shared room'],
    neighborhoods: ['westside', 'riverside'],
    minPicCount: 4,
    sortDirection: 1 // 1 = forward, 0 = reverse
})
// returns an array of listings

getListingInfo

Gets public facing data on any listing.

airbnb.getListingInfo(109834757)
// returns public info for any listing (JSON)

getListingInfoHost

Gets private data on one of your listings.

airbnb.getListingInfoHost({
    token: 'faketoken3sDdfvtF9if5398j0v5nui',
    id: 109834757
})
// returns extended listing info for your listing (JSON)

getHostSummary

Gets an object containing a host's active listings, alerts, and upcoming reservations

airbnb.getHostSummary('faketoken3sDdfvtF9if5398j0v5nui')
// returns host summary info for your account (JSON)

getOwnActiveListings

Gets an array containing a host's active listings

airbnb.getOwnActiveListings('faketoken3sDdfvtF9if5398j0v5nui')
// returns listing array for your account (JSON)

getOwnListings

Gets an array containing a host's listings

airbnb.getOwnListings({
    token: 'faketoken3sDdfvtF9if5398j0v5nui',
    userId: '2344594'
})
// returns listing array for your account (JSON)

THREADS

getThread

Returns a conversation with a guest or host. This is a legacy endpoint which is somewhat limited in the content (only basic messages are reported in the 'posts' array)

airbnb.getThread({
    token: 'faketoken3sDdfvtF9if5398j0v5nui',
    id: 909878797
})
// returns a single thread in the legacy format (JSON)

getThreads

A simple list of thread ID's, ordered by latest update. The offset is how many to skip, and the limit is how many to report.

airbnb.getThreads({
    token: 'faketoken3sDdfvtF9if5398j0v5nui',
    offset: 0,
    limit: 20
})
// returns an array of thread IDS (only the ids, ordered by latest update) (JSON)

getThreadsFull

This is the best way to pull thread data. Returns an array of full thread data, ordered by latest update. The offset is how many to skip, and the limit is how many to report.

airbnb.getThreadsFull({
    token: 'faketoken3sDdfvtF9if5398j0v5nui',
    offset: 0,
    limit: 10
})
// returns an array of threads in the new format, ordered by latest update (JSON)

getThreadsBatch

A batch version of the above. You can grab a collection of threads referenced by thread ID.

airbnb.getThreadsBatch({
    token: 'faketoken3sDdfvtF9if5398j0v5nui',
    ids: [23049848, 203495875, 398328244]
})
// returns an array of threads in the new format (JSON)

RESERVATIONS

getReservation

Reservation data for one reservation.

airbnb.getReservation({
    token: 'faketoken3sDdfvtF9if5398j0v5nui',
    id: 909878797
})
// returns a single reservation in the mobile app format (JSON)

getReservations

Returns a list of reservations in the same format as above, ordered by latest update

airbnb.getReservations({
    token: 'faketoken3sDdfvtF9if5398j0v5nui',
    offset: 0,
    limit: 10
})
// returns an array of reservations in the mobile app format, ordered by latest update (JSON)

getReservationsBatch

Batch call for grabbing a list of reservations by ID.

airbnb.getReservationsBatch({
    token: 'faketoken3sDdfvtF9if5398j0v5nui',
    ids: [98769876, 98769543, 98756745]
})
// returns an array of reservations in the new format (JSON)

POSTING

sendMessage

Send a message to a thread.

airbnb.sendMessage({
    token: 'faketoken3sDdfvtF9if5398j0v5nui',
    id: 2039448789,
    message: 'Hi there!'
})
// returns confirmation

sendPreApproval

Send a pre-approval to a guest.

airbnb.sendPreApproval({
    token: 'faketoken3sDdfvtF9if5398j0v5nui',
    thread_id: 2039448789,
    listing_id: 340598483,
    message: ''
})
// returns confirmation

sendReview

Send a review to a guest after they have checked out. (id is the thread id)

airbnb.sendReview({
    token: 'faketoken3sDdfvtF9if5398j0v5nui',
    id: 2039448789,
    comments: 'They were great guests!',
    private_feedback: 'Thank you for staying!',
    cleanliness: 5,
    communication: 5,
    respect_house_rules: 5,
    recommend: true
})
// returns confirmation

sendSpecialOffer

Send a special offer to a guest.

airbnb.sendSpecialOffer({
    token: 'faketoken3sDdfvtF9if5398j0v5nui',
    check_in: '2018-10-13T00:00:00+00:00',
    guests: 1,
    listing_id: 9876676,
    nights: 1,
    price: 100000,
    thread_id: 98766767,
    currency: 'USD'
})
// returns confirmation

alterationRequestResponse

Send a "reservation alteration request response" to a guest
To accept the request, supply the decision prop with true
To decline the request, supply the decision prop with false

alterationRequestResponse({
    token: 'faketoken3sDdfvtF9if5398j0v5nui',
    reservationId: 23049459,
    alterationId: 2134094,
    decision: true,
    currency: 'USD'
})
// returns alteration object, or an error object.

CONFIGURATION

setConfig

Set multiple config variables at once

setConfig({
    defaultToken: 'faketoken3sDdfvtF9if5398j0v5nui',
    apiKey: '01123581321345589144233377610987',
    currency: 'USD',
    userAgent: 'Mosaic/0.9',
    proxy: 'myproxy.com'
})

setDefaultToken

Set the token to use if a token is not supplied for an endpoint function.

airbnb.setDefaultToken('faketoken3sDdfvtF9if5398j0v5nui')

setApiKey

Use an api key different from the standard one

airbnb.setApiKey('01123581321345589144233377610987')

setCurrency

Set the default currency (the default is JPY, sorry USA)

airbnb.setCurrency('USD')

setUserAgent

set the user agent string for the requests

airbnb.setUserAgent('Mosaic/0.9')

setProxy

set a proxy server to run traffic through

airbnb.setProxy('myproxy.com')