Accor API endpoint
Returns the static list of hotels published on one Accor destination directory page (world, continent, country, region, department, city, district, or place), optionally narrowed by a theme facet. Each hotel carries its code, name, source URL, and broad city/country. Booking, rates, rooms, reviews, contacts, and precise location are excluded.
/accor/destination/hotelsQuery parameters:
destination_type (required): destination level. One of world, continent, country, region, department, city, district, place.slug (required except for world): the destination page slug, for example hotels-dusseldorf-v1158, hotels-france-pfr, or hotels-europe-c03.theme (optional): a facet that narrows the listing. One of 4-stars, 5-stars, apart-hotel, breakfast, budget-friendly, business, eco-certified, family-friendly, fitness, luxury, meetings-and-events, parking, pet-friendly, pool, resorts, spa.Returns the static list of hotels published on that destination directory page. Each hotel carries its hotel_code, name, source_url, and broad city/country. The response also carries the destination's display name and, when requested, the applied theme. Booking, prices, rooms, reviews, contacts, and precise location are excluded.
Note: the list is the directory for that page. Small destinations (cities, districts, places) are complete; large geographies (world, continent, country) may be capped to a subset of matching hotels.
| Field | Filled in, of 14 checked | Values in the sample |
|---|---|---|
| hotel_code | 14 | |
| name | 14 | “Steigenberger Icon Parkhotel Duesseldorf” and 13 other values |
| source_url | 14 | all.accor.com |
| city | 14 | DUESSELDORF (9), NEUSS (2), DUSSELDORF (1) and 2 more |
| country | 14 | DE in all 14 |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| destination_type | string | Yes | Destination level: world, continent, country, region, department, city, district, or place Allowed values: world, continent, country, region, department, city, district, place. | world | |
| slug | string | No | Destination page slug, e.g. hotels-dusseldorf-v1158. Required for every type except world. | ||
| theme | string | No | Optional theme facet: 4-stars, 5-stars, apart-hotel, breakfast, budget-friendly, business, eco-certified, family-friendly, fitness, luxury, meetings-and-events, parking, pet-friendly, pool, resorts, or spa Allowed values: 4-stars, 5-stars, apart-hotel, breakfast, budget-friendly, business, eco-certified, family-friendly, fitness, luxury, meetings-and-events, parking, pet-friendly, pool, resorts, spa. | ||
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/accor/destination/hotels?destination_type=world&theme=4-stars" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"destination": {
"destination_type": "city",
"name": "Dusseldorf Hotels",
"source_url": "https://all.accor.com/a/en/destination/city/hotels-dusseldorf-v1158.html",
"hotels": [
{
"hotel_code": "5373",
"name": "Mercure Hotel Duesseldorf City Center",
"source_url": "https://all.accor.com/hotel/5373/index.en.shtml",
"city": "DUESSELDORF",
"country": "DE"
}
]
}
}
}Request schema
No body schema
Response schema
#/definitions/accor.destinationResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | accor.DestinationResponse | No | ||||
| data.destination | accor.Destination | No | ||||
| data.destination.destination_type | string | No | ||||
| data.destination.hotels | array | No | ||||
| data.destination.hotels[].city | string | No | ||||
| data.destination.hotels[].country | string | No | ||||
| data.destination.hotels[].hotel_code | string | No | ||||
| data.destination.hotels[].name | string | No | ||||
| data.destination.hotels[].source_url | string | No | ||||
| data.destination.name | string | No | ||||
| data.destination.source_url | string | No | ||||
| data.destination.theme | string | No | ||||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 429 | Too Many Requests | #/definitions/app.Response |
| 500 | Internal Server Error | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/accor/destination/hotels?destination_type=world&theme=4-stars" \
-H "x-api-key: $CRAWLORA_API_KEY"