Foursquare reviews API documentation
We provide a simple to setup REST API that returns reviews in JSON format. Before integrating the API you should be aware of the following:
- The Foursquare API returns 50 reviews per request.
- The order in which reviews are returned is by descending date(from newest to oldest).
- You can get all reviews from a single place by using the
offsetparameter.
To get reviews from Wextractor you will need to perform GET requests against
the https://wextractor.com/api/v1/reviews/foursquare endpoint.
Reviews endpoint parameters:
| Parameter | Required | Description | Example |
|---|---|---|---|
| auth_token | Required | Your API token for authentication. Once you register to Wextractor you can extract this key from your account's setting page. | - |
| id | Required | A textual identifier that uniquely identifies a place in Foursquare. This identifier can be taken from the url of the place in Foursquare. For example, if the url for the place in Foursquare is https://foursquare.com/v/b--h-dairy/4b2fadfdf964a520e6ed24e3 the identifier is 4b2fadfdf964a520e6ed24e3
|
4b2fadfdf964a520e6ed24e3 |
| offset | Optional | This parameter defines the result offset. It skips the given number of reviews. It's used for pagination. (e.g., 0 (default) is the first page of results, 50 is the 2nd page of results, 100 is the 3rd page of results, etc.). | 50 |
Example usage:
https://wextractor.com/api/v1/reviews/foursquare?id=4b2fadfdf964a520e6ed24e3&auth_token=XXXXX&offset=0
Example response:
{
"reviews": [
{
"id": "5f5cef2154e42b0c9cfea5d3",
"url": "https://foursquare.com/item/5f5cef2154e42b0c9cfea5d3",
"reviewer": "Jason Lee",
"datetime": "2020-09-12 15:54:09",
"text": "Breakfast special, best deal in the east village 🍳",
"liked_status": null,
"review_likes": 0
},
{
"id": "5db6599f1669690006b90ed0",
"url": "https://foursquare.com/item/5db6599f1669690006b90ed0",
"reviewer": "Karl Berger",
"datetime": "2019-10-28 02:59:43",
"text": "Friendly service, filling, well-prepared, comfort food.",
"liked_status": "liked",
"review_likes": 0
},
{
"id": "5d36301b7ad1940023057f32",
"url": "https://foursquare.com/item/5d36301b7ad1940023057f32",
"reviewer": "Joseph Terranella",
"datetime": "2019-07-22 21:52:27",
"text": "Vegetarian matzoh ball soup and fresh tomato mozzarella sandwich are favorites- omelets and potatoes are also delicious",
"liked_status": null,
"review_likes": 0
},
{
"id": "5cb9eaea180b9100390b5ca2",
"url": "https://foursquare.com/item/5cb9eaea180b9100390b5ca2",
"reviewer": "Chelsey G",
"datetime": "2019-04-19 15:36:10",
"text": "My fav place for solo eating in NYC. Get the Egg & Cheese--most people think \"yeah yeah, I know what an egg & cheese sandwich tastes like\" but unless if you've had it at B&H, you are missing out!!",
"liked_status": "liked",
"review_likes": 0
},
{
"id": "5c7ec03860d11b002c2db79a",
"url": "https://foursquare.com/item/5c7ec03860d11b002c2db79a",
"reviewer": "Matthew Hamilton",
"datetime": "2019-03-05 18:30:16",
"text": "Great casual spot for a breakfast meeting. Delicious omelets, soups, and latkes!",
"liked_status": "liked",
"review_likes": 0
},
{
"id": "5c1856a8c9a517002cc890c0",
"url": "https://foursquare.com/item/5c1856a8c9a517002cc890c0",
"reviewer": "Josh Upton",
"datetime": "2018-12-18 02:08:40",
"text": "Half lentil, half mushroom barley soup. Challah with butter👌👌👌👌",
"liked_status": "liked",
"review_likes": 0
},
{
"id": "5c172ad70d2be7002cc2113e",
"url": "https://foursquare.com/item/5c172ad70d2be7002cc2113e",
"reviewer": "Dan Hebert",
"datetime": "2018-12-17 04:49:27",
"text": "My favorite diner. Honestly, everything’s good here. Challah, omelettes, breakfast sandwiches.. staff is the friendliest. An EV staple!",
"liked_status": "liked",
"review_likes": 0
},
{
"id": "5bd24488121384002c53580a",
"url": "https://foursquare.com/item/5bd24488121384002c53580a",
"reviewer": "Leemor Yuravlivker",
"datetime": "2018-10-25 22:32:40",
"text": "Huge portions for cheap. I got borscht soup (good), stuffed cabbage with steamed veggies (alright- get the potato side instead). Best part was the fresh challah.",
"liked_status": null,
"review_likes": 0
},
{
"id": "5b8b741fc62b49002ce0e844",
"url": "https://foursquare.com/item/5b8b741fc62b49002ce0e844",
"reviewer": "Ryan Patrick",
"datetime": "2018-09-02 05:24:47",
"text": "Cheap and serves up a ton of food. Try to Stuffed Cabbage.",
"liked_status": "liked",
"review_likes": 0
},
{
"id": "5b101b77a92d98002c4f1b22",
"url": "https://foursquare.com/item/5b101b77a92d98002c4f1b22",
"reviewer": "Zafer ALPER",
"datetime": "2018-05-31 15:57:43",
"text": "Only edible thing was the omelette. Bad coffee, unhealty bread tastes like sugar, something like butter comes with the bread (it is not \"butter\") burned potatos, concantrated orange juice not natural.",
"liked_status": "disliked",
"review_likes": 0
},
{
"id": "5a88795a1cf2e17d02009659",
"url": "https://foursquare.com/item/5a88795a1cf2e17d02009659",
"reviewer": "Kathryn D",
"datetime": "2018-02-17 18:50:02",
"text": "Start with an order of pirogies and end with a blintz. Cash only.",
"liked_status": "liked",
"review_likes": 0
},
{
"id": "59cdba6060d11b412d44e999",
"url": "https://foursquare.com/item/59cdba6060d11b412d44e999",
"reviewer": "Colin Lee",
"datetime": "2017-09-29 03:13:36",
"text": "Solid juice options; freshly made",
"liked_status": "liked",
"review_likes": 0
},
{
"id": "5934366725fb7b2f52908d59",
"url": "https://foursquare.com/item/5934366725fb7b2f52908d59",
"reviewer": "Yisroel Solomon",
"datetime": "2017-06-04 16:33:43",
"text": "Great breakfast spot! Authentic and tasty. I had the omelet with onions and lox and it was incredible. Big portions at a low cost!",
"liked_status": "liked",
"review_likes": 0
},
{
"id": "58860bc0b792070a5131becf",
"url": "https://foursquare.com/item/58860bc0b792070a5131becf",
"reviewer": "Matthew Tey",
"datetime": "2017-01-23 13:57:20",
"text": "Love their challah!",
"liked_status": "liked",
"review_likes": 0
},
{
"id": "5877eb4c8ae36367e2a74f98",
"url": "https://foursquare.com/item/5877eb4c8ae36367e2a74f98",
"reviewer": "sam Beek",
"datetime": "2017-01-12 20:47:08",
"text": "Those soups!",
"liked_status": null,
"review_likes": 0
},
{
"id": "58022aeed67c0e858db72c18",
"url": "https://foursquare.com/item/58022aeed67c0e858db72c18",
"reviewer": "Olga Slobodchikova",
"datetime": "2016-10-15 13:11:10",
"text": "Blueberry pancakes are delicious",
"liked_status": "liked",
"review_likes": 0
},
{
"id": "57ffe83fd67cb4d734cc6b63",
"url": "https://foursquare.com/item/57ffe83fd67cb4d734cc6b63",
"reviewer": "Joshua Eddy",
"datetime": "2016-10-13 20:02:07",
"text": "Cheese blintzes. Yum. Old school awesome.",
"liked_status": null,
"review_likes": 0
},
{
"id": "575642e4498ea228e6ebcf62",
"url": "https://foursquare.com/item/575642e4498ea228e6ebcf62",
"reviewer": "Hadley Holmes",
"datetime": "2016-06-07 03:43:32",
"text": "Get the challah French toast. Truly amazing.",
"liked_status": null,
"review_likes": 0
},
{
"id": "5752f051498e04db0898ffdb",
"url": "https://foursquare.com/item/5752f051498e04db0898ffdb",
"reviewer": "David Caplan",
"datetime": "2016-06-04 15:14:25",
"text": "Greek omelette, blintzes, everything!",
"liked_status": "liked",
"review_likes": 0
},
{
"id": "573f1e31498e8c5b37d41e47",
"url": "https://foursquare.com/item/573f1e31498e8c5b37d41e47",
"reviewer": "Gari Fernandez",
"datetime": "2016-05-20 14:24:49",
"text": "I love this place.this was the regular breakfast spot for a year and a half and each time i had something from there it was absolutely amazing.",
"liked_status": "liked",
"review_likes": 0
},
{
"id": "56e70fc7498e87aceb4329ca",
"url": "https://foursquare.com/item/56e70fc7498e87aceb4329ca",
"reviewer": "Joanna Flamm",
"datetime": "2016-03-14 19:23:51",
"text": "Smoked whitefish or tuna melt on thick challah with a cup of matzoh ball soup is a classic NY lunch.",
"liked_status": "liked",
"review_likes": 0
},
{
"id": "56d3350d498ea1410196bd4a",
"url": "https://foursquare.com/item/56d3350d498ea1410196bd4a",
"reviewer": "Maria ",
"datetime": "2016-02-28 17:57:33",
"text": "Breakfast: challah french toast",
"liked_status": "liked",
"review_likes": 0
},
{
"id": "56c4013a498e0dfce651b720",
"url": "https://foursquare.com/item/56c4013a498e0dfce651b720",
"reviewer": "Harry Raymond",
"datetime": "2016-02-17 05:12:26",
"text": "A classic, cozy diner with the friendliest staff in NY. Omelettes, tuna melt and pierogis are all delicious.",
"liked_status": "liked",
"review_likes": 0
},
{
"id": "56b52440498ee2d9c90f214c",
"url": "https://foursquare.com/item/56b52440498ee2d9c90f214c",
"reviewer": "Julia San Juan",
"datetime": "2016-02-05 22:37:52",
"text": "Mm their lentil soup is perfect for cold days. The accompanying challah is sweet heaven 😋",
"liked_status": "liked",
"review_likes": 0
},
{
"id": "5691719c498e527e24c8aa26",
"url": "https://foursquare.com/item/5691719c498e527e24c8aa26",
"reviewer": "Tom Alfie",
"datetime": "2016-01-09 20:46:20",
"text": "I can't say I would really recommend the Vegetarian Chilli - but it's cheap, very quick and healthy.",
"liked_status": null,
"review_likes": 0
},
{
"id": "5674196f498e37dcd5cd5f5a",
"url": "https://foursquare.com/item/5674196f498e37dcd5cd5f5a",
"reviewer": "Luc Doan",
"datetime": "2015-12-18 14:34:23",
"text": "Matzah soup! And buttered challah bread",
"liked_status": "liked",
"review_likes": 0
},
{
"id": "56685302498ecd1c8a2a6662",
"url": "https://foursquare.com/item/56685302498ecd1c8a2a6662",
"reviewer": "Ina Li",
"datetime": "2015-12-09 16:12:50",
"text": "Local, affordable, delicious food that's been in east village forever. Get you full with 10 dollars with less. Their own bread is delicious.",
"liked_status": "liked",
"review_likes": 0
},
{
"id": "565c51f3498e744f49d4fe77",
"url": "https://foursquare.com/item/565c51f3498e744f49d4fe77",
"reviewer": "Nate Beatty",
"datetime": "2015-11-30 13:41:07",
"text": "It would be a crime to pass up a bowl of the delicious borscht",
"liked_status": "liked",
"review_likes": 1
},
{
"id": "564bd1a4498ece4968d106bf",
"url": "https://foursquare.com/item/564bd1a4498ece4968d106bf",
"reviewer": "Holiday ",
"datetime": "2015-11-18 01:17:24",
"text": "East village institution should be an official landmark. Luckily we didn't lose it in the explosion earlier in the year. Quick, honest food for a fare price. Don't forget about the fresh juices too.",
"liked_status": null,
"review_likes": 0
},
{
"id": "5643b19e498e884edd5e8961",
"url": "https://foursquare.com/item/5643b19e498e884edd5e8961",
"reviewer": "Zach Linder",
"datetime": "2015-11-11 21:22:38",
"text": "Challah french toast, soups, blintzes, pierogies. A NYC institution, remnant of a bygone era, and one of my favorite places on the planet.",
"liked_status": "liked",
"review_likes": 0
},
{
"id": "562d2626498e708d22e19c8e",
"url": "https://foursquare.com/item/562d2626498e708d22e19c8e",
"reviewer": "Paula ",
"datetime": "2015-10-25 18:57:42",
"text": "Tasty bread, awesome soup, friendly personal and massive portions.",
"liked_status": "liked",
"review_likes": 0
},
{
"id": "561ac9e9498e002285f7f2dd",
"url": "https://foursquare.com/item/561ac9e9498e002285f7f2dd",
"reviewer": "Kate Furman",
"datetime": "2015-10-11 20:43:21",
"text": "Grab a counter seat and hang with Mike, he will treat you well. Try the stuffed cabbage and tomato soup.",
"liked_status": null,
"review_likes": 0
},
{
"id": "56196458498e08912682516b",
"url": "https://foursquare.com/item/56196458498e08912682516b",
"reviewer": "Daniel ",
"datetime": "2015-10-10 19:17:44",
"text": "Vegetarian lasagna with soup can be easily shared by two people. And rice pudding for desert completes a perfect lunch",
"liked_status": "liked",
"review_likes": 0
},
{
"id": "5602d5c2498ea624b7a65883",
"url": "https://foursquare.com/item/5602d5c2498ea624b7a65883",
"reviewer": "Andrew Furman",
"datetime": "2015-09-23 16:39:30",
"text": "B&H Special Omelette for breakfast is the way to go. More food than is healthy to eat for only $9.50",
"liked_status": "liked",
"review_likes": 0
},
{
"id": "55f47676498e8a15c9261289",
"url": "https://foursquare.com/item/55f47676498e8a15c9261289",
"reviewer": "Nick Andlinger",
"datetime": "2015-09-12 19:01:10",
"text": "Classic NY joint. Great people, great vibes, even better food.",
"liked_status": "liked",
"review_likes": 1
},
{
"id": "55f4346a498e98a72b90a22b",
"url": "https://foursquare.com/item/55f4346a498e98a72b90a22b",
"reviewer": "ZZubin ",
"datetime": "2015-09-12 14:19:22",
"text": "You won't find breakfast meats at this classic Ukrainian influenced, old school lunch counter. Take advantage of the fresh challah.",
"liked_status": "meh",
"review_likes": 0
},
{
"id": "55df412f498e88e10984c345",
"url": "https://foursquare.com/item/55df412f498e88e10984c345",
"reviewer": "Laurence B",
"datetime": "2015-08-27 16:56:15",
"text": "They're open again. Egg cream is okay but not as good as I make at home. Borscht and kasha are both great. And it's really inexpensive too.",
"liked_status": "liked",
"review_likes": 1
},
{
"id": "55d1748d498ee96e22b15004",
"url": "https://foursquare.com/item/55d1748d498ee96e22b15004",
"reviewer": "Soundz Org",
"datetime": "2015-08-17 05:43:41",
"text": "they have reopened as of 08/15/15",
"liked_status": null,
"review_likes": 0
},
{
"id": "553eef62498e4e4a422fe1c0",
"url": "https://foursquare.com/item/553eef62498e4e4a422fe1c0",
"reviewer": "Elvira Liceaga",
"datetime": "2015-04-28 02:24:34",
"text": "Traditional NY place. Loved Alfredo the Mexican cook!",
"liked_status": "liked",
"review_likes": 0
},
{
"id": "550bd853498e5a87adb3d71b",
"url": "https://foursquare.com/item/550bd853498e5a87adb3d71b",
"reviewer": "Harry Kastenbaum",
"datetime": "2015-03-20 08:20:35",
"text": "Best tuna salad in NYC",
"liked_status": "liked",
"review_likes": 0
},
{
"id": "55096ae1498e9c7b5628295f",
"url": "https://foursquare.com/item/55096ae1498e9c7b5628295f",
"reviewer": "Joe Masilotti",
"datetime": "2015-03-18 12:09:05",
"text": "Don't be pushed away because it's vegetarian. B & H has the best breakfast in EV hands down, and it's only $6! Homemade challah bread and the friendliest staff around. Say hi to Mike! Good juices too.",
"liked_status": "liked",
"review_likes": 0
},
{
"id": "54fb070a498e536a76771b80",
"url": "https://foursquare.com/item/54fb070a498e536a76771b80",
"reviewer": "Olof Carlson",
"datetime": "2015-03-07 14:11:22",
"text": "Came for the French toast. Good taste but missed some fruit or similar. Huge stack of food. Authentic 🗽 style diner. Lots of returning customers.",
"liked_status": "liked",
"review_likes": 0
},
{
"id": "54cace62498ee152caedd3a8",
"url": "https://foursquare.com/item/54cace62498ee152caedd3a8",
"reviewer": "lauren ",
"datetime": "2015-01-30 00:20:50",
"text": "Best french toast in town. Most expensive thing on the me the menu is $12.50. Home made challah makes everything better.",
"liked_status": "liked",
"review_likes": 0
},
{
"id": "54b59917498e612541263d37",
"url": "https://foursquare.com/item/54b59917498e612541263d37",
"reviewer": "Michael De La Rosa",
"datetime": "2015-01-13 22:15:51",
"text": "Pierogies with a Cup of Soup: $9.50",
"liked_status": null,
"review_likes": 0
},
{
"id": "545fc816498e600237a8813a",
"url": "https://foursquare.com/item/545fc816498e600237a8813a",
"reviewer": "Johnny Won",
"datetime": "2014-11-09 20:01:26",
"text": "Quite small but quite good. Grilled cheese was excellent. Cash only.",
"liked_status": "liked",
"review_likes": 0
},
{
"id": "5442a992498e94ab1d7bafdf",
"url": "https://foursquare.com/item/5442a992498e94ab1d7bafdf",
"reviewer": "Kyle Seever",
"datetime": "2014-10-18 17:55:30",
"text": "Classic NY deli. Super friendly. Amazing egg sandwiches!",
"liked_status": "liked",
"review_likes": 0
},
{
"id": "5424d03a498e90ef29a12c2d",
"url": "https://foursquare.com/item/5424d03a498e90ef29a12c2d",
"reviewer": "Becca McArthur",
"datetime": "2014-09-26 02:32:26",
"text": "The fresh smoothies & juices are yummy & only ~$5. Bonus points because they're served in transparent red tumblers. Makes you feel like you're at summer camp!",
"liked_status": "liked",
"review_likes": 2
},
{
"id": "54007c0811d246414d6e2c4f",
"url": "https://foursquare.com/item/54007c0811d246414d6e2c4f",
"reviewer": "TV Food Maps ",
"datetime": "2014-08-29 13:11:36",
"text": "Check out B",
"liked_status": null,
"review_likes": 0
},
{
"id": "53f23667498e69b72d1d0f69",
"url": "https://foursquare.com/item/53f23667498e69b72d1d0f69",
"reviewer": "Emma Cramer",
"datetime": "2014-08-18 17:22:47",
"text": "Cash only.",
"liked_status": null,
"review_likes": 0
},
{
"id": "53ed780e11d201be6fa21ecc",
"url": "https://foursquare.com/item/53ed780e11d201be6fa21ecc",
"reviewer": "ben m",
"datetime": "2014-08-15 03:01:34",
"text": "Perfect place for a cheap solo lunch. Challah grilled cheese and any of the soups.",
"liked_status": null,
"review_likes": 3
}
]
}
Frequently asked questions:
- How do I get all the reviews for a single place?
- Does the API have rate limits?
You need to perform multiple requests incrementing the offset until you get a response without any reviews in it.
Yes, since Foursquare is pretty strict at blocking requests you will be rate limited if you perform more than one request per second.