BrowsableAirbnb APIs
Airbnb reviews
Read paginated public listing reviews, rating summary and host responses. Missing upstream review data fails explicitly.
POST
/v1/airbnb/reviewsSend Authorization: Bearer YOUR_API_KEY. Get an API key →
Parameters
Send these fields in a flat JSON body. Add _run to choose execution options.
urlstringRequiredPublic HTTPS Airbnb listing URL. Minimum length: 1. Maximum length: 2000. Format: uri. Pattern: ^https://([a-z0-9-]+\.)?airbnb\.(com|co\.uk|fr|de|es|it|ca|com\.au)/rooms/[0-9]+/?([?].*)?$.
limitintegerOptionalMaximum results in this response. Default: 24. Minimum: 1. Maximum: 100.
currencystringOptionalThree-letter currency code, such as USD. Default: "USD". Pattern: ^[A-Z]{3}$.
localestringOptionalLanguage code for source content, such as en. Default: "en".
offsetintegerOptionalNumber of results to skip. Start at 0. Default: 0. Minimum: 0. Maximum: 10000.
sortstringOptionalSort order. Choose an allowed value below. Default: "most_recent". Allowed: "most_recent", "most_relevant", "highest_rated", "lowest_rated".
tagstringOptionalOptional review category tag.
Response
Every response describes a run. Read result once run_status is succeeded.
run_id- The run to track. Keep it when contacting support.
run_status- Queued, running, waiting for sign-in, succeeded, or failed. Check this even after an HTTP 200.
status_url- Poll this URL while the run is pending. Keep the same run instead of starting another request.
result- The endpoint’s returned data. The example is illustrative; actual fields may be empty or unavailable.
error- On failure, inspect its code, message, retryable and action fields.
View the complete output schema
{
"type": "object",
"required": [
"success",
"fetched_at",
"listing_id",
"listing_url",
"summary",
"reviews",
"pagination",
"request"
],
"properties": {
"request": {
"type": "object",
"required": [
"limit",
"offset",
"sort",
"tag_name",
"tag_label"
],
"properties": {
"sort": {
"type": "string"
},
"limit": {
"type": "integer"
},
"offset": {
"type": "integer"
},
"tag_name": {
"type": [
"string",
"null"
]
},
"tag_label": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
"reviews": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"highlight_mentions",
"review_photo_urls"
],
"properties": {
"id": {
"type": "string"
},
"rating": {
"type": [
"number",
"null"
]
},
"comments": {
"type": [
"string",
"null"
]
},
"language": {
"type": [
"string",
"null"
]
},
"response": {
"type": [
"string",
"null"
]
},
"reviewee": {
"type": "object",
"required": [],
"properties": {
"name": {
"type": [
"string",
"null"
]
},
"picture_url": {
"type": [
"string",
"null"
]
},
"profile_url": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
"reviewer": {
"type": "object",
"required": [],
"properties": {
"name": {
"type": [
"string",
"null"
]
},
"picture_url": {
"type": [
"string",
"null"
]
},
"profile_url": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
"created_at": {
"type": [
"string",
"null"
]
},
"highlight_type": {
"type": [
"string",
"null"
]
},
"localized_date": {
"type": [
"string",
"null"
]
},
"review_photo_urls": {
"type": "array",
"items": {
"type": "string"
}
},
"reviewer_location": {
"type": [
"string",
"null"
]
},
"highlight_mentions": {
"type": "array",
"items": {
"type": "string"
}
},
"localized_responded_date": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
}
},
"success": {
"type": "boolean",
"const": true
},
"summary": {
"type": "object",
"required": [
"overall_rating",
"overall_count",
"heading_title",
"heading_subtitle_html",
"heading_subtitle_text",
"categories",
"rating_distribution",
"available_tags",
"available_sorts"
],
"properties": {
"categories": {
"type": "array",
"items": {
"type": "object",
"required": [],
"properties": {
"type": {
"type": [
"string",
"null"
]
},
"label": {
"type": [
"string",
"null"
]
},
"rating": {
"type": [
"number",
"null"
]
},
"formatted_rating": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
}
},
"heading_title": {
"type": [
"string",
"null"
]
},
"overall_count": {
"type": [
"number",
"null"
]
},
"available_tags": {
"type": "array",
"items": {
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string"
},
"count": {
"type": [
"number",
"null"
]
},
"label": {
"type": [
"string",
"null"
]
},
"icon_url": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
}
},
"overall_rating": {
"type": [
"number",
"null"
]
},
"available_sorts": {
"type": "array",
"items": {
"type": "object",
"required": [
"value"
],
"properties": {
"title": {
"type": [
"string",
"null"
]
},
"value": {
"type": "string"
}
},
"additionalProperties": false
}
},
"rating_distribution": {
"type": "array",
"items": {
"type": "object",
"required": [],
"properties": {
"label": {
"type": [
"string",
"null"
]
},
"percentage": {
"type": [
"number",
"null"
]
},
"formatted_percentage": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
}
},
"heading_subtitle_html": {
"type": [
"string",
"null"
]
},
"heading_subtitle_text": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
"fetched_at": {
"type": "string",
"format": "date-time"
},
"listing_id": {
"type": "string"
},
"pagination": {
"type": "object",
"required": [
"total_count",
"offset",
"limit",
"has_more",
"next_offset"
],
"properties": {
"limit": {
"type": "integer"
},
"offset": {
"type": "integer"
},
"has_more": {
"type": "boolean"
},
"next_offset": {
"type": [
"integer",
"null"
]
},
"total_count": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": false
},
"listing_url": {
"type": "string"
}
},
"additionalProperties": false
}View a polled run response
{
"run_id": "00000000-0000-4000-8000-000000000001",
"task_key": "airbnb-reviews",
"task_name": "Airbnb reviews",
"run_status": "succeeded",
"status_url": "/v1/runs/00000000-0000-4000-8000-000000000001",
"result": {
"request": {
"sort": "sample",
"limit": 1,
"offset": 1,
"tag_name": "Stylish Shoreditch Loft with Balcony",
"tag_label": "Stylish Shoreditch Loft with Balcony"
},
"reviews": [
{
"id": "id-1",
"rating": 4.91,
"comments": "sample",
"language": "sample",
"response": "sample",
"reviewee": {
"name": "Stylish Shoreditch Loft with Balcony",
"picture_url": "https://example.com/item-1",
"profile_url": "https://example.com/item-1"
},
"reviewer": {
"name": "Stylish Shoreditch Loft with Balcony",
"picture_url": "https://example.com/item-1",
"profile_url": "https://example.com/item-1"
},
"created_at": "2026-06-14T15:30:00Z",
"highlight_type": "sample",
"localized_date": "sample",
"review_photo_urls": [
"https://images.example.com/review_photo_urls-1.jpg"
],
"reviewer_location": "London",
"highlight_mentions": [
"sample"
],
"localized_responded_date": "sample"
}
],
"success": true,
"summary": {
"categories": [
{
"type": "sample",
"label": "Stylish Shoreditch Loft with Balcony",
"rating": 4.91,
"formatted_rating": "sample"
}
],
"heading_title": "Stylish Shoreditch Loft with Balcony",
"overall_count": 1,
"available_tags": [
{
"name": "Stylish Shoreditch Loft with Balcony",
"count": 1,
"label": "Stylish Shoreditch Loft with Balcony",
"icon_url": "https://images.example.com/icon_url-1.jpg"
}
],
"overall_rating": 4.91,
"available_sorts": [
{
"title": "Stylish Shoreditch Loft with Balcony",
"value": "180"
}
],
"rating_distribution": [
{
"label": "Stylish Shoreditch Loft with Balcony",
"percentage": 1.5,
"formatted_percentage": "Featured"
}
],
"heading_subtitle_html": "Stylish Shoreditch Loft with Balcony",
"heading_subtitle_text": "Stylish Shoreditch Loft with Balcony"
},
"fetched_at": "sample",
"listing_id": "id-1",
"pagination": {
"limit": 1,
"offset": 1,
"has_more": true,
"next_offset": 1,
"total_count": 1
},
"listing_url": "https://example.com/item-1"
},
"error": null
}Errors & retries
400Fix the fields listed inerrorsbefore retrying.428Connect the requested website account using the returned sign-in link.429Wait for the duration inRetry-After.5xxRetry transient failures with backoff. Keep the request ID.
A failed run has its own error inside the response. Retry it only when error.retryable is true.
More examples
Async request with polling
RUN=$(curl -s -X POST "https://api-ingress-worker-staging.browsable-staging.workers.dev/v1/airbnb/reviews" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://www.airbnb.com/rooms/21944286"}')
RUN_ID=$(echo "$RUN" | jq -er '.run_id // empty') || { echo "$RUN" >&2; exit 1; }
POLL_DELAY=3
while true; do
RESULT=$(curl -s -H "Authorization: Bearer YOUR_API_KEY" "https://api-ingress-worker-staging.browsable-staging.workers.dev/v1/runs/$RUN_ID")
STATUS=$(echo "$RESULT" | jq -r '.run_status')
if [[ "$STATUS" =~ ^(succeeded|failed|errored|cancelled|canceled|expired)$ ]]; then
echo "$RESULT"
break
fi
sleep "$(awk "BEGIN { print $POLL_DELAY * (0.9 + ($RANDOM % 21) / 100) }")"
POLL_DELAY=$((POLL_DELAY < 30 ? POLL_DELAY * 2 : 30))
[ "$POLL_DELAY" -gt 30 ] && POLL_DELAY=30
doneWait-for-results request
curl -X POST "https://api-ingress-worker-staging.browsable-staging.workers.dev/v1/airbnb/reviews" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://www.airbnb.com/rooms/21944286","_run":{"async":false}}'Canonical & compatibility routes
You can also send the same JSON body to /v1/tasks/airbnb-reviews/runs.