GET

Accor Photos API

Get the full photo and video gallery for a single Accor property.

Overview

Ready-to-use image URLs

Image URLs are public ahstatic.com links — no signed token or expiry. Each image returns every published size variant in formats, and url is the highest-resolution one.

Returns the complete image and video set for a property, organized by category (rooms, restaurant, pool, spa, and more). Take the id from a Search result and pass it as hotel_id.

Endpoint URL

GET https://api.stayapi.com/v1/accor/hotel/photos

Parameters

Parameter	Type	Required	Description
hotel_id	string	Required	Accor hotel id from the Search endpoint (e.g., "2185")
categories	string	Optional	Comma-separated category filter (e.g., `BEDROOM,POOL`). Default: all categories
include_videos	boolean	Optional	Include video media alongside photos. Default: true

Response Format

Response Structure

success: Boolean indicating request success
hotel_id / name: The property id and name
photos: Array of media items
total: Number of media items returned
categories: Legend of category codes present, with labels

Media Item Fields

Field	Type	Description
category	string	Media category (e.g., "HOTEL", "BEDROOM", "POOL")
type	string	"IMAGE" or "VIDEO"
url	string	Highest-resolution image URL (the first/largest entry in `formats`)
formats	array	Every published size variant, each with url, width, height
video	object	For video items: embedded_url, download_url, preview_url. Null for images.

Error Responses

Errors follow the RFC 7807 Problem Details format with provider: "accor" and product: "photos".

404 Not Found

No Accor property matches that hotel_id.

502 Bad Gateway

Upstream service error from Accor.

Related Endpoints

Accor Search

Find properties and their best offer; get a hotel id

View Documentation →

Accor Rooms

Get bookable room offers and rate plans for a property

View Documentation →

Request

curl -X GET "https://api.stayapi.com/v1/accor/hotel/photos?hotel_id=2185&categories=BEDROOM,POOL" \
  -H "X-API-Key: YOUR_API_KEY"

const response = await fetch(
  "https://api.stayapi.com/v1/accor/hotel/photos?" +
  new URLSearchParams({
    hotel_id: "2185",
    categories: "BEDROOM,POOL"
  }),
  {
    headers: {
      "X-API-Key": "YOUR_API_KEY"
    }
  }
);

const data = await response.json();
console.log(`${data.total} photos`);

import requests

params = {
    "hotel_id": "2185",
    "categories": "BEDROOM,POOL"
}

response = requests.get(
    "https://api.stayapi.com/v1/accor/hotel/photos",
    params=params,
    headers={"X-API-Key": "YOUR_API_KEY"}
)

data = response.json()
print(f"{data['total']} photos")

$params = [
    "hotel_id" => "2185",
    "categories" => "BEDROOM,POOL"
];

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://api.stayapi.com/v1/accor/hotel/photos?" . http_build_query($params));
curl_setopt($ch, CURLOPT_HTTPHEADER, ["X-API-Key: YOUR_API_KEY"]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
$data = json_decode($response, true);
echo $data["total"] . " photos";

require "net/http"
require "json"

uri = URI("https://api.stayapi.com/v1/accor/hotel/photos")
params = {
  hotel_id: "2185",
  categories: "BEDROOM,POOL"
}
uri.query = URI.encode_www_form(params)

req = Net::HTTP::Get.new(uri)
req["X-API-Key"] = "YOUR_API_KEY"

res = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
  http.request(req)
end

data = JSON.parse(res.body)
puts "\#{data['total']} photos"

Response

{
  "success": true,
  "hotel_id": "2185",
  "name": "Sofitel New York",
  "total": 6,
  "photos": [
    {
      "category": "BEDROOM",
      "type": "IMAGE",
      "url": "https://www.ahstatic.com/photos/2185_ro_00_p_3000x2250.jpg",
      "formats": [
        { "url": "https://www.ahstatic.com/photos/2185_ro_00_p_3000x2250.jpg", "width": 3000, "height": 2250 },
        { "url": "https://www.ahstatic.com/photos/2185_ro_00_p_1024x768.jpg", "width": 1024, "height": 768 },
        { "url": "https://www.ahstatic.com/photos/2185_ro_00_p_120x90.jpg", "width": 120, "height": 90 }
      ],
      "video": null
    }
  ],
  "categories": [
    { "code": "BEDROOM", "label": "Rooms" }
  ]
}

{
  "type": "https://api.stayapi.com/errors/hotel-not-found",
  "title": "Hotel Not Found",
  "status": 404,
  "detail": "No Accor property matches that hotel id",
  "instance": "/v1/accor/hotel/photos",
  "provider": "accor",
  "product": "photos",
  "error_code": "HOTEL_NOT_FOUND",
  "correlation_id": "req_abc123"
}