Accor API endpoint
Searches the public Accor hotel index by destination or hotel name, with optional country, city, brand, star, page, and page-size filters. Results contain static hotel identity, location labels, ratings, and source URLs; booking, rates, rooms, reviews, loyalty, and payment flows are excluded.
/accor/searchQuery parameters:
query (required): destination or hotel text, at least two characters.language (optional): index locale such as en (defaults to en).page (optional): zero-based page number, 0 through 100.limit (optional): results per page, 1 through 100 (defaults to 20).country, city, brand (optional): exact static facets.stars (optional): exact star facet, 1, 2, 3, 4, or 5.The response contains static hotel identity, source URLs, location labels, stars, and published ratings. Booking, rates, rooms, reviews, loyalty, and payment flows are not returned.
| Field | Filled in, of 20 checked | Values in the sample |
|---|---|---|
| hotel_code | 20 | |
| name | 20 | “Raffles London at The OWO” and 19 other values |
| brand | 20 | “RAF” and 9 other values |
| brand_label | 20 | “Raffles” and 9 other values |
| city | 20 | London in all 20 |
| country | 20 | United Kingdom in all 20 |
| country_code | 20 | |
| source_url | 20 | all.accor.com |
| stars | 20 | 3 to 5, median 4 |
| rating | 20 | 4.5 to 4.9, median 4.6 |
| review_count | 20 | 680 to 14,983, median 1,998 |
| lodging | 20 | HTL (18), APT (2) |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| query | string | Yes | Destination or hotel query (at least two characters) | London | |
| language | string | No | Index locale | en | |
| page | integer | No | Zero-based result page | 0 | |
| limit | integer | No | Results per page, 1-100 | 20 | |
| country | string | No | Country facet | United Kingdom | |
| city | string | No | City facet | London | |
| brand | string | No | Accor brand code facet | NOVOTEL | |
| stars | integer | No | Exact star facet Allowed values: 1, 2, 3, 4, 5. | 4 | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/accor/search?query=London&language=en&page=1&limit=10&country=us&stars=1" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"query": "London",
"language": "en",
"page": 0,
"pages": 3,
"total": 56,
"limit": 20,
"hotels": [
{
"hotel_code": "C5Z1",
"name": "Old Thorns Golf Resort and Spa Hampshire by Accor",
"brand": "SAM",
"city": "London",
"country": "United Kingdom",
"country_code": "GB",
"source_url": "https://all.accor.com/hotel/C5Z1/index.en.shtml",
"stars": 4,
"rating": 4.2,
"review_count": 69
}
]
}
}Request schema
No body schema
Response schema
#/definitions/accor.searchResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | accor.SearchResponse | No | ||||
| data.hotels | array | No | ||||
| data.hotels[].brand | string | No | ||||
| data.hotels[].brand_label | string | No | ||||
| data.hotels[].city | string | No | ||||
| data.hotels[].country | string | No | ||||
| data.hotels[].country_code | string | No | ||||
| data.hotels[].hotel_code | string | No | ||||
| data.hotels[].lodging | string | No | ||||
| data.hotels[].name | string | No | ||||
| data.hotels[].rating | number | No | ||||
| data.hotels[].review_count | integer | No | ||||
| data.hotels[].source_url | string | No | ||||
| data.hotels[].stars | integer | No | ||||
| data.language | string | No | ||||
| data.limit | integer | No | ||||
| data.page | integer | No | ||||
| data.pages | integer | No | ||||
| data.query | string | No | ||||
| data.total | integer | 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/search?query=London&language=en&page=1&limit=10&country=us&stars=1" \
-H "x-api-key: $CRAWLORA_API_KEY"