FiveGuys API endpoint
Use Crawlora's Five Guys Nearby API to extract supported public FiveGuys data as structured JSON. This page includes request parameters, cURL examples, response schema, error behavior, credit cost, and a Playground link for testing before integration.
/fiveguys/nearbyReturns Five Guys restaurants within a radius of a latitude/longitude. Each result carries a full profile: a short area/plaza label distinguishing it from other locations, address, phone, weekly in-store hours plus a separate delivery-hours schedule when published, price tier, restaurant-amenity labels (e.g. Takeout, Dine In, Curbside), pickup/delivery service labels, order/delivery/menu URLs, a Google Place id, and distance in miles/kilometers from the given coordinate. `total_results` reports how many restaurants fall inside the radius overall, usually more than one page; use `offset` to page. A coordinate with no Five Guys nearby returns an empty list rather than an error. Developers commonly use this endpoint for data enrichment, monitoring, research dashboards, internal automation, and agent-native workflows that need repeatable structured public web data. Authentication uses the documented Crawlora headers, and usage is metered with the credit cost shown on this page.
Request parameters are generated from the active endpoint catalog. Required values must be sent before Crawlora can call the upstream public web data source.
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| latitude | number | Yes | Search center latitude | ||
| longitude | number | Yes | Search center longitude | ||
| radius | integer | No | Search radius in miles, 1-100 (default 25) | ||
| limit | integer | No | Maximum restaurants to return, 1-50 (default 10) | ||
| offset | integer | No | Result offset for paging through total_results (default 0) | ||
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/fiveguys/nearby?limit=10" \ -H "x-api-key: $CRAWLORA_API_KEY"
Send your scraping API key in the x-api-key header. Use the console API Keys page to rotate or select the active key.
Endpoint usage is metered in credits. The plan prices, included credits, limits, and overage rates below match the active backend billing configuration.
| Plan | Price | Included credits | Daily cap | Rate limit | Overage |
|---|---|---|---|---|---|
| Free | $0/mo | 2,000 | 500 daily credits | 5/min | No overage |
| Starter | $9/mo | 20,000 | 5,000 daily credits | 15/min | $0.75/1,000 overage credits when enabled |
| Growth | $29/mo | 100,000 | 25,000 daily credits | 45/min | $0.45/1,000 overage credits when enabled |
| Pro | $79/mo | 400,000 | No daily cap | 120/min | $0.30/1,000 overage credits |
| Business | $199/mo | 1,200,000 | No daily cap | 300/min | $0.20/1,000 overage credits |
| Enterprise | $499/mo | 5,000,000 | No daily cap | 1,000/min | $0.12/1,000 overage credits |
This endpoint is executed through Crawlora's managed scraping infrastructure.
Crawlora does not silently return bad data when the upstream page cannot be used.
| Status | Common failure case |
|---|---|
| 400 | Invalid input or missing required parameter |
| 429 | Plan or endpoint rate limit exceeded |
| 500 | Internal execution error |
| 502 | Upstream platform failed, returned unusable HTML, or served a challenge page that could not be resolved |
When possible, Crawlora returns structured error context so your integration can retry, back off, or inspect the request.
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 429 | Too Many Requests | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
{
"code": 200,
"msg": "OK",
"data": {
"locations": [
{
"id": "4020",
"name": "Five Guys",
"geomodifier": "Michigan Ave",
"address": {
"line1": "180 N Michigan Ave",
"city": "Chicago",
"region": "IL",
"postal_code": "60601",
"country": "US"
},
"latitude": 41.885572,
"longitude": -87.624864,
"phone": "+13122919686",
"hours": {
"monday": {
"closed": false,
"open_intervals": [
{
"start": "10:00",
"end": "23:00"
}
]
},
"tuesday": {
"closed": false,
"open_intervals": [
{
"start": "10:00",
"end": "23:00"
}
]
},
"wednesday": {
"closed": false,
"open_intervals": [
{
"start": "10:00",
"end": "23:00"
}
]
},
"thursday": {
"closed": false,
"open_intervals": [
{
"start": "10:00",
"end": "23:00"
}
]
},
"friday": {
"closed": false,
"open_intervals": [
{
"start": "10:00",
"end": "23:00"
}
]
},
"saturday": {
"closed": false,
"open_intervals": [
{
"start": "10:00",
"end": "23:00"
}
]
},
"sunday": {
"closed": false,
"open_intervals": [
{
"start": "10:00",
"end": "23:00"
}
]
}
},
"delivery_hours": {
"monday": {
"closed": false,
"open_intervals": [
{
"start": "10:00",
"end": "22:45"
}
]
},
"tuesday": {
"closed": false,
"open_intervals": [
{
"start": "10:00",
"end": "22:45"
}
]
},
"wednesday": {
"closed": false,
"open_intervals": [
{
"start": "10:00",
"end": "22:45"
}
]
},
"thursday": {
"closed": false,
"open_intervals": [
{
"start": "10:00",
"end": "22:45"
}
]
},
"friday": {
"closed": false,
"open_intervals": [
{
"start": "10:00",
"end": "22:45"
}
]
},
"saturday": {
"closed": false,
"open_intervals": [
{
"start": "10:00",
"end": "22:45"
}
]
},
"sunday": {
"closed": false,
"open_intervals": [
{
"start": "10:00",
"end": "22:45"
}
]
}
},
"price_range": "$",
"timezone": "America/Chicago",
"services": [
"Takeout",
"Dine In"
],
"pickup_and_delivery_services": [
"In-Store Pickup"
],
"order_url": "https://order.fiveguys.com/location/five-guys-michigan-ave/menu",
"delivery_url": "https://order.fiveguys.com/location/five-guys-michigan-ave/menu",
"menu_url": "http://www.fiveguys.com/Menu",
"website_url": "https://restaurants.fiveguys.com/180-n-michigan-ave",
"path": "180-n-michigan-ave",
"google_place_id": "ChIJHTEJ8EgtDogRepA4KPyvUCU",
"distance_miles": 0.46,
"distance_kilometers": 0.74
}
],
"count": 1,
"total_results": 18,
"radius": 25,
"source_url": "https://prod-cdn.us.yextapis.com/v2/accounts/me/search/vertical/query?api_key=...&experienceKey=five-guys-us-locator&verticalKey=restaurants&filters=%7B%22builtin.location%22%3A%7B%22%24near%22%3A%7B%22lat%22%3A41.881953%2C%22lng%22%3A-87.632362%2C%22radius%22%3A40233.6%7D%7D%7D&limit=10",
"fetched_at": "2026-09-05T04:00:00Z"
}
}Request schema
No body schema
Response schema
#/definitions/fiveguys.nearbyResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | Code is the HTTP status code or a custom code used to indicate the result of the request @example 200 | |||
| data | fiveguys.NearbyResponse | No | ||||
| data.count | integer | No | 10 | |||
| data.fetched_at | string | No | ||||
| data.locations | array | No | ||||
| data.locations[].address | fiveguys.LocationAddress | No | ||||
| data.locations[].address.city | string | No | Chicago | |||
| data.locations[].address.country | string | No | US | |||
| data.locations[].address.line1 | string | No | 180 N Michigan Ave | |||
| data.locations[].address.line2 | string | No | ||||
| data.locations[].address.postal_code | string | No | 60601 | |||
| data.locations[].address.region | string | No | IL | |||
| data.locations[].delivery_hours | unknown | No | DeliveryHours is this location's delivery-order cutoff schedule, kept separate from Hours (in-store hours) because Yext publishes the two independently and they can differ -- confirmed live 2026-09-05: a Chicago location open in-store until midnight cuts delivery off at 23:45. Nil when Yext has not published a delivery schedule for this location (e.g. it does not offer delivery). | |||
| data.locations[].delivery_url | string | No | ||||
| data.locations[].distance_kilometers | number | No | 0.74 | |||
| data.locations[].distance_miles | number | No | 0.46 | DistanceMiles/DistanceKilometers are measured from the resolved search center -- the coordinate GET /fiveguys/nearby was given, or the location GET /fiveguys/search's `query` text resolved to. | ||
| data.locations[].geomodifier | string | No | Michigan Ave | Geomodifier is Yext's short area/plaza descriptor for this location (e.g. "Michigan Ave", "Medical District") -- every location's Name is the generic brand name "Five Guys", so Geomodifier is the field that actually distinguishes one result from another the way restaurants.fiveguys.com's own location pages title themselves ("Five Guys Medical District"). Empty when Yext has not published one. | ||
| data.locations[].google_place_id | string | No | ChIJHTEJ8EgtDogRepA4KPyvUCU | GooglePlaceID is this location's Google Places identifier, when Yext has published one, matching this repo's other Yext-family locators. | ||
| data.locations[].hours | fiveguys.WeeklyHours | No | ||||
| data.locations[].hours.friday | fiveguys.DayHours | No | ||||
| data.locations[].hours.friday.closed | boolean | No | false | |||
| data.locations[].hours.friday.open_intervals | array | No | ||||
| data.locations[].hours.friday.open_intervals[].end | string | No | 23:00 | |||
| data.locations[].hours.friday.open_intervals[].start | string | No | 10:00 | |||
| data.locations[].hours.monday | fiveguys.DayHours | No | ||||
| data.locations[].hours.monday.closed | boolean | No | false | |||
| data.locations[].hours.monday.open_intervals | array | No | ||||
| data.locations[].hours.monday.open_intervals[].end | string | No | 23:00 | |||
| data.locations[].hours.monday.open_intervals[].start | string | No | 10:00 | |||
| data.locations[].hours.saturday | fiveguys.DayHours | No | ||||
| data.locations[].hours.saturday.closed | boolean | No | false | |||
| data.locations[].hours.saturday.open_intervals | array | No | ||||
| data.locations[].hours.saturday.open_intervals[].end | string | No | 23:00 | |||
| data.locations[].hours.saturday.open_intervals[].start | string | No | 10:00 | |||
| data.locations[].hours.sunday | fiveguys.DayHours | No | ||||
| data.locations[].hours.sunday.closed | boolean | No | false | |||
| data.locations[].hours.sunday.open_intervals | array | No | ||||
| data.locations[].hours.sunday.open_intervals[].end | string | No | 23:00 | |||
| data.locations[].hours.sunday.open_intervals[].start | string | No | 10:00 | |||
| data.locations[].hours.thursday | fiveguys.DayHours | No | ||||
| data.locations[].hours.thursday.closed | boolean | No | false | |||
| data.locations[].hours.thursday.open_intervals | array | No | ||||
| data.locations[].hours.thursday.open_intervals[].end | string | No | 23:00 | |||
| data.locations[].hours.thursday.open_intervals[].start | string | No | 10:00 | |||
| data.locations[].hours.tuesday | fiveguys.DayHours | No | ||||
| data.locations[].hours.tuesday.closed | boolean | No | false | |||
| data.locations[].hours.tuesday.open_intervals | array | No | ||||
| data.locations[].hours.tuesday.open_intervals[].end | string | No | 23:00 | |||
| data.locations[].hours.tuesday.open_intervals[].start | string | No | 10:00 | |||
| data.locations[].hours.wednesday | fiveguys.DayHours | No | ||||
| data.locations[].hours.wednesday.closed | boolean | No | false | |||
| data.locations[].hours.wednesday.open_intervals | array | No | ||||
| data.locations[].hours.wednesday.open_intervals[].end | string | No | 23:00 | |||
| data.locations[].hours.wednesday.open_intervals[].start | string | No | 10:00 | |||
| data.locations[].id | string | No | 4020 | ID is Yext's internal entity id for this restaurant. | ||
| data.locations[].latitude | number | No | 41.885572 | Latitude/Longitude are Yext's display coordinate (rooftop-accurate pin location), falling back to the raw geocoded coordinate when Yext has not published a display override. | ||
| data.locations[].longitude | number | No | -87.624864 | |||
| data.locations[].menu_url | string | No | ||||
| data.locations[].name | string | No | Five Guys | |||
| data.locations[].order_url | string | No | OrderURL and DeliveryURL point at order.fiveguys.com, which this repo cannot reach (confirmed hard wall -- see service.go); they are still published here since Five Guys publishes them and a caller may want to hand the URL to an end user. | |||
| data.locations[].path | string | No | 180-n-michigan-ave | Path is the restaurants.fiveguys.com slug for this location. | ||
| data.locations[].phone | string | No | +13122919686 | |||
| data.locations[].pickup_and_delivery_services | array | No | PickupAndDeliveryServices are Five Guys' own fulfillment-channel labels, e.g. "In-Store Pickup". | |||
| data.locations[].price_range | string | No | $ | |||
| data.locations[].services | array | No | Services are Five Guys' own restaurant-amenity labels for this location, e.g. "Takeout", "Dine In", "Curbside", "Mobile Ordering". | |||
| data.locations[].timezone | string | No | America/Chicago | |||
| data.locations[].website_url | string | No | https://restaurants.fiveguys.com/180-n-michigan-ave | |||
| data.radius | integer | No | 25 | |||
| data.source_url | string | No | ||||
| data.total_results | integer | No | 18 | TotalResults is how many restaurants fall inside the radius overall, usually more than one page. Use it with offset to page. | ||
| msg | unknown | No | Msg is the message that describes the result of the request @example "Request successful" |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/fiveguys/nearby?limit=10" \
-H "x-api-key: $CRAWLORA_API_KEY"Crawlora is designed for responsible structured public web data workflows. Customers are responsible for using Crawlora in compliance with applicable laws, third-party rights, target-platform rules, and Crawlora terms.
Read Crawlora terms