Place Match
GET {{baseUrl}}/v3/places/match?name=Als Beef&address=548 N Wells St&city=Chicago&state=IL&cc=US&ll=41.8942505,-87.6380201
Return the Foursquare record of a POI (via FSQ_ID) given a Name and Location. Provide a Location by using all the Address parameters, or by LL.
Request Params
| Key | Datatype | Required | Description |
|---|---|---|---|
name | string | (Required) Name of the place to match. | |
address | string | Street address of the place to match (e.g. 1060 W Addison St). | |
city | string | City, or Locality, where the place is located (e.g. Chicago). | |
state | string | State, or Region, where the place is located (e.g. Illinois). | |
postalCode | null | The postal code for the address where the place is located (e.g. 10012). | |
cc | string | The 2-digit country code where the place is located (e.g. US). | |
ll | string | The latitude/longitude of the venue location. This must be specified as latitude,longitude (e.g., ll=41.8781,-87.6298). | |
fields | null | Indicate which fields to return in the response, separated by commas. If no fields are specified, all <a href="https://docs.foursquare.com/reference/response-fields#core-data-fields" target="_blank">Core Fields</a> are returned by default. |
For a complete list of returnable fields, refer to the <a href="https://docs.foursquare.com/reference/response-fields" target="_blank">Response Fields</a> page. |
HEADERS
| Key | Datatype | Required | Description |
|---|---|---|---|
Accept | string |
RESPONSES
status: OK
{"place":{"fsq_id":"incidi","categories":[{"id":13058,"name":"Hot Dog Joint","icon":{"id":"1234","created_at":"2022-04-23T18:25:43.511Z","prefix":"https://ss3.4sqi.net/img/categories_v2/food/hotdog_","suffix":".png","width":1500,"height":1500,"classifications":["food"],"tip":{"id":"123ABC","created_at":"2022-04-23T18:25:43.511Z","text":"A POI tip","url":"somelink.com","photo":"photolink.com","lang":"EN","agree_count":1000,"disagree_count":1000}}}],"chains":[{"id":"chain id","name":"chain name"}],"date_closed":"1983-08-26","description":"commodo","distance":-73390979,"email":"exercitation nulla Lorem","fax":"amet","features":{"payment":{"credit_cards":{"accepts_credit_cards":{},"discover":{},"visa":{},"diners_club":{},"master_card":{}},"digital_wallet":{"accepts_nfc":{}}},"food_and_drink":{"alcohol":{"beer":{},"byo":{},"cocktails":{},"full_bar":{},"wine":{}},"meals":{"breakfast":{},"brunch":{},"lunch":{},"happy_hour":{},"dessert":{},"dinner":{}}},"services":{"delivery":{},"takeout":{},"drive_through":{},"dine_in":{"reservations":{},"online_reservations":{},"groups_only_reservations":{}}},"amenities":{"restroom":{},"smoking":{},"jukebox":{},"music":{},"live_music":{},"private_room":{},"outdoor_seating":{},"tvs":{},"atm":{},"coat_check":{},"wheelchair_accessible":{},"parking":{"parking":{},"street_parking":{},"valet_parking":{},"public_lot":{},"private_lot":{}}}},"geocodes":{"drop_off":{"latitude":-12755420.977023974,"longitude":-80757900.65045707},"front_door":{"latitude":-18456966.685907036,"longitude":-38647138.44662444},"main":{"latitude":-70453935.44525354,"longitude":-58746563.75083727},"road":{"latitude":-437388.13509333134,"longitude":31862029.862640902},"roof":{"latitude":-18398765.733972102,"longitude":-86874170.27537885}},"hours":{"display":"exercitation ut","is_local_holiday":true,"open_now":false,"regular":[{"close":"10:00pm","day":"1","open":"6:00am"}],"seasonal":[{"closed":"true","end_date":"2023-01-15","hours":[{"close":"10:00pm","day":"1","open":"6:00am"}],"start_date":"2023-01-14"}]},"hours_popular":[{"close":"ispom","day":"7","open":"pluram"}],"link":"amet elit non","location":{"address":"dolor ut sed consequat","address_extended":"eu nostrud labore ex","admin_region":"labore et ","census_block":"esse tempor","country":"incididunt","cross_street":"quis officia ipsum","dma":"cupidatat Ut","formatted_address":"ullamco mollit veniam ut","locality":"aliqua fugiat pariat","neighborhood":["neighborhood-name"],"po_box":"dolor","post_town":"cupidatat","postcode":"cupidatat enim tempor laboris pariatur","region":"velit"},"menu":"veniam sed","name":"Duis fugiat consectetur aliqua","photos":[{"id":"123455f5b863c0008b1edca","created_at":"2020-01-14T02:50:07.000Z","prefix":"https://fastly.4sqi.net/img/general/","suffix":"/12345438_8tJRLpG3PbPVN-Ekde66x8XN7IVVYP__YaS1KmLfntc.png","width":2000,"height":1500,"classifications":["food"],"tip":{"id":"ullamco qui dolore","created_at":"1963-08-21T13:57:06.927Z","text":"eiusmod","url":"eu commodo ut","photo":"lorem ipsom","lang":"nulla","agree_count":40683730,"disagree_count":65410876}}],"popularity":9787900.651389062,"price":79729915,"rating":62872237.01657069,"related_places":{"parent":"lorem"},"social_media":{"facebook_id":"consectetur ullamco","instagram":"laborum consequat","twitter":"laborum sin"},"stats":{"total_photos":-29757945,"total_ratings":-21632394,"total_tips":-62357271},"store_id":"plurubus","tastes":["lorum"],"tel":"123-456-7890","timezone":"dolore","tips":[{"id":"sed","created_at":"1945-01-04T21:17:14.955Z","text":"mollit sit","url":"incididunt ut occaecat in dolor","photo":"lorem ipsom","lang":"consequat consectetur elit amet","agree_count":62055063,"disagree_count":-56476707}],"verified":false,"website":"esse in"},"match_score":-55249941.96601081}