Accor API

The Accor API for hotel content, reviews, rooms, and rates.

Q: Is the Accor API free?

You get 50 free requests on signup, every endpoint included, no credit card. After that it is flat monthly plans. One request equals one credit, with no per-endpoint multipliers.

Pull hotel search, property details, amenities, guest reviews, room offers, price calendars, and media across Accor brands like Sofitel, Fairmont, Pullman, Novotel, Mercure, and Ibis as clean JSON.

REQUEST GET

USE CASE Search Accor hotels near a location, each with its best offer for the dates.

curl "https://api.stayapi.com/v1/accor/search" \
  -G \
  -H "x-api-key: $STAYAPI_KEY" \
  -d "latitude=40.758" \
  -d "longitude=-73.985" \
  -d "radius_km=15" \
  -d "currency=USD" \
  -d "limit=3"

USE CASE Bookable room offers and rate plans for one Accor property by hotel_id.

curl "https://api.stayapi.com/v1/accor/hotel/rooms" \
  -G \
  -H "x-api-key: $STAYAPI_KEY" \
  -d "hotel_id=C5U9" \
  -d "check_in=2026-06-20" \
  -d "check_out=2026-06-22" \
  -d "adults=2"

USE CASE Cheapest offer per date for an Accor property across a window.

curl "https://api.stayapi.com/v1/accor/hotel/price-calendar" \
  -G \
  -H "x-api-key: $STAYAPI_KEY" \
  -d "hotel_id=2185" \
  -d "date_from=2026-06-20" \
  -d "date_to=2026-06-27"

USE CASE Full photo and video gallery for an Accor property by category.

curl "https://api.stayapi.com/v1/accor/hotel/photos" \
  -G \
  -H "x-api-key: $STAYAPI_KEY" \
  -d "hotel_id=2185" \
  -d "categories=BEDROOM,POOL"

RESPONSE 200 OK

2.41s

{
  "success": true,
  "total": 3,
  "price_range": {
    "min": 36,
    "max": 1620
  },
  "hotels": [
    {
      "id": "C5U9",
      "name": "Hard Rock Hotel New York - Partner of ALL Accor",
      "brand": {
        "code": "HAR",
        "name": "Hard Rock"
      },
      "stars": 4.5,
      "rating": null,
      "amenities": [
        "PARKING",
        "PET",
        "RESTAURANT"
      ],
      "address": {
        "street": "159 W 48 Street",
        "city": "New York",
        "postal_code": "10036",
        "country_code": "US"
      },
      "distance_meters": 304,
      "availability_status": "AVAILABLE",
      "best_offer": {
        "currency": "USD",
        "per_night": 405,
        "total": 405,
        "formatted": "$405",
        "meal_plan": "EUROPEAN_PLAN",
        "nights": 1
      }
    }
  ]
}

{
  "success": true,
  "hotel_id": "C5U9",
  "currency": "USD",
  "availability_status": "AVAILABLE",
  "total_offers": 21,
  "room_types": [
    {
      "accommodation_code": "KGD",
      "rates": [
        {
          "rate_code": "1RA4",
          "rate_label": "ADVANCE SAVER RATE",
          "meal_plan": "EUROPEAN_PLAN",
          "per_night": 513.78,
          "total": 1027.55,
          "formatted": "$1,027.55",
          "cancellation_label": "Non-refundable",
          "guarantee_label": "Online payment",
          "points": null,
          "alternative": {
            "amount": 1076.8,
            "formatted": "$1,076.80",
            "bookable": true
          },
          "nights": 2
        }
      ]
    }
  ]
}

{
  "success": true,
  "hotel_id": "2185",
  "name": "Sofitel New York",
  "brand": {
    "code": "SOF",
    "name": "Sofitel"
  },
  "currency": "USD",
  "total": 8,
  "calendar": [
    {
      "date": "2026-06-20",
      "status": "AVAILABLE",
      "amount": 479,
      "formatted": "$479",
      "aggregation_type": "TOTAL_STAY",
      "nights": 1
    },
    {
      "date": "2026-06-22",
      "status": "UNAVAILABLE",
      "amount": null,
      "formatted": null,
      "nights": null
    }
  ]
}

{
  "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
        }
      ],
      "video": null
    }
  ],
  "categories": [
    {
      "code": "BEDROOM",
      "label": "Rooms"
    }
  ]
}

Start free with 50 requests Read the docs

99.9% uptime ~3s avg response Live, not cached

Trusted by hospitality teams at

Overview

What the Accor API gives you.

Accor runs ALL, Accor Live Limitless, across dozens of brands from Raffles and Sofitel down to Ibis, but there is no public self-serve API for the property content, reviews, brand.com rates, room offers, and availability that product and revenue teams track. The usual answer is a scraping stack: headless browsers, rotating proxies, and a parser that breaks every time the booking flow changes.

StayAPI is that layer, run for you. Send a destination, a public Accor URL, or a hotel_id and get structured JSON back: hotel content and amenities, guest reviews and property responses, live room rate plans, a cheapest-price-per-date calendar, and the full media gallery. The same data, the same shape, on every call.

One key, every Accor brand.

X-API-Key in, JSON out. Search, details, amenities, reviews, rooms, price calendar, and photos behind one base URL, covering Sofitel, Fairmont, Pullman, Novotel, Mercure, Ibis, and partner properties. No SDK to install.

We run the hard part.

Fetching, parsing, proxy rotation, and source uptime are ours. Take the id from search, or resolve it from an Accor URL, then use it across every property endpoint.

Real-time, not cached.

Every call hits Accor live, so brand.com rates, member pricing, and availability are current to the request and to the currency and country_market you ask for.

View pricing View the docs

Endpoints

Every Accor endpoint, one base URL.

Each returns normalized JSON in the same shape. Click any endpoint for parameters, an example response, and a live playground.

GET Hotel search /v1/accor/search Find Accor hotels by coordinates or a destination slug, each with brand, stars, address, and its best offer for your dates. GET URL to hotel ID /v1/accor/hotel/url-to-id Resolve an all.accor.com hotel URL to the property id used by every hotel endpoint, without an upstream request. GET Hotel details /v1/accor/hotel/details Complete property content with contact details, location, ratings, room names, facilities, payment methods, and media previews. GET Hotel amenities /v1/accor/hotel/amenities Detailed amenity categories and services with fee, coverage, and location metadata plus room inventory. GET Hotel reviews /v1/accor/hotel/reviews Guest reviews with ratings, text, trip type, dates, and hotel responses, plus the property's aggregate score. GET Hotel rooms /v1/accor/hotel/rooms Bookable room offers for one property, grouped by accommodation code, with rate plans, meal plan, cancellation, and loyalty pricing. GET Price calendar /v1/accor/hotel/price-calendar Cheapest available offer per date across a window of up to 60 days, with an availability status for each day. GET Hotel photos /v1/accor/hotel/photos Full photo and video gallery for a property, by category, with every published size variant as a ready-to-use public URL.

Browse the full Accor docs

Use cases

What teams build on the Accor API.

The same endpoints, pointed at different jobs. These are the ones we see most.

Brand.com rate shopping vs OTAs.

Pull Accor's own brand.com rate per room and date, then compare it against what the OTAs show for the same property to catch parity gaps.

Room and availability tracking.

Poll rooms for a property across dates and occupancy to watch rate plans, member prices, and cancellation terms move over time.

Price calendar and seasonality.

Use the per-date cheapest offer to map a property's seasonality, find the best dates to stay, and chart how a 60-day window prices out.

Direct vs OTA comparison.

Benchmark the brand.com member rate against third-party channels to quantify the gap a guest sees on the official site versus an OTA.

Content and photo sync.

Keep property descriptions, named room types, amenities, facilities, and photo galleries current in your own database from normalized responses.

Guest feedback monitoring.

Track Accor guest ratings, review text, trip types, and hotel responses alongside the property's aggregate score.

Also over MCP

Accor data, inside your AI agent.

The same endpoints are exposed as MCP tools. Connect Claude, Cursor, or Claude Code, ask in plain English, and the agent calls the tool and answers from live Accor data.

See the MCP setup Read the MCP docs

Claude

Find Accor hotels near Times Square for two nights next week and tell me the cheapest one.

Used accor_search 2.41s

Cheapest is Hard Rock Hotel New York at $405 total, 304m from the center. Sofitel New York is next. Want room offers for either?

Pricing

50 free requests on signup.
Pick a plan when you need more.

Flat monthly plans, every endpoint included on every plan. 1 request = 1 credit. No per-endpoint multipliers, no surprise overages.

01 Free

Wire it up. See the schema.

$0 to start

50 free requests on signup
Every endpoint included
No credit card required
Same schema as paid

Start free

02 Basic

Kick the tires in production.

$49 per month

1,500 requests / month
Every endpoint included
Per-endpoint usage dashboard
Email support

Start Basic

What people ask about the Accor API.

Don't see your question? Email us at info@stayapi.com.

Does Accor have a public API?

Accor has connectivity programs for distribution partners, but no public, self-serve data API for the brand.com rates, rooms, and availability that revenue and product teams need. StayAPI gives you that data over plain REST with a key you get in 30 seconds.

Can I get Accor rates and rooms via API?

Yes. Call /v1/accor/search to find properties with each one's best offer, then pass the id to /v1/accor/hotel/rooms for full rate plans: per-night and total price, meal plan, cancellation terms, and member or loyalty pricing. It works across Accor brands like Sofitel, Pullman, Novotel, and Ibis. See the rooms endpoint docs.

How do I get the Accor price calendar?

Call /v1/accor/hotel/price-calendar with a hotel_id, date_from, and date_to. For each date in the window it returns the cheapest available offer for a stay starting that day, with a null price on unavailable dates. The window can span up to 60 days. See the price calendar docs.

Can I get Accor hotel details and reviews from an Accor URL?

Yes. Pass the public hotel URL to /v1/accor/hotel/url-to-id, then use the returned hotel_id with the details, amenities, reviews, rooms, photos, or price-calendar endpoint. URL resolution is local and does not make an upstream request.

Is the Accor API free?

You get 50 free requests on signup, every endpoint included, no credit card. After that it is flat monthly plans. One request equals one credit, with no per-endpoint multipliers.

What response format does the API return?

JSON over HTTPS, the same shape on every call. REST works in any language with no SDK to install. Prices respect the currency and country_market you pass, since both affect Accor's brand.com pricing. Examples live in the docs.

Two ways to start.

Both end with live Accor data in your stack. The fast path is on the left.

01 · the fast path

Try it free

50 free requests after sign up. Fastest way to see if the schema fits.