airbnb Reviews API
Operations for retrieving and responding to guest and host reviews.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/airbnb-reviews-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Airbnb Homes Reviews API
description: The Airbnb Homes API provides approved connectivity partners with programmatic access to manage vacation rental listings on the Airbnb platform.
version: 2025.03.31
contact:
name: Airbnb Developer Support
url: https://developer.withairbnb.com/
termsOfService: https://www.airbnb.com/terms
servers:
- url: https://api.airbnb.com/v2
description: Airbnb Production API Server
security:
- oauth2: []
tags:
- name: Reviews
description: Operations for retrieving and responding to guest and host reviews.
paths:
/reservations/{reservation_id}/reviews:
get:
operationId: listReservationReviews
summary: List Reservation Reviews
description: Retrieves the reviews associated with a specific reservation, including both the guest review and host response if available.
tags:
- Reviews
parameters:
- $ref: '#/components/parameters/reservationIdParam'
responses:
'200':
description: The reviews for the reservation.
content:
application/json:
schema:
type: object
properties:
reviews:
type: array
items:
$ref: '#/components/schemas/Review'
'401':
description: Authentication credentials are missing or invalid.
'404':
description: The reservation was not found.
/listings/{listing_id}/reviews:
get:
operationId: listListingReviews
summary: List Listing Reviews
description: Retrieves a paginated list of all reviews for a specific listing, including guest ratings and comments.
tags:
- Reviews
parameters:
- $ref: '#/components/parameters/listingIdParam'
- $ref: '#/components/parameters/limitParam'
- $ref: '#/components/parameters/offsetParam'
responses:
'200':
description: A paginated list of reviews for the listing.
content:
application/json:
schema:
type: object
properties:
reviews:
type: array
items:
$ref: '#/components/schemas/Review'
pagination:
$ref: '#/components/schemas/Pagination'
'401':
description: Authentication credentials are missing or invalid.
'404':
description: The listing was not found.
components:
parameters:
limitParam:
name: limit
in: query
description: The maximum number of results to return per page.
schema:
type: integer
minimum: 1
maximum: 100
default: 25
listingIdParam:
name: listing_id
in: path
required: true
description: The unique identifier of the listing.
schema:
type: string
reservationIdParam:
name: reservation_id
in: path
required: true
description: The unique identifier of the reservation.
schema:
type: string
offsetParam:
name: offset
in: query
description: The number of results to skip for pagination.
schema:
type: integer
minimum: 0
default: 0
schemas:
Pagination:
type: object
properties:
total:
type: integer
description: The total number of results available.
limit:
type: integer
description: The number of results returned per page.
offset:
type: integer
description: The current offset in the result set.
has_more:
type: boolean
description: Whether more results are available beyond this page.
Review:
type: object
properties:
id:
type: string
description: The unique identifier of the review.
reservation_id:
type: string
description: The identifier of the associated reservation.
reviewer_type:
type: string
description: Whether the review was written by a guest or host.
enum:
- guest
- host
rating:
type: integer
description: The overall star rating from 1 to 5.
minimum: 1
maximum: 5
comments:
type: string
description: The text content of the review.
category_ratings:
type: object
description: Individual category ratings provided by the reviewer.
properties:
cleanliness:
type: integer
minimum: 1
maximum: 5
description: Rating for cleanliness.
communication:
type: integer
minimum: 1
maximum: 5
description: Rating for communication.
check_in:
type: integer
minimum: 1
maximum: 5
description: Rating for check-in experience.
accuracy:
type: integer
minimum: 1
maximum: 5
description: Rating for listing accuracy.
location:
type: integer
minimum: 1
maximum: 5
description: Rating for location.
value:
type: integer
minimum: 1
maximum: 5
description: Rating for value.
host_response:
type: string
description: The host response to the review, if provided.
created_at:
type: string
format: date-time
description: The timestamp when the review was submitted.
securitySchemes:
oauth2:
type: oauth2
description: Airbnb uses OAuth 2.0 for authentication. Partners must register their application to receive a client ID and secret, then obtain access tokens through the authorization code flow. Access tokens expire after 24 hours and must be refreshed.
flows:
authorizationCode:
authorizationUrl: https://www.airbnb.com/oauth2/auth
tokenUrl: https://api.airbnb.com/v2/oauth2/authorizations
scopes:
listings:read: Read listing information
listings:write: Create and update listings
reservations:read: Read reservation information
reservations:write: Accept, deny, and cancel reservations
messages:read: Read reservation messages
messages:write: Send messages to guests
reviews:read: Read reviews
calendar:read: Read calendar availability
calendar:write: Update calendar availability and pricing
externalDocs:
description: Airbnb Developer Documentation
url: https://developer.withairbnb.com/