Airbnb Portugal AL License Checker
Pricing
Pay per event
Check the AL licence number of Airbnb and Booking.com listings in Portugal against the national register (RNAL): verdict, registered holder with tax number, e-mail and phone, address with floor, authorised guests, insurance — or list every AL of a municipality.
ID
id
Required
Airbnb listing ID; Booking.com property ID; for a licence number given alone, the number as typed; for a register record, its number (42391/AL).
Source
source
Required
airbnb_listing (an Airbnb listing checked), airbnb_card (the card of an Airbnb search result, with Cards only: no listing page read, nothing checked), booking_listing (a Booking.com property checked), license_number (a number from Licence numbers to check, no listing) or register_list (a record of Register lists, no listing).
Listing URL
url
Optional
Airbnb listing or Booking.com property page; the register page for a licence number or a register record.
Title
title
Optional
Listing name as the host wrote it; the registered name for a licence number or a register record.
Verdict
verdict
Required
Result of the check, the most serious problem first: valid, never_issued, not_in_register, other_property, over_capacity, unknown_format, no_number, exempt_claimed, other_register, region_not_covered, register_unavailable; unchecked on a row of a cards-only run (no check made).
Verdict reasons
verdictReasons
Required
Every problem found (the verdict is the most serious one): the verdicts themselves, plus far_from_listing and other_region (verdict other_property), and for information only bare_number (the number is shown without /AL: read as an AL number, it may be another register's), several_numbers (the listing shows more than one number: the first is checked), no_insurance (the register shows no liability insurance) and insurance_expired (its end date has passed).
[ "over_capacity"]Verdict explained
verdictNote
Required
Plain English: what was compared, what did not match, and what the register gives no data to check (position in Madeira, guests).
Suspicious
isSuspicious
Required
True when the verdict is a problem (never_issued, not_in_register, other_property, over_capacity, unknown_format, no_number).
Region
region
Optional
Where the listing is (a licence number or register record: its registered address): mainland, madeira, azores (own regional register, RRAL: not checked), other (outside Portugal).
Registration details (raw)
registrationText
Optional
The 'Registration details' text shown on the listing, lines joined by |.
Booking licence phrases
licensePhrases
Required
Booking.com only: the licence sentences shown on the property (License number: 42391/AL, This property doesn't require a short-term rental license).
[ "License number: 42391/AL"]Licence number
licenseNumber
Optional
AL licence number shown on the listing, as written (42391/AL, AL57277, 12833).
Licence number (register spelling)
licenseNumberNormalized
Optional
The same number as the register writes it (42391/AL): the key used for the check.
Other numbers shown
otherLicenseNumbers
Required
Further AL numbers the listing shows (a building with several licences), register spelling; only the first is checked.
[]Exemption claimed
exemption
Optional
Exemption text shown instead of a number (Exempt).
Found in the register
registerFound
Required
True when the number is in the national register (RNAL).
Register number
registerNumber
Optional
Number as the register writes it.
Register page
registerUrl
Optional
Public page of the record on the national register (rnt.turismodeportugal.pt).
Registered name
registerName
Optional
Name of the accommodation in the register.
Registered kind
registerType
Optional
Kind of accommodation (modalidade) as registered: Apartamento, Moradia, Quartos, Estabelecimento de hospedagem, Estabelecimento de hospedagem - Hostel.
Registered on
registerDate
Optional
Date of registration, YYYY-MM-DD.
Open to the public since
registerOpeningDate
Optional
Opening date declared to the register, YYYY-MM-DD.
Registered holder
registerHolder
Optional
Holder of the licence (titular da exploração): a person or a company, as the register names it (the first one when there are several: see Holders).
Holder tax number
registerHolderTaxId
Optional
Portuguese tax number of the holder (NIF of a person, NIPC of a company), as published by the register.
Holder type
registerHolderType
Optional
person (tax number starting 1, 2, 3 or 45), company (5, 6, 71, 72, 9…) or other (an undivided estate, 70 / 74 / 75), read from the tax number.
Holder's role
registerHolderRole
Optional
Why the holder runs the accommodation: owner (proprietário), tenant (arrendatário), borrower (comodatário: free loan), assignee (cessionário), usufructuary (usufrutuário), agent (mandatário), other.
Holder e-mail
registerHolderEmail
Optional
E-mail of the holder published by the register (every record has one).
Holder phone
registerHolderPhone
Optional
Landline of the holder published by the register (about 1 holder in 10).
Holder mobile
registerHolderMobile
Optional
Mobile of the holder published by the register (about 1 holder in 4).
Holders
registerHolders
Required
Every holder of the record (3 % of records have 2 or more): name, taxId, type, role, roleText (as written), email, phone, mobile.
[ { "name": "Hexa Living Lda", "taxId": "509421679", "type": "company", "role": "owner", "roleText": "Proprietário", "email": "info@example.pt", "phone": null, "mobile": "912000000" }]Registered address
registerAddress
Optional
Full address of the registered property: street, number, floor, side, postal code and town.
Street
registerStreet
Optional
Street with its kind (Rua, Avenida, Travessa…).
Street number
registerStreetNumber
Optional
Door number in the street (porta).
Floor
registerFloor
Optional
Floor (andar) as written in the register: 1º, R/C (ground floor), Cave…
Side
registerSide
Optional
Side or flat on the floor (lado): Esq. (left), Dto. (right), Frente, A…
Postal code
registerPostalCode
Optional
Postal code of the registered property.
Locality
registerLocality
Optional
Town or locality of the registered property.
Parish
registerParish
Optional
Parish (freguesia) of the registered property.
Municipality
registerMunicipality
Optional
Municipality (concelho) of the registered property.
District
registerDistrict
Optional
District (distrito) or island of the registered property (Faro = the Algarve, Ilha da Madeira).
Authorised guests
registerPlaces
Optional
Number of guests the licence allows (nº de utentes). Null = the guests were not checked.
Registered bedrooms
registerBedrooms
Optional
Bedrooms in the register (nº de quartos).
Registered beds
registerBeds
Optional
Beds in the register (nº de camas).
Registered dormitories
registerDormitories
Optional
Dormitories in the register (hostels only; null otherwise).
Registered bunk beds
registerBunkBeds
Optional
Bunk beds in the register (hostels only; null otherwise).
Occupancy permit
registerOccupancyPermit
Optional
Number of the building's occupancy permit (título de autorização de utilização) given to the register.
Built after 1951
registerBuiltAfter1951
Optional
The register's answer to Imóvel posterior a 1951? (older buildings need no occupancy permit).
Insurer
registerInsurer
Optional
Liability insurer given to the register; null when the register shows none.
Insurance policy
registerInsurancePolicy
Optional
Policy number of the liability insurance.
Insurance start
registerInsuranceStart
Optional
Start of the insurance, YYYY-MM-DD.
Insurance end
registerInsuranceEnd
Optional
End of the insurance, YYYY-MM-DD.
Register latitude
registerLatitude
Optional
Position of the registered property from Turismo de Portugal's open data (mainland only).
Register longitude
registerLongitude
Optional
Position of the registered property (mainland only).
Register position reliability
registerPositionReliability
Optional
How Turismo de Portugal rates that position: reliable, fair, unreliable (still within a few hundred metres for most records).
Distance (km)
distanceKm
Optional
Kilometres between the registered property and the listing's position on Airbnb (blurred by Airbnb by a few hundred metres).
Highest number issued
registerHighestNumber
Optional
Highest AL number in the register when the run started: a number above it was never issued.
Register source
registerSource
Optional
Official source of the record (Turismo de Portugal, Registo Nacional de Alojamento Local).
Register checked at
registerCheckedAt
Optional
ISO 8601 timestamp of the register lookup (the register is read live).
Property type
propertyType
Optional
Airbnb property type.
Room type
roomType
Optional
Entire home/apt, Private room, Shared room, Hotel room.
City
city
Optional
City shown by Airbnb.
Latitude
latitude
Optional
Listing position on Airbnb (blurred by Airbnb).
Longitude
longitude
Optional
Listing position on Airbnb (blurred by Airbnb).
Exact location on Airbnb
isExactLocation
Optional
Airbnb's own flag: false = the host did not pin the exact address (the map shows an area).
Guests
personCapacity
Optional
Maximum guests of the listing.
Bedrooms
bedrooms
Optional
Bedrooms (0 = studio).
Beds
beds
Optional
Beds.
Bathrooms
bathrooms
Optional
Bathrooms (a half bath counts 0.5).
Rating
rating
Optional
Overall guest rating out of 5.
Reviews
reviewsCount
Optional
Number of reviews.
Superhost
isSuperhost
Optional
Host is a Superhost.
Guest favourite
isGuestFavorite
Optional
Listing has Airbnb's Guest favourite badge.
New listing
isNewListing
Optional
Airbnb shows the listing as new (few or no reviews yet).
Home tier
homeTier
Optional
Airbnb's tier of the listing (1 = standard, 2 = Plus, 3 = Luxe).
Badges
badges
Required
Badges shown on the search result (e.g. Guest favorite, Featured hotel); empty for listings given by URL or ID.
[ "Guest favorite"]Accuracy rating
ratingAccuracy
Optional
Guest rating for accuracy, out of 5.
Check-in rating
ratingCheckin
Optional
Guest rating for check-in, out of 5.
Cleanliness rating
ratingCleanliness
Optional
Guest rating for cleanliness, out of 5.
Communication rating
ratingCommunication
Optional
Guest rating for communication, out of 5.
Location rating
ratingLocation
Optional
Guest rating for the location, out of 5.
Value rating
ratingValue
Optional
Guest rating for value, out of 5.
Description language
descriptionLanguage
Optional
Language code of the host's description.
Location
locationText
Optional
Area as Airbnb names it on the listing (neighbourhood, city, region, country).
About the neighbourhood
locationDescription
Optional
Host's text about the neighbourhood and getting around.
Highlights
highlights
Required
Highlights listed at the top of the listing (e.g. Self check-in).
[ "Self check-in"]House rules
houseRules
Required
House rules and check-in / checkout times shown on the listing.
[ "Check-in after 4:00 PM", "Checkout before 11:00 AM"]Additional rules
houseRulesAdditional
Optional
The host's own words under 'Additional rules' (extra guests, noise, parties…).
Where you'll sleep
sleepingArrangements
Required
Rooms and their beds (e.g. Bedroom 1: 1 double bed).
[ "Bedroom 1: 1 double bed"]Description
description
Optional
Full listing description, plain text.
Amenities
amenities
Required
Amenities shown on the listing page.
[ "Kitchen", "Wifi"]Photos
images
Required
Photo URLs.
[ "https://a0.muscache.com/im/pictures/miso/Hosting-846093318788581404/original/d5cf8e54-a36d-4d1f-9240-d858df276b3c.jpeg"]Host ID
hostId
Optional
Airbnb user ID of the host.
Host name
hostName
Optional
Host name shown on the listing.
Host profile URL
hostUrl
Optional
Public profile of the host.
Host type
hostType
Optional
business when the listing shows business details (EU rule for professional hosts) or Airbnb labels the host Business host, individual otherwise.
Host verified
hostIsVerified
Optional
Host has Airbnb's identity badge.
Years hosting
hostYearsHosting
Optional
Full years since the host started hosting (the page rounds: 3 years 10 months shows 4 years hosting; 0 under a year).
Response rate
hostResponseRate
Optional
Host response rate, %.
Response time
hostResponseTime
Optional
How fast the host usually answers.
Host rating
hostRating
Optional
Average rating over all the host's listings.
Host reviews
hostReviewsCount
Optional
Reviews over all the host's listings.
About the host
hostAbout
Optional
Host's own presentation text.
Host photo
hostPictureUrl
Optional
Host profile picture.
Host location
hostLocation
Optional
Where the host says they live (host profile, when Host's listing count is on).
Co-hosts
coHosts
Required
First names of the listing's co-hosts shown on Airbnb.
[ "Numa Guest Experience Spain"]Host's listings
hostListingsCount
Optional
Number of listings the host manages (host profile, when Host's listing count is on).
Host's listing IDs
hostListingIds
Required
IDs of the listings shown on the host profile — the first 10 at most, Airbnb shows no more there (when Host's listing count is on).
[ "846093318788581404"]Business name
businessName
Optional
Business name the host must show as a professional (EU rule).
Business registry
businessRegistry
Optional
Business register named by the host.
Business tax ID
businessTaxId
Optional
Tax identification number the business host gives.
Business e-mail
businessEmail
Optional
E-mail of the business host: the professional block Airbnb shows (free, Airbnb listings), or - with Business contact (Booking.com) - the e-mail Booking.com shows for a professional host (Booking.com properties).
Business phone
businessPhone
Optional
Phone of the business host: the professional block Airbnb shows (free, Airbnb listings), or - with Business contact (Booking.com) - the phone Booking.com shows for a professional host (Booking.com properties).
Business address
businessAddress
Optional
Address of the business host.
Price
price
Optional
Total price of the stay shown on the search results (dates of the search, or Airbnb's own dates); null for listings given by URL or ID.
Currency
currency
Optional
Currency of the price.
Price per night
pricePerNight
Optional
Average nightly rate of the priced stay, before taxes and fees.
Price (as shown)
priceText
Optional
Price label as Airbnb shows it.
Price details
priceDetails
Required
Lines of Airbnb's price breakdown (nights, taxes and fees…).
[ "5 nights x €165.93: €829.63", "Taxes and fees: €82.96"]Nights
priceNights
Optional
Number of nights the price covers.
Check-in
checkIn
Optional
First night of the priced stay, YYYY-MM-DD.
Check-out
checkOut
Optional
End of the priced stay, YYYY-MM-DD.
Search URL
searchUrl
Optional
Search the listing was found by; null for listing URLs, listing IDs, licence numbers and register records.
Booking.com ID
bookingId
Optional
Booking.com property ID (Booking rows only).
Booking.com page name
bookingPageName
Optional
Booking.com page name of the property (alfama-sunny-flat), with its country code in url.
Booking.com professional host
isTrader
Optional
Booking.com only: the host declared as a trader (professional) under EU law.
Risk score
riskScore
Optional
With Risk score (0-100): 0 (nothing wrong) to 100, the sum of the weights of the rules that fired, 100 at most; null when the option is off, the row is no listing, or the register could not be read.
Risk reasons
riskReasons
Required
With Risk score (0-100): the codes of the rules that gave the score, in the order of the rules: verdict_<verdict> (the verdict of the check), number_shared, distance_over_300m, property_type_mismatch, insurance_expired, no_insurance, host_3_or_more_listings, host_2_listings. [] when off.
[ "verdict_not_in_register"]Risk rules skipped
riskChecksSkipped
Required
With Risk score (0-100): the rules that could not play for lack of data, never counted as a risk: distance, property_type, host_listings, and always over_180_nights (this Actor reads no calendar); verdict when the register could not be read. [] when off.
[ "host_listings", "over_180_nights"]AI labels
aiLabels
Optional
Four yes / no labels read in the description of an Airbnb listing, only with AI labels (needs 2 GB of memory): managed_by_company (managed by a company or a property manager), self_check_in (self check-in with a lockbox or a keypad), long_stay (monthly or long stays, 28 nights or more), mentions_licence (the text mentions a licence or a permit). Indications read in the text, not facts. Null when the option is off, the memory was under 2 GB, the description is not in English or missing (Booking.com properties have none), or the labels could not be read for that row.
AI label scores
aiLabelScores
Optional
The confidence from 0 to 1 behind each of the AI labels, same keys, 4 decimals: a label is true from its threshold (see the README), the strongest part of a long description counts; 0 when the description says nothing about it. Null when AI labels is null.
Comparables
comparables
Required
Comparable listings (option): the Airbnb listings around this one, of the same type of place and within one bedroom of it, the nearest first (up to Max comparables per listing). Each: id, url, pricePerNight (the average nightly rate of the dates searched, before taxes and fees; null without Check-in and Check-out), currency, bedrooms, rating, distanceKm (from this listing's point, 10 m). Read from the cards of a search of the area: Airbnb blurs every position by about 150 m. Empty when the option is off, for a Booking.com property, or when nothing was found.
[ { "id": "54337662", "url": "https://www.airbnb.com/rooms/54337662", "pricePerNight": 191.11, "currency": "EUR", "bedrooms": 3, "rating": 4.69, "distanceKm": 0.18 }]Comparables median price
comparablesMedianPrice
Optional
Comparable listings (option): the median price per night of the comparables that have one, in their currency, to the cent. Null without Check-in and Check-out, or without comparables.
Photo files
photoFiles
Required
Download photos (option): the public links of the photos kept in this run's key-value store, in the order of the listing's photos (the first Max photos per listing that could be had). The links in Photos stay free. Empty when the option is off or no photo could be had.
[ "https://api.apify.com/v2/key-value-stores/x1YpOv9ds0QWjxk3D/records/photo-13231767-1.jpg"]Photo SHA-256
photoSha256
Required
Download photos (option): the SHA-256 of each photo kept, in the order of Photo files - to show that a photo is the one that was downloaded.
[ "9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08"]Photos downloaded at
photosDownloadedAt
Optional
Download photos (option): ISO 8601 time at which the photos were downloaded. Null without photos.
Professional host company
proHostCompany
Optional
Professional host contact (option): the company of a professional Airbnb host the contact below is of. Null without a contact, and when the option is off.
Professional host website
proHostWebsite
Optional
Professional host contact (option): the website of the company. Null without a contact.
Professional host e-mails
proHostEmails
Required
Professional host contact (option): business e-mail addresses of the host's company, from publicly available sources (3 at most). Empty when the option is off, when the listing already had a contact, or when none was found.
[ "info@micasasuites.pt"]Professional host phones
proHostPhones
Required
Professional host contact (option): business phone numbers of the host's company, from publicly available sources (3 at most), as +351 912 345 678. Empty when the option is off, when the listing already had a contact, or when none was found.
[ "+351 912 345 678"]Professional host contact source
proHostContactSourceUrl
Optional
Professional host contact (option): the page the contact was read from. Null without a contact.
Professional host contact confidence
proHostContactConfidence
Optional
Professional host contact (option): high when an e-mail is on the company's own domain, medium otherwise (a phone only, or an e-mail on another domain). Null without a contact.
Checked at
scrapedAt
Required
ISO 8601 timestamp of the check.