Resy API endpoint
Returns a Resy restaurant's profile by the required `restaurant_id`: name, cuisine, `price_range` (1 to 4), rating, review count, address, neighborhood, coordinates, phone, website, menu URL, party size limits, description, `why_we_like_it`, `need_to_know` and images. `location_code` is a short city identifier.
/resy/restaurantReturns a Resy restaurant's profile: name, cuisine, price tier, rating/review count, address/neighborhood, contact info, and description text.
Query parameters:
restaurant_id (required) — Resy restaurant id (from a search result's id).Response includes name, cuisine, url_slug, price_range (1-4 $ tier), rating, review_count, location fields (address, cross_street, neighborhood, city, region, location_code (a short city identifier -- pass it as resy-cuisines's or resy-events's location param to discover more about this same city), postal_code, country, latitude, longitude), phone_number, website, menu_url, min_party_size/max_party_size, currency_symbol, average_cost_per_person, description, about, why_we_like_it, need_to_know, and images[].
| Field | In the sample | Value in the sample |
|---|---|---|
| id | Has a value | |
| name | Has a value | “Carbone” |
| cuisine | Has a value | “Italian” |
| url_slug | Has a value | |
| price_range | Has a value | 4 |
| rating | Has a value | 4.75 |
| review_count | Has a value | 34,254 |
| address | Has a value | |
| cross_street | Has a value | |
| neighborhood | Has a value | “Greenwich Village” |
| city | Has a value | “New York” |
| region | Has a value | “NY” |
| location_code | Has a value | |
| postal_code | Has a value | |
| country | Has a value | “United States” |
| latitude | Has a value | |
| longitude | Has a value | |
| phone_number | Has a value | |
| website | Has a value | carbonenewyork.com |
| menu_url | Has a value | carbonenewyork.com |
| min_party_size | Has a value | 1 |
| max_party_size | Has a value | 14 |
| currency_symbol | Has a value | “$” |
| average_cost_per_person | Has a value | |
| description | Has a value | “Carbone is an Italian restaurant in the Greenwich Village n…” |
| about | Has a value | 573 characters |
| why_we_like_it | Has a value | 235 characters |
| need_to_know | Has a value | 1,211 characters |
| images | Has a value | 5 entries |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| restaurant_id | string | Yes | Resy restaurant id | 6194 | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/resy/restaurant?restaurant_id=6194" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"id": "6194",
"name": "Carbone",
"cuisine": "Italian",
"url_slug": "carbone",
"price_range": 4,
"rating": 4.75,
"review_count": 33837,
"address": "181 Thompson Street",
"cross_street": "Bleecker Street",
"neighborhood": "Greenwich Village",
"city": "New York",
"region": "NY",
"location_code": "ny",
"postal_code": "10012",
"country": "United States",
"latitude": 40.7279891,
"longitude": -74.0002311,
"phone_number": "+12122543000",
"website": "http://carbonenewyork.com/",
"menu_url": "https://carbonenewyork.com/?menu=dinner",
"min_party_size": 1,
"max_party_size": 14,
"currency_symbol": "$",
"average_cost_per_person": "$150",
"description": "Carbone is an Italian restaurant in the Greenwich Village neighborhood of New York."
}
}Request schema
No body schema
Response schema
#/definitions/resy.restaurantResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | resy.RestaurantResponse | No | ||||
| data.about | string | No | ||||
| data.address | string | No | 181 Thompson Street | |||
| data.average_cost_per_person | string | No | $150 | |||
| data.city | string | No | New York | |||
| data.country | string | No | ||||
| data.cross_street | string | No | ||||
| data.cuisine | string | No | Italian | |||
| data.currency_symbol | string | No | $ | |||
| data.description | string | No | ||||
| data.id | string | No | ||||
| data.images | array | No | ||||
| data.latitude | number | No | ||||
| data.location_code | string | No | ny | LocationCode is Resy's short city code (e.g. "ny") -- pass it as resy-cuisines' or resy-events' location param to discover more about this same city. | ||
| data.longitude | number | No | ||||
| data.max_party_size | integer | No | 14 | |||
| data.menu_url | string | No | ||||
| data.min_party_size | integer | No | 1 | |||
| data.name | string | No | ||||
| data.need_to_know | string | No | ||||
| data.neighborhood | string | No | Greenwich Village | |||
| data.phone_number | string | No | ||||
| data.postal_code | string | No | ||||
| data.price_range | integer | No | 4 | |||
| data.rating | number | No | 4.75 | |||
| data.region | string | No | NY | |||
| data.review_count | integer | No | 33837 | |||
| data.url_slug | string | No | carbone | |||
| data.website | string | No | ||||
| data.why_we_like_it | string | No | ||||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 404 | Not Found | #/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/resy/restaurant?restaurant_id=6194" \
-H "x-api-key: $CRAWLORA_API_KEY"