Created function that gets information about provided room ID

[matthewshirley]

I discovered in the AirBNB API that /listings/{roomid} is an request that works. So I've added it in.

>>> api.get_room(5280573)
{u'listing': {u'collection_ids': [], u'cancel_policy_short_str': u'Flexible', u'medium_url':     u'https://a0.muscache.com/pictures/69656982/medium.jpg', u'require_guest_profile_picture': False, u'country_code': u'CA', u'property_type': u'Apartment', u'recent_review': {u'review': {u'listing_id': 5280573, u'reviewee_id': 24564433, u'reviewer_id': 16667436, u'created_at': u'2015-03-17T13:46:05Z', u'comments': u'Very nice and quiet place. ', u'reviewer': {u'user': {u'has_profile_pic': True, u'first_name': u'Eddie', u'picture_url': u'https://a0.muscache.com/ic/users/16667436/profile_pic/1402506685/original.jpg?interpolation=lanczos-none&crop=w:w;*,*&crop=h:h;*,*&resize=225:*&output-format=jpg&output-quality=70', u'thumbnail_url': u'https://a0.muscache.com/ic/users/16667436/profile_pic/1402506685/original.jpg?interpolation=lanczos-none&crop=w:w;*,*&crop=h:h;*,*&resize=50:*&output-format=jpg&output-quality=70', u'id': 16667436}}, u'id': 28101129}}, u'price_for_extra_person_native': 0, u'has_double_blind_reviews': False, u'bedrooms': 1, u'has_viewed_cleaning': None, u'max_nights': 1125, u'has_viewed_terms': None, u'name': u'1br Apt Next to Vancouver Airport. ', u'summary': u'Next to Westin, Cheaper than Westin, Better than Westin! I just got this new place, but I am still living in my old place. All the furnitures are brand new. Its pretty new and clean. Gym, pool, bar are downstairs, just 5 mins to Airport.', u'thumbnail_url': u'https://a0.muscache.com/pictures/69656982/small.jpg', u'min_nights': 1, u'has_agreed_to_legal_terms': None, u'neighborhood': u'Richmond', u'thumbnail_urls': [u'https://a0.muscache.com/pictures/69656982/small.jpg', u'https://a1.muscache.com/pictures/69657042/small.jpg', u'https://a2.muscache.com/pictures/69657506/small.jpg', u'https://a2.muscache.com/pictures/69657369/small.jpg', u'https://a1.muscache.com/pictures/69657433/small.jpg', u'https://a0.muscache.com/pictures/71417193/small.jpg', u'https://a1.muscache.com/pictures/71417016/small.jpg', u'https://a1.muscache.com/pictures/69656842/small.jpg', u'https://a0.muscache.com/pictures/69657312/small.jpg', u'https://a2.muscache.com/pictures/69657551/small.jpg', u'https://a1.muscache.com/pictures/69657112/small.jpg', u'https://a2.muscache.com/pictures/69657645/small.jpg', u'https://a1.muscache.com/pictures/69657744/small.jpg', u'https://a2.muscache.com/pictures/66071437/small.jpg', u'https://a0.muscache.com/pictures/70353522/small.jpg', u'https://a2.muscache.com/pictures/70353551/small.jpg', u'https://a1.muscache.com/pictures/70353614/small.jpg', u'https://a0.muscache.com/pictures/65982176/small.jpg', u'https://a2.muscache.com/pictures/69656794/small.jpg'], u'locale': u'en', u'property_type_id': 1, u'lng': -123.13573108945334, u'neighborhood_overview': u'Quite.', u'picture_urls': [u'https://a0.muscache.com/ic/pictures/69656982/157cc0dc_original.jpg?interpolation=lanczos-none&size=large_cover&output-format=jpg&output-quality=70', u'https://a1.muscache.com/ic/pictures/69657042/59c431d9_original.jpg?interpolation=lanczos-none&size=large_cover&output-format=jpg&output-quality=70', u'https://a2.muscache.com/ic/pictures/69657506/129ffdb5_original.jpg?interpolation=lanczos-none&size=large_cover&output-format=jpg&output-quality=70', u'https://a2.muscache.com/ic/pictures/69657369/3676177d_original.jpg?interpolation=lanczos-none&size=large_cover&output-format=jpg&output-quality=70', u'https://a1.muscache.com/ic/pictures/69657433/4c22f38a_original.jpg?interpolation=lanczos-none&size=large_cover&output-format=jpg&output-quality=70', u'https://a0.muscache.com/ic/pictures/71417193/833c6094_original.jpg?interpolation=lanczos-none&size=large_cover&output-format=jpg&output-quality=70', u'https://a1.muscache.com/ic/pictures/71417016/11dfc35d_original.jpg?interpolation=lanczos-none&size=large_cover&output-format=jpg&output-quality=70', u'https://a1.muscache.com/ic/pictures/69656842/95d51152_original.jpg?interpolation=lanczos-none&size=large_cover&output-format=jpg&output-quality=70', u'https://a0.muscache.com/ic/pictures/69657312/ebb82253_original.jpg?interpolation=lanczos-none&size=large_cover&output-format=jpg&output-quality=70', u'https://a2.muscache.com/ic/pictures/69657551/e2f22252_original.jpg?interpolation=lanczos-none&size=large_cover&output-format=jpg&output-quality=70', u'https://a1.muscache.com/ic/pictures/69657112/9bbf111e_original.jpg?interpolation=lanczos-none&size=large_cover&output-format=jpg&output-quality=70', u'https://a2.muscache.com/ic/pictures/69657645/dccde5b8_original.jpg?interpolation=lanczos-none&size=large_cover&output-format=jpg&output-quality=70', u'https://a1.muscache.com/ic/pictures/69657744/045331c0_original.jpg?interpolation=lanczos-none&size=large_cover&output-format=jpg&output-quality=70', u'https://a2.muscache.com/ic/pictures/66071437/62264126_original.jpg?interpolation=lanczos-none&size=large_cover&output-format=jpg&output-quality=70', u'https://a0.muscache.com/ic/pictures/70353522/1f0c097c_original.jpg?interpolation=lanczos-none&size=large_cover&output-format=jpg&output-quality=70', u'https://a2.muscache.com/ic/pictures/70353551/aa514472_original.jpg?interpolation=lanczos-none&size=large_cover&output-format=jpg&output-quality=70', u'https://a1.muscache.com/ic/pictures/70353614/018173c2_original.jpg?interpolation=lanczos-none&size=large_cover&output-format=jpg&output-quality=70', u'https://a0.muscache.com/ic/pictures/65982176/94d190f6_original.jpg?interpolation=lanczos-none&size=large_cover&output-format=jpg&output-quality=70', u'https://a2.muscache.com/ic/pictures/69656794/44bc2823_original.jpg?interpolation=lanczos-none&size=large_cover&output-format=jpg&output-quality=70'], u'space': u'Clean!\n\nI can do airport pick up and drop up if you live more than one night!\n\nQuite.\n\nSkytrain, bus, airport shuttle.\n\nI can do airport pick up and drop up if you live more than one night!\n\nQuite.\n\nSkytrain, bus, airport shuttle.', u'require_guest_phone_verification': False, u'xl_picture_urls': [u'https://a0.muscache.com/pictures/69656982/x_large.jpg', u'https://a1.muscache.com/pictures/69657042/x_large.jpg', u'https://a2.muscache.com/pictures/69657506/x_large.jpg', u'https://a2.muscache.com/pictures/69657369/x_large.jpg', u'https://a1.muscache.com/pictures/69657433/x_large.jpg', u'https://a0.muscache.com/pictures/71417193/x_large.jpg', u'https://a1.muscache.com/pictures/71417016/x_large.jpg', u'https://a1.muscache.com/pictures/69656842/x_large.jpg', u'https://a0.muscache.com/pictures/69657312/x_large.jpg', u'https://a2.muscache.com/pictures/69657551/x_large.jpg', u'https://a1.muscache.com/pictures/69657112/x_large.jpg', u'https://a2.muscache.com/pictures/69657645/x_large.jpg', u'https://a1.muscache.com/pictures/69657744/x_large.jpg', u'https://a2.muscache.com/pictures/66071437/x_large.jpg', u'https://a0.muscache.com/pictures/70353522/x_large.jpg', u'https://a2.muscache.com/pictures/70353551/x_large.jpg', u'https://a1.muscache.com/pictures/70353614/x_large.jpg', u'https://a0.muscache.com/pictures/65982176/x_large.jpg', u'https://a2.muscache.com/pictures/69656794/x_large.jpg'], u'state': u'British Columbia', u'room_type_category': u'entire_home', u'public_address': u'Corvette Way, Richmond, British Columbia V6X 3A3, Canada', u'price_formatted': u'$81', u'smart_location': u'Richmond, Canada', u'address': u'Corvette Way, Richmond, British Columbia V6X 3A3, Canada', u'square_feet': None, u'check_out_time': None, u'interaction': u'I can do airport pick up and drop up if you live more than one night!', u'language': u'en', u'country': u'Canada', u'requires_license': False, u'guests_included': 1, u'reviews_count': 5, u'transit': u'Skytrain, bus, airport shuttle.', u'calendar_updated_at': u'today', u'picture_captions': [u'Living Room', u'Living Room', u'Living Room', u'Counter', u'Living Room', u'Master bedroom', u'Master bedroom ', u'Washroom', u'', u'D/W', u'Balcony ', u'Indoor Pool', u'Gym Room', u'Kitchen', u'Sony 3D TV with Netflix', u'', u'', u'Westin Apartment, Vancouver Airport', u''], u'market': u'Vancouver', u'city': u'Richmond', u'user_id': 24564433, u'bed_type_category': u'futon', u'amenities': [u'TV', u'Internet', u'Wireless Internet', u'Air Conditioning', u'Wheelchair Accessible', u'Pool', u'Kitchen', u'Free Parking on Premises', u'Smoking Allowed', u'Pets Allowed', u'Gym', u'Elevator in Building', u'Hot Tub', u'Buzzer/Wireless Intercom', u'Heating', u'Family/Kid Friendly', u'Suitable for Events', u'Washer', u'Dryer', u'Smoke Detector', u'Carbon Monoxide Detector', u'Fire Extinguisher', u'Essentials', u'Shampoo'], u'cancellation_policy': u'flexible', u'extras_price_native': 40, u'instant_bookable': False, u'experiences_offered': u'none', u'security_deposit_formatted': u'', u'photos': [{u'picture': u'https://a0.muscache.com/ic/pictures/69656982/157cc0dc_original.jpg?interpolation=lanczos-none&size=large_cover&output-format=jpg&output-quality=70', u'xl_picture': u'https://a0.muscache.com/pictures/69656982/x_large.jpg', u'thumbnail': u'https://a0.muscache.com/pictures/69656982/small.jpg', u'caption': u'Living Room', u'sort_order': 1, u'id': 69656982}, {u'picture': u'https://a1.muscache.com/ic/pictures/69657042/59c431d9_original.jpg?interpolation=lanczos-none&size=large_cover&output-format=jpg&output-quality=70', u'xl_picture': u'https://a1.muscache.com/pictures/69657042/x_large.jpg', u'thumbnail': u'https://a1.muscache.com/pictures/69657042/small.jpg', u'caption': u'Living Room', u'sort_order': 2, u'id': 69657042}, {u'picture': u'https://a2.muscache.com/ic/pictures/69657506/129ffdb5_original.jpg?interpolation=lanczos-none&size=large_cover&output-format=jpg&output-quality=70', u'xl_picture': u'https://a2.muscache.com/pictures/69657506/x_large.jpg', u'thumbnail': u'https://a2.muscache.com/pictures/69657506/small.jpg', u'caption': u'Living Room', u'sort_order': 3, u'id': 69657506}, {u'picture': u'https://a2.muscache.com/ic/pictures/69657369/3676177d_original.jpg?interpolation=lanczos-none&size=large_cover&output-format=jpg&output-quality=70', u'xl_picture': u'https://a2.muscache.com/pictures/69657369/x_large.jpg', u'thumbnail': u'https://a2.muscache.com/pictures/69657369/small.jpg', u'caption': u'Counter', u'sort_order': 4, u'id': 69657369}, {u'picture': u'https://a1.muscache.com/ic/pictures/69657433/4c22f38a_original.jpg?interpolation=lanczos-none&size=large_cover&output-format=jpg&output-quality=70', u'xl_picture': u'https://a1.muscache.com/pictures/69657433/x_large.jpg', u'thumbnail': u'https://a1.muscache.com/pictures/69657433/small.jpg', u'caption': u'Living Room', u'sort_order': 5, u'id': 69657433}, {u'picture': u'https://a0.muscache.com/ic/pictures/71417193/833c6094_original.jpg?interpolation=lanczos-none&size=large_cover&output-format=jpg&output-quality=70', u'xl_picture': u'https://a0.muscache.com/pictures/71417193/x_large.jpg', u'thumbnail': u'https://a0.muscache.com/pictures/71417193/small.jpg', u'caption': u'Master bedroom', u'sort_order': 6, u'id': 71417193}, {u'picture': u'https://a1.muscache.com/ic/pictures/71417016/11dfc35d_original.jpg?interpolation=lanczos-none&size=large_cover&output-format=jpg&output-quality=70', u'xl_picture': u'https://a1.muscache.com/pictures/71417016/x_large.jpg', u'thumbnail': u'https://a1.muscache.com/pictures/71417016/small.jpg', u'caption': u'Master bedroom ', u'sort_order': 7, u'id': 71417016}, {u'picture': u'https://a1.muscache.com/ic/pictures/69656842/95d51152_original.jpg?interpolation=lanczos-none&size=large_cover&output-format=jpg&output-quality=70', u'xl_picture': u'https://a1.muscache.com/pictures/69656842/x_large.jpg', u'thumbnail': u'https://a1.muscache.com/pictures/69656842/small.jpg', u'caption': u'Washroom', u'sort_order': 8, u'id': 69656842}, {u'picture': u'https://a0.muscache.com/ic/pictures/69657312/ebb82253_original.jpg?interpolation=lanczos-none&size=large_cover&output-format=jpg&output-quality=70', u'xl_picture': u'https://a0.muscache.com/pictures/69657312/x_large.jpg', u'thumbnail': u'https://a0.muscache.com/pictures/69657312/small.jpg', u'caption': u'', u'sort_order': 9, u'id': 69657312}, {u'picture': u'https://a2.muscache.com/ic/pictures/69657551/e2f22252_original.jpg?interpolation=lanczos-none&size=large_cover&output-format=jpg&output-quality=70', u'xl_picture': u'https://a2.muscache.com/pictures/69657551/x_large.jpg', u'thumbnail': u'https://a2.muscache.com/pictures/69657551/small.jpg', u'caption': u'D/W', u'sort_order': 10, u'id': 69657551}, {u'picture': u'https://a1.muscache.com/ic/pictures/69657112/9bbf111e_original.jpg?interpolation=lanczos-none&size=large_cover&output-format=jpg&output-quality=70', u'xl_picture': u'https://a1.muscache.com/pictures/69657112/x_large.jpg', u'thumbnail': u'https://a1.muscache.com/pictures/69657112/small.jpg', u'caption': u'Balcony ', u'sort_order': 11, u'id': 69657112}, {u'picture': u'https://a2.muscache.com/ic/pictures/69657645/dccde5b8_original.jpg?interpolation=lanczos-none&size=large_cover&output-format=jpg&output-quality=70', u'xl_picture': u'https://a2.muscache.com/pictures/69657645/x_large.jpg', u'thumbnail': u'https://a2.muscache.com/pictures/69657645/small.jpg', u'caption': u'Indoor Pool', u'sort_order': 12, u'id': 69657645}, {u'picture': u'https://a1.muscache.com/ic/pictures/69657744/045331c0_original.jpg?interpolation=lanczos-none&size=large_cover&output-format=jpg&output-quality=70', u'xl_picture': u'https://a1.muscache.com/pictures/69657744/x_large.jpg', u'thumbnail': u'https://a1.muscache.com/pictures/69657744/small.jpg', u'caption': u'Gym Room', u'sort_order': 13, u'id': 69657744}, {u'picture': u'https://a2.muscache.com/ic/pictures/66071437/62264126_original.jpg?interpolation=lanczos-none&size=large_cover&output-format=jpg&output-quality=70', u'xl_picture': u'https://a2.muscache.com/pictures/66071437/x_large.jpg', u'thumbnail': u'https://a2.muscache.com/pictures/66071437/small.jpg', u'caption': u'Kitchen', u'sort_order': 14, u'id': 66071437}, {u'picture': u'https://a0.muscache.com/ic/pictures/70353522/1f0c097c_original.jpg?interpolation=lanczos-none&size=large_cover&output-format=jpg&output-quality=70', u'xl_picture': u'https://a0.muscache.com/pictures/70353522/x_large.jpg', u'thumbnail': u'https://a0.muscache.com/pictures/70353522/small.jpg', u'caption': u'Sony 3D TV with Netflix', u'sort_order': 15, u'id': 70353522}, {u'picture': u'https://a2.muscache.com/ic/pictures/70353551/aa514472_original.jpg?interpolation=lanczos-none&size=large_cover&output-format=jpg&output-quality=70', u'xl_picture': u'https://a2.muscache.com/pictures/70353551/x_large.jpg', u'thumbnail': u'https://a2.muscache.com/pictures/70353551/small.jpg', u'caption': u'', u'sort_order': 16, u'id': 70353551}, {u'picture': u'https://a1.muscache.com/ic/pictures/70353614/018173c2_original.jpg?interpolation=lanczos-none&size=large_cover&output-format=jpg&output-quality=70', u'xl_picture': u'https://a1.muscache.com/pictures/70353614/x_large.jpg', u'thumbnail': u'https://a1.muscache.com/pictures/70353614/small.jpg', u'caption': u'', u'sort_order': 17, u'id': 70353614}, {u'picture': u'https://a0.muscache.com/ic/pictures/65982176/94d190f6_original.jpg?interpolation=lanczos-none&size=large_cover&output-format=jpg&output-quality=70', u'xl_picture': u'https://a0.muscache.com/pictures/65982176/x_large.jpg', u'thumbnail': u'https://a0.muscache.com/pictures/65982176/small.jpg', u'caption': u'Westin Apartment, Vancouver Airport', u'sort_order': 18, u'id': 65982176}, {u'picture': u'https://a2.muscache.com/ic/pictures/69656794/44bc2823_original.jpg?interpolation=lanczos-none&size=large_cover&output-format=jpg&output-quality=70', u'xl_picture': u'https://a2.muscache.com/pictures/69656794/x_large.jpg', u'thumbnail': u'https://a2.muscache.com/pictures/69656794/small.jpg', u'caption': u'', u'sort_order': 19, u'id': 69656794}], u'force_mobile_legal_modal': False, u'picture_count': 19, u'currency_symbol_right': None, u'star_rating': 5.0, u'license': None, u'weekly_price_native': 569, u'map_image_url': u'https://maps.googleapis.com/maps/api/staticmap?maptype=&markers=49.1898146017216%2C-123.13573108945334&size=480x320&zoom=15&client=gme-airbnbinc&channel=monorail-prod&signature=lHGlZ-fsfzIwkO_esi_f6OF4IAM%3D', u'max_nights_input_value': 1125, u'min_nights_input_value': 1, u'currency_symbol_left': u'$', u'native_currency': u'USD', u'bathrooms': 1.0, u'person_capacity': 4, u'check_in_time': None, u'is_location_exact': True, u'id': 5280573, u'picture_url': u'https://a0.muscache.com/pictures/69656982/large.jpg', u'zipcode': u'V6X 3A3', u'cancel_policy': 3, u'has_viewed_ib_perf_dashboard_panel': None, u'description': u'Next to Westin, Cheaper than Westin, Better than Westin! I just got this new place, but I am still living in my old place. All the furnitures are brand new. Its pretty new and clean. Gym, pool, bar are downstairs, just 5 mins to Airport.\n\nClean!\n\nI can do airport pick up and drop up if you live more than one night!\n\nQuite.\n\nSkytrain, bus, airport shuttle.\n\nI can do airport pick up and drop up if you live more than one night!\n\nQuite.\n\nSkytrain, bus, airport shuttle.\n\nI can do airport pick up and drop up if you live more than one night!\n\nQuite.\n\nSkytrain, bus, airport shuttle.', u'time_zone_name': u'America/Vancouver', u'price': 79, u'cleaning_fee_native': 40, u'xl_picture_url': u'https://a0.muscache.com/pictures/69656982/x_large.jpg', u'user': {u'user': {u'picture_large_url': u'https://a1.muscache.com/ic/users/24564433/profile_pic/1427137208/original.jpg?interpolation=lanczos-none&crop=w:w;*,*&crop=h:h;*,*&resize=640:*&output-format=jpg&output-quality=70', u'first_name': u'Jason', u'last_name': u'', u'thumbnail_medium_url': u'https://a1.muscache.com/ic/users/24564433/profile_pic/1427137208/original.jpg?interpolation=lanczos-none&crop=w:w;*,*&crop=h:h;*,*&resize=68:*&output-format=jpg&output-quality=70', u'wishlists_count': 1, u'created_at': u'2014-12-07T06:46:30Z', u'picture_url': u'https://a1.muscache.com/ic/users/24564433/profile_pic/1427137208/original.jpg?interpolation=lanczos-none&crop=w:w;*,*&crop=h:h;*,*&resize=225:*&output-format=jpg&output-quality=70', u'has_profile_pic': True, u'acceptance_rate': u'40%', u'is_superhost': False, u'thumbnail_url': u'https://a1.muscache.com/ic/users/24564433/profile_pic/1427137208/original.jpg?interpolation=lanczos-none&crop=w:w;*,*&crop=h:h;*,*&resize=50:*&output-format=jpg&output-quality=70', u'reviewee_count': 5, u'recommendation_count': 0, u'response_rate': u'100%', u'publicly_visible_wishlists_count': 0, u'id': 24564433, u'response_time': u'within an hour'}}, u'lat': 49.1898146017216, u'price_native': 81, u'bed_type': u'Futon', u'beds': 1, u'description_locale': u'en', u'amenities_ids': [1, 3, 4, 5, 6, 7, 8, 9, 11, 12, 15, 21, 25, 28, 30, 31, 32, 33, 34, 35, 36, 39, 40, 41], u'room_type': u'Entire home/apt'}}
>>> exit()

[nderkach]

Thanks for the PR!

This package is merely a proof of concept so far, and I don't have much time to develop it at the moment. A few things, i think should be developed for this wrapper:

• Proper classes for common used abstractions like Room, Profile, etc. Right now it just returns JSON from the server response.
• More endpoints to be integrated to make it useful.

To get information about payload and API endpoints you can use a local proxy like Charles or mimtproxy to forge HTTP requests coming from the app. I've described this process in details in this article. One you set the thing up, it's pretty straighforward to get the API topology by simply playing with the app.

I encourage you or anyone else interested to do that, and I'll integrate changes into the package If you have any questions, feel free to shoot me an email, I'll gladly assist.

[matthewshirley]

Thanks for the feedback!

I've only started developing with Python so things are a little sketchy. I have pushed some updates which hopefully are correct. This push is using the same API key.