Retrieve Photo

This endpoint retrieves all photos associated with a specific Airbnb listing, including listing, room, and amenity images along with their metadata.

Endpoint

POST

https://connect-sandbox.su-api.com/SUAPI/jservice/airbnb/photo/retrieve

---

Header

-app-id: App Id
Authorization: Basic Authorization
Content-Type: application/json

Header	Type	Required	Description
app-id	string	Yes	Your application ID. Required for authentication.
Authorization	string	Yes	Your API key. for authorization. Required for authentication.
Content-Type	string	Yes	Must be set to application/json.

---

Attributes

---

hotelid alphanumeric (Required)

Specifies the required node hotelid containing the IT provider's hotel ID for which the provider wishes to add mapping information.

---

channelhotelid alphanumeric (Required)

Specifies the unique hotel ID used in the external distribution channel or PMS (Property Management System).

---

listingid numeric (Required)

Listing ID of the property allocated by Airbnb.

---

Request

{
  "hotelid": "SUTEST01",
  "channelhotelid": "511039958",
  "listingid": "1541919118065328804"
}

---

Response

---

Success Response

{
  "Status": "Success",
  "Data": {
    "listing_photos": [
      {
        "caption": "Guest Room",
        "sort_order": 462,
        "id": "1541919118065328804_2414384984",
        "thumbnail_url": "https://a0.muscache.com/im/pictures/prohost-api/Hosting-1541919118065328804/original/51b60efa-3c25-4e05-88bf-bceb604964c2.gif?aki_policy=x_small",
        "extra_medium_url": "https://a0.muscache.com/im/pictures/prohost-api/Hosting-1541919118065328804/original/51b60efa-3c25-4e05-88bf-bceb604964c2.gif?aki_policy=x_medium",
        "category": "LISTING",
        "listing_id": "1541919118065328804",
        "small_url": "https://a0.muscache.com/im/pictures/prohost-api/Hosting-1541919118065328804/original/51b60efa-3c25-4e05-88bf-bceb604964c2.gif?aki_policy=small"
      },
      {
        "category": "LISTING_AMENITY",
        "listing_id": "1541919118065328804",
        "small_url": "https://a0.muscache.com/im/pictures/prohost-api/Hosting-1541919118065328804-Amenities/original/f4a1292b-3ceb-44ba-8c33-e8a468651d78.gif?aki_policy=small",
        "caption": "Guest Room",
        "sort_order": 1762942842,
        "id": "1541919118065328804_2403398195",
        "thumbnail_url": "https://a0.muscache.com/im/pictures/prohost-api/Hosting-1541919118065328804-Amenities/original/f4a1292b-3ceb-44ba-8c33-e8a468651d78.gif?aki_policy=x_small",
        "extra_medium_url": "https://a0.muscache.com/im/pictures/prohost-api/Hosting-1541919118065328804-Amenities/original/f4a1292b-3ceb-44ba-8c33-e8a468651d78.gif?aki_policy=x_medium",
        "metadata": {
          "accessibility_status_reason": "Mach beim nächsten Mal Fotos, die Folgendes erfüllen: Starte deine Fotoreihe an der Stelle, wo Gäste ankommen oder parken, und nimm danach alle 3 Meter auf dem Weg zum Eingang weitere Fotos auf. Mache ein separates Foto des Gästeeingangs von außen mit offener Tür, um die gesamte Schwelle zu erfassen – ideal ist ein Abstand von 2,40 Metern zum Eingang.",
          "accessibility_status": "rejected"
        },
        "facility_id": 315
      },
      {
        "small_url": "https://a0.muscache.com/im/pictures/prohost-api/Hosting-1541919118065328804-Amenities/original/49cc663a-5cf5-4a18-aed1-e67912fc1d4e.jpeg?aki_policy=small",
        "category": "LISTING_AMENITY",
        "listing_id": "1541919118065328804",
        "extra_medium_url": "https://a0.muscache.com/im/pictures/prohost-api/Hosting-1541919118065328804-Amenities/original/49cc663a-5cf5-4a18-aed1-e67912fc1d4e.jpeg?aki_policy=x_medium",
        "metadata": {
          "accessibility_status": "pending"
        },
        "sort_order": 1763548219,
        "caption": "",
        "id": "1541919118065328804_2411728622",
        "thumbnail_url": "https://a0.muscache.com/im/pictures/prohost-api/Hosting-1541919118065328804-Amenities/original/49cc663a-5cf5-4a18-aed1-e67912fc1d4e.jpeg?aki_policy=x_small",
        "facility_id": 154
      },
      {
        "small_url": "https://a0.muscache.com/im/pictures/prohost-api/Room-746982076-Amenities/original/804f997a-9fb2-4114-a20e-45212eca3489.jpeg?aki_policy=small",
        "room_id": "746982076",
        "category": "ROOM_AMENITY",
        "listing_id": "1541919118065328804",
        "sort_order": 1763548070,
        "caption": "Pool Side View",
        "id": "1541919118065328804_2411727159",
        "thumbnail_url": "https://a0.muscache.com/im/pictures/prohost-api/Room-746982076-Amenities/original/804f997a-9fb2-4114-a20e-45212eca3489.jpeg?aki_policy=x_small",
        "extra_medium_url": "https://a0.muscache.com/im/pictures/prohost-api/Room-746982076-Amenities/original/804f997a-9fb2-4114-a20e-45212eca3489.jpeg?aki_policy=x_medium",
        "metadata": {
          "accessibility_status": "pending"
        },
        "facility_id": 312
      },
      {
        "small_url": "https://a0.muscache.com/im/pictures/prohost-api/Room-746982076-Amenities/original/804f997a-9fb2-4114-a20e-45212eca3489.jpeg?aki_policy=small",
        "room_id": "746982076",
        "category": "ROOM",
        "listing_id": "1541919118065328804",
        "sort_order": 1763548070,
        "caption": "Pool Side View",
        "id": "1541919118065328804_2411727159",
        "thumbnail_url": "https://a0.muscache.com/im/pictures/prohost-api/Room-746982076-Amenities/original/804f997a-9fb2-4114-a20e-45212eca3489.jpeg?aki_policy=x_small",
        "extra_medium_url": "https://a0.muscache.com/im/pictures/prohost-api/Room-746982076-Amenities/original/804f997a-9fb2-4114-a20e-45212eca3489.jpeg?aki_policy=x_medium"
      }
    ]
  },
  "Message": "Photos retrieved successfully"
}

---

Success Response - Body Elements

Status string

Indicates the result of the API call. Will be "Success" if photos are retrieved successfully.

---

Data object

Contains the photo details of the listing.

---

listing_photos array of objects

Each object represents a photo and contains:

---

id string

Airbnb-assigned photo ID.

---

caption string

Caption of the photo.

---

sort_order numeric

Sort order of the photo.

---

thumbnail_url string

URL of the photo in small thumbnail size.

---

extra_medium_url string

URL of the photo in medium size.

---

small_url string

URL of the photo in small size.

---

category string

Category of the photo (LISTING, ROOM, LISTING_AMENITY, ROOM_AMENITY).

---

listing_id string

Airbnb listing ID associated with the photo.

---

room_id string (Optional)

ID of the Airbnb room if the photo is room-specific.

---

facility_id numeric (Optional)

ID of the facility if the photo is amenity-specific.

---

metadata object (Optional)

Contains additional info such as accessibility status.

---

Message string

Response message indicating the overall result of the photo retrieval operation.

---

Error Response

Error 1

{
  "Status": "Fail",
  "Errors": [
    {
      "Code": "981",
      "ShortText": "channelhotelid is not defined or invalid value"
    }
  ]
}

Error 2

---

Error Response - Body Elements

Status string

Indicates the result of the API call.

Will be always "Fail" in case of an error response.

---

Errors object

The response error, the root element.

---

Code string

Specific error code that helps identify the type of error.

For example: "400" indicates a bad request.

---

ShortText string

A short description of the error.

---

Message string

The message in the response.