You are on page 1of 17

Data Dictionary for listings.

csv detailed file

File Name listings.csv


Version 4
Date Introduced August, 2020
Description

Field Type Calculated Description


id integer Airbnb's unique identifier for the listing
listing_url text y
scrape_id bigint y Inside Airbnb "Scrape" this was part of
last_scraped datetime y UTC. The date and time this listing was
name text "scraped".
Name of the listing
description text Detailed description of the listing
neighborhood_overview text Host's description of the neighbourhood
picture_url text URL to the Airbnb hosted regular sized
host_id integer image forunique
Airbnb's the listing
identifier for the host/user
host_url text y The Airbnb page for the host
host_name text Name of the host. Usually just the first
host_since date name(s).
The date the host/user was created. For
host_location text hosts that are
The host's selfAirbnb guests
reported this could be
location
host_about text Description about the host
host_response_time
host_response_rate
host_acceptance_rate That rate at which a host accepts booking
host_is_superhost boolean [t=true; f=false] requests.
host_thumbnail_url text
host_picture_url text
host_neighbourhood text
host_listings_count text The number of listings the host has (per
host_total_listings_count text Airbnb calculations)
The number of listings the host has (per
host_verifications Airbnb calculations)
host_has_profile_pic boolean [t=true; f=false]
host_identity_verified boolean [t=true; f=false]
neighbourhood text
neighbourhood_cleansedtext y The neighbourhood as geocoded using the
neighbourhood_group_cltext y latitude and longitude
The neighbourhood against
group as geocoded
latitude numeric using the
Uses the World
latitudeGeodetic
and longitude
System against
longitude numeric (WGS84)
Uses projection
the World for latitude
Geodetic System and
property_type text (WGS84) projection for latitude
Self selected property type. Hotels andand
room_type text Bed and
[Entire Breakfasts are described
home/apt|Private room|Sharedas such
room|Hotel]
accommodates integer The maximum capacity of the listing
bathrooms numeric The number of bathrooms in the listing
bathrooms_text string The number of bathrooms in the listing.
bedrooms integer On
Thethe Airbnb
number ofweb-site,
bedrooms the bathrooms
beds integer The number of bed(s)
amenities json
price currency daily price in local currency
minimum_nights integer minimum number of night stay for the
maximum_nights integer listing (calendar
maximum numberrules may stay
of night be different)
for the
minimum_minimum_nightinteger y listing (calendar rules may be different)
the smallest minimum_night value from the
maximum_minimum_nighinteger y calender
the largest(looking 365 nightsvalue
minimum_night in the future)
from the
minimum_maximum_nighinteger y calender (looking 365 nights in the
the smallest maximum_night value from future)
maximum_maximum_nigh integer y the
the calender (looking 365 nights
largest maximum_night valueinfrom
the the
minimum_nights_avg_nt numeric y calender
the average(looking 365 nights value
minimum_night in the from
future)
the
maximum_nights_avg_ntnumeric y calender (looking 365 nights in
the average maximum_night value fromthe future)
calendar_updated date the calender (looking 365 nights in the
has_availability boolean [t=true; f=false]
availability_30 integer y avaliability_x. The availability of the listing
availability_60 integer y x days in the future
avaliability_x. as determined
The availability of theby the
listing
availability_90 integer y x days in the future
avaliability_x. as determined
The availability of theby the
listing
availability_365 integer y x days in the future
avaliability_x. as determined
The availability of theby the
listing
calendar_last_scraped date x days in the future as determined by the
number_of_reviews integer The number of reviews the listing has
number_of_reviews_ltm integer y The number of reviews the listing has (in
number_of_reviews_l30dinteger y the last
The 12 months)
number of reviews the listing has (in
first_review date y the last 30 days)
The date of the first/oldest review
last_review date y The date of the last/newest review
review_scores_rating
review_scores_accuracy
review_scores_cleanliness
review_scores_checkin
review_scores_communication
review_scores_location
review_scores_value
license text The licence/permit/registration number
instant_bookable boolean [t=true; f=false]. Whether the guest can
calculated_host_listings_integer y automatically
The number ofbook the the
listings listing without
host has inthe
the
calculated_host_listings integer y current
The scrape,
number in the home/apt
of Entire city/regionlistings the
calculated_host_listings integer y host number
The has in the current room
of Private scrape, in thethe
listings
calculated_host_listing integer y host has in the current scrape,
The number of Shared room listings in thethe
reviews_per_month numeric y host has in the
The number current scrape,
of reviews in the
the listing has over
the lifetime of the listing
Change control
Field Change
summary Removed
space Removed
experiences_offered Removed
notes Removed
transit Removed
access Removed
interaction Removed
house_rules Removed
thumbnail_url Removed
medium_url Removed
xl_picture_url Removed
street Removed
city Removed
state Removed
zipcode Removed
market Removed
smart_location Removed
country_code Removed
country Removed
is_location_exact Removed
bed_type Removed
square_feet Removed
weekly_price Removed
monthly_price Removed
security_deposit Removed
cleaning_fee Removed
guests_included Removed
extra_people Removed
requires_license Removed
jurisdiction_names Removed
is_business_travel_readyRemoved
cancellation_policy Removed
require_guest_profile_picRemoved
require_guest_phone_veriRemoved
bathrooms_text Added
number_of_reviews_l30dAdded
Reference

https://www.airbnb.com/help/article/5/what-does-the-room-type-of-a-listing-mean
Data Dictionary for listings.csv detailed file

File Name listings.csv


Version 3
Date Introduced 2019
Description

Field Type Calculated Description


id integer Airbnb's unique identifier for the listing
listing_url text y
scrape_id bigint y Inside Airbnb "Scrape" this was part of
last_scraped datetime y UTC. The date and time this listing was
name text "scraped".
Name of the listing
summary text Summary description of the listing
space text Description of the space for rent
description text Detailed description of the listing
experiences_offered text Description of the experiences offered
neighborhood_overview text Host's description of the neighbourhood
notes text Notes for the listing. In some cities, Airbnb
transit text instructs
Notes forthe
thehost to write the legal Permit
listing
access text Access notes
interaction text
house_rules text
thumbnail_url text URL to the Airbnb hosted thumbnail image
medium_url text for the
URL tolisting
the Airbnb hosted medium sized
picture_url text image
URL to thethe
for listinghosted regular sized
Airbnb
xl_picture_url text image
URL toforthethe listinghosted XL sized image
Airbnb
host_id integer for the listing
Airbnb's unique identifier for the host/user
host_url text y The Airbnb page for the host
host_name text Name of the host. Usually just the first
host_since date name(s).
The date the host/user was created. For
host_location text hosts that are
The host's selfAirbnb guests
reported this could be
location
host_about text Description about the host
host_response_time
host_response_rate
host_acceptance_rate That rate at which a host accepts booking
host_is_superhost boolean [t=true; f=false] requests.
host_thumbnail_url text
host_picture_url text
host_neighbourhood text
host_listings_count text The number of listings the host has
host_total_listings_count text The number of listings the host has
host_verifications
host_has_profile_pic boolean [t=true; f=false]
host_identity_verified boolean [t=true; f=false]
street text
neighbourhood text
neighbourhood_cleansedtext y The neighbourhood as geocoded using the
neighbourhood_group_cltext y latitude
The and longitude
neighbourhood against
group as geocoded
city text using the latitude and longitude against
state text
zipcode text
market text
smart_location text
country_code text
country text
latitude numeric Uses the World Geodetic System
longitude numeric (WGS84) projection
Uses the World for latitude
Geodetic System and
is_location_exact boolean (WGS84) projection for latitude and
[t=true; f=false]
property_type text Possibly related
Self selected to the type.
property host'sHotels
choiceand
for displaying the listing's
room_type text Bed and
[Entire Breakfasts are described
home/apt|Private room|Sharedas such
accommodates integer room|Hotel]
The maximum capacity of the listing
bathrooms numeric The number of bathrooms in the listing
bedrooms integer The number of bedrooms
beds integer The number of bed(s)
bed_type string The type of bed(s)
amenities json
square_feet integer
price currency daily price in local currency
weekly_price currency weekly price in local currency
monthly_price currency monthly price in local currency
security_deposit currency
cleaning_fee currency
guests_included number number of guests included in the price
extra_people currency amount in local currency for additional
minimum_nights integer guests
minimum number of night stay for the
maximum_nights integer listing
maximum (calendar
numberrules may stay
of night be different)
for the
minimum_minimum_nightinteger y listing (calendar rules may be different)
the smallest minimum_night value from the
maximum_minimum_nighinteger y calender
the (looking
largest 365 nightsvalue
minimum_night in the future)
from the
minimum_maximum_nighinteger y calender
the (looking
smallest 365 nights in
maximum_night the future)
value from
maximum_maximum_nigh integer y the calender (looking 365 nights in
the largest maximum_night value from the the
minimum_nights_avg_ntm y calender
the average(looking 365 nights value
minimum_night in the from
future)
the
calender (looking 365 nights in the future)
maximum_nights_avg_ntm y the average maximum_night value from
calendar_updated date the calender (looking 365 nights in the
has_availability boolean [t=true; f=false]
availability_30 integer y avaliability_x. The availability of the listing
availability_60 integer y x days in the future
avaliability_x. as determined
The availability of theby the
listing
availability_90 integer y x days in the future
avaliability_x. as determined
The availability of theby the
listing
availability_365 integer y x days in the future
avaliability_x. as determined
The availability of theby the
listing
calendar_last_scraped date x days in the future as determined by the
number_of_reviews integer The number of reviews the listing has
number_of_reviews_ltm integer y The number of reviews the listing has (in
first_review date y the
Thelast
date12ofmonths)
the first/oldest review
last_review date y The date of the last/newest review
review_scores_rating
review_scores_accuracy
review_scores_cleanliness
review_scores_checkin
review_scores_communication
review_scores_location
review_scores_value
requires_license boolean [t=true; f=false]. Whether the
license text listing/jurisdiction requires a license
The licence/permit/registration number
jurisdiction_names text Legal jurisdiction
instant_bookable boolean [t=true; f=false]. Whether the guest can
is_business_travel_readyboolean automatically
[t=true; f=false]book the listing without the
cancellation_policy
require_guest_profile_picboolean [t=true; f=false]
require_guest_phone_veriboolean [t=true; f=false]
calculated_host_listings_integer y The number of listings the host has in the
calculated_host_listings integer y current
The numberscrape, in the home/apt
of Entire city/regionlistings the
calculated_host_listings integer y host has in the
The number current room
of Private scrape, in thethe
listings
calculated_host_listing integer y host has in the
The number current scrape,
of Shared in thethe
room listings
reviews_per_month numeric y host has in the
The number current scrape,
of reviews in the
the listing has over
the lifetime of the listing
Change control
Field Change
minimum_minimum_nightAdded
maximum_minimum_nighAdded
minimum_maximum_nighAdded
maximum_maximum_nigh Added
minimum_nights_avg_nt Added
maximum_nights_avg_ntAdded
number_of_reviews_ltm Added
calculated_host_listings Added
calculated_host_listings Added
calculated_host_listing Added
Reference
https://www.airbnb.com/help/article/2141/how-will-my-listings-location-be-shown-on-the-map
https://www.airbnb.com/help/article/478/how-do-i-edit-my-listings-address-or-map-location
https://www.airbnb.com/help/article/5/what-does-the-room-type-of-a-listing-mean
Data Dictionary for listings.csv summary file

File Name listings.csv


Version 2
Date Introduced TBD
Description

Field Type Calculated Description


id integer Airbnb's unique identifier for the listing
name string
host_id integer
host_name string
neighbourhood_group text y The neighbourhood group as
neighbourhood text y geocoded using the as
The neighbourhood latitude
latitude numeric geocoded using Geodetic
Uses the World the latitude
longitude System
Uses the(WGS84) projection for
World Geodetic
room_type string System (WGS84) projection for
price currency daily price in local currency.
minimum_nights integer Note,
minimum $ sign may be
number used stay
of night
number_of_reviews integer for
Thethe listingof
number (calendar
reviews rules
the
last_review date y listing has
The date of the last/newest
calculated_host_listings_count integer y review
The number of listings the host
availability_365 integer y has in the current
avaliability_x. The scrape, in the
availability of
number_of_reviews_ltm integer y the listing
The number x days in the future
of reviews the
license string listing has (in the last 12

Change control
Field Change
number_of_reviews_ltm Added
license Added
Reference
ifier for the listing
Data Dictionary for listings.csv summary file

File Name listings.csv


Version 1
Date Introduced 2015
Description

Field Type Calculated Description


id integer Airbnb's unique identifier for the listing
name string
host_id integer
host_name string
neighbourhood_group text y The neighbourhood group as
neighbourhood text y geocoded using the as
The neighbourhood latitude
latitude numeric geocoded using Geodetic
Uses the World the latitude
longitude System
Uses the(WGS84) projection for
World Geodetic
room_type string System (WGS84) projection for
price currency daily price in local currency.
minimum_nights integer Note,
minimum $ sign may be
number used stay
of night
number_of_reviews integer for
Thethe listingof
number (calendar
reviews rules
the
last_review date y listing has
The date of the last/newest
reviews_per_month numeric (2 decimal places) review
calculated_host_listings_count integer y The number of listings the host
availability_365 integer y has in the current
avaliability_x. The scrape, in the
availability of
the listing x days in the future

Change control
Field Change
Reference
ifier for the listing
Data Dictionary for reviews.csv data file

File Name reviews.csv


Version 1
te Introduced 2015
Description

Field Type Calculated Description Reference


listing_id
id
date
reviewer_id
reviewer_name
comments

Change control
Field Change
Data Dictionary for calendar.csv data file

File Name calendar.csv


Version 2
te Introduced 2019
details from the listing's calendar for each day of the next
Description 365 days

Field Type Calculated Description Reference


listing_id
date datetime The date in the listing's calendar
available boolean Whether the date is available for a booking
price currency The price listed for the day
adjusted_price
minimum_nighinteger Minimum nights for a booking made on this day
maximum_nighinteger Maximum nights for a booking made on this day

Change control
Field Change
adjusted_priceAdded
minimum_nighAdded
maximum_nighAdded
Data Dictionary for calendar.csv data file

File Name calendar.csv


Version 1
te Introduced 2015
details from the listing's calendar for each day of the next
Description 365 days

Field Type Calculated Description Reference


listing_id
date datetime The date in the listing's calendar
available boolean Whether the date is available for a booking
price currency The price listed for the day

Change control
Field Change

You might also like