theinfatuation.com APItheinfatuation.com ↗
Access The Infatuation's restaurant reviews, ratings, city guides, and neighborhood data via 5 structured endpoints covering search, browse, and detail retrieval.
curl -X GET 'https://api.parse.bot/scraper/c453b6b3-b2c3-4ad7-81ab-9ad465817930/search_restaurants?limit=5&query=pizza&location=new-york' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for restaurants by keyword and location. Returns paginated results from The Infatuation's review database. Use the endpageDirectionCode from pageInfo as the 'after' cursor for pagination.
| Param | Type | Description |
|---|---|---|
| after | string | Pagination cursor from pageInfo.endpageDirectionCode of a previous response. |
| limit | integer | Number of results to return per page. |
| query | string | Search keyword (e.g. 'pizza', 'sushi', 'brunch'). |
| locationrequired | string | City slug (e.g. 'new-york', 'los-angeles', 'chicago'). |
{
"type": "object",
"fields": {
"nodes": "array of restaurant review objects with place details, rating, categories, cuisines, neighborhoods, and contributors",
"pageInfo": "object with endpageDirectionCode (pagination cursor), startpageDirectionCode, and moreDataIndicator",
"receivedRecordCount": "integer total matching results"
},
"sample": {
"data": {
"nodes": [
{
"slugName": "lucia-pizza-of-the-upper-east-side",
"placeName": "Lucia Pizza Of The Upper East Side",
"__typename": "PostReview",
"previewText": "Lucia Pizza's third location serves excellent slices on the Upper East Side.",
"placeCityName": "New York",
"placeStreetName": "1571 Third Ave",
"documentTitleText": "Lucia Pizza Of The Upper East Side",
"placeRatingNumber": 8.5,
"documentIdentifier": "5TH30mBZec30ISh3KW8Fsf",
"postCategoryTypeText": "POST_REVIEW",
"placePriceIndicatorCode": "INEXPENSIVE"
}
],
"pageInfo": {
"moreDataIndicator": null,
"endpageDirectionCode": "REDACTED_TOKEN",
"startpageDirectionCode": null
},
"receivedRecordCount": 272
},
"status": "success"
}
}About the theinfatuation.com API
The Infatuation API exposes restaurant review and guide data across 5 endpoints, covering city discovery, neighborhood listings, keyword search, and full review retrieval. The search_restaurants endpoint lets you query by keyword and city slug, returning rated review objects with cuisine, neighborhood, and contributor fields. The get_restaurant_review endpoint delivers structured review content including full review text, editorial rating, address, and cuisine classification for a specific restaurant.
What the API covers
The Infatuation API surfaces editorial restaurant content from theinfatuation.com across five endpoints. Coverage spans city-level discovery through get_cities_list, which returns city names, URL paths, and system identifiers. Once you have a city slug, get_city_neighborhoods returns the neighborhoods for that city — each with a name, path, and ID — useful for scoping subsequent queries. Both search_restaurants and browse_restaurants_by_city accept a city slug as a required input and return paginated nodes arrays containing place details, editorial rating, categories, cuisines, neighborhood assignments, and contributor attribution.
Search and browse endpoints
search_restaurants accepts an optional query string (e.g. 'sushi', 'brunch') alongside the required location slug. browse_restaurants_by_city returns the full mix of reviews and guides for a city without a keyword filter. Both endpoints return a pageInfo object containing endpageDirectionCode, startpageDirectionCode, and moreDataIndicator. Pass endpageDirectionCode as the after cursor on the next call to page through results. The receivedRecordCount field gives the total number of matching records.
Detailed review data
get_restaurant_review requires both a city slug and a slug field (the slugName available from search results). It returns an array of JSON-LD structured review objects typed as Review, containing author, reviewBody, reviewRating, and itemReviewed — the latter encapsulating the restaurant's name, address, and cuisine. This endpoint is the right choice when you need the full editorial text rather than the summary fields returned by search and browse.
- Build a city dining guide app that lists neighborhoods via
get_city_neighborhoodsand drills into reviews withget_restaurant_review. - Aggregate editorial ratings and cuisine tags from
search_restaurantsto compare coverage across multiple cities. - Populate a restaurant recommendation engine using reviewer ratings, neighborhood IDs, and category fields from
browse_restaurants_by_city. - Extract full review text and structured address data from
get_restaurant_reviewfor NLP-based sentiment or cuisine classification work. - Map restaurant density by neighborhood using neighborhood ID and name fields returned by
get_city_neighborhoods. - Sync a curated dining dataset across all covered cities using
get_cities_listto enumerate slugs and then paginate through each city's posts.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does The Infatuation have an official public developer API?+
What does `search_restaurants` return beyond a restaurant's name?+
nodes array includes place details, an editorial rating, categories, cuisines, neighborhood assignments, and contributor attribution. The pageInfo object provides endpageDirectionCode for cursor-based pagination and a moreDataIndicator flag to detect whether additional pages exist.Does the API expose user-submitted reviews or only editorial content?+
Are menu data or reservation availability included?+
How does pagination work across search and browse endpoints?+
search_restaurants and browse_restaurants_by_city return a pageInfo object. Pass the endpageDirectionCode value from one response as the after parameter in the next request to retrieve the following page. The moreDataIndicator field tells you whether additional results remain.