Getting Started
Rate Limits
Request limits by tier and how to handle them
Rate Limits
Limits by tier
| Tier | Per minute | Per day |
|---|---|---|
| Free | 100 | 2,000 |
| Paid | Higher limits (contact for details) | Higher limits |
Rate limit responses
When you exceed a limit, the API returns an error:
{
"status": "error",
"message": "Rate limit exceeded. Please try again later."
}Best practices
- Cache responses. Restaurant data changes infrequently. Cache
lookup_restaurantresults for at least an hour. - Use the cheapest tool first. Use
find_restaurantorsearch_restaurants(free) to get IDs, thenlookup_restaurantfor details on specific restaurants. - Batch wisely. If you need details on multiple restaurants, make individual
lookup_restaurantcalls rather than broadsearch_restaurantsqueries.