GET

Airbnb Reviews From URL API

Extract listing reviews directly from any Airbnb URL without extracting the listing ID first.

Overview

Simplified Workflow

Automatically extracts listing ID from URL and retrieves reviews in one API call.

This endpoint simplifies the review extraction process by accepting any Airbnb listing URL. It automatically parses the listing ID and retrieves the comprehensive review data, eliminating the need for manual ID extraction.

Endpoint URL

GET https://api.stayapi.com/v1/airbnb/listing/reviews-from-url

Query Parameters

Parameter Type Required Description
url string Required Full Airbnb listing URL
limit integer Optional Number of reviews per page (1-50, default: 10)
offset string Optional Pagination offset (default: "0")
sort_by string Optional Sort order: BEST_QUALITY or MOST_RECENT (default: BEST_QUALITY)
check_in string Optional Check-in date for contextual reviews (YYYY-MM-DD)
check_out string Optional Check-out date for contextual reviews (YYYY-MM-DD)

Supported URL Formats

Accepted Airbnb URL Patterns

https://www.airbnb.com/rooms/22120898 - Standard listing URL
https://airbnb.co.uk/rooms/22120898?check_in=2025-10-31 - With parameters
https://m.airbnb.com/rooms/22120898 - Mobile URL
https://www.airbnb.de/listing/22120898 - Alternative format

Response Structure

The response structure is identical to the standard listing reviews endpoint, with the addition of the extracted listing ID.

Response Fields

  • listing_id - Extracted listing ID
  • total_count - Total number of reviews
  • review_count - Reviews in current response
  • has_more - Whether more reviews exist
  • reviews - Array of review objects

Usage Tips

URL Encoding

Always URL-encode the Airbnb URL parameter to handle special characters and query parameters correctly.

URL Validation

The endpoint automatically validates and normalizes Airbnb URLs, supporting various international domains and URL formats.

Pagination

Use the offset parameter to paginate through large review sets. Check the has_more field to determine if additional pages exist.

Date Filtering

Provide check_in and check_out dates to get reviews most relevant to specific booking periods.

Request
curl -X GET "https://api.stayapi.com/v1/airbnb/listing/reviews-from-url?url=https://www.airbnb.com/rooms/22120898&limit=5" \
  -H "x-api-key: YOUR_API_KEY"
Response
{
  "success": true,
  "listing_id": 22120898,
  "total_count": 321,
  "review_count": 5,
  "has_more": true,
  "reviews": [
    {
      "id": "1092837465",
      "rating": 5,
      "text": "Absolutely perfect stay! The apartment exceeded our expectations in every way. The location was ideal for exploring the city, and the host was incredibly responsive and helpful.",
      "language": "en",
      "created_at": "2024-03-20",
      "reviewer": {
        "id": "user_789012",
        "name": "Emma Wilson",
        "picture_url": "https://a0.muscache.com/im/pictures/user/789012.jpg"
      },
      "host_response": {
        "text": "Thank you Emma! It was a pleasure hosting you. You're welcome back anytime!",
        "created_at": "2024-03-21",
        "author": "Host"
      }
    },
    {
      "id": "1092736284",
      "rating": 4,
      "text": "Great apartment with beautiful views. Everything was clean and well-maintained. The only minor issue was the Wi-Fi speed could be better for remote work.",
      "language": "en",
      "created_at": "2024-03-18",
      "reviewer": {
        "id": "user_345678",
        "name": "David Martinez",
        "picture_url": "https://a0.muscache.com/im/pictures/user/345678.jpg"
      },
      "host_response": null
    }
  ]
}