Skip to main content
New to Corsair? See API access, authentication, and error handling.

Places

autocomplete

places.autocomplete Suggest places, searches or geos for a partial query Risk: read
Input query must be at least 3 characters. This endpoint takes ll for a location; unlike Place Search it has no near parameter, so a locality name cannot bias it. types and bias accept place, search or geo. Each result carries a type and a text. A place result nests the whole place under place, so its id is result.place.fsq_place_id; a geo or search result has no place. Output

get

places.get Get one place by its fsq_place_id, with all its details Risk: read
Input Answers the place object directly, not wrapped. fields narrows it; omitting it returns every Pro field. Output

match

places.match Resolve a name and address to a Foursquare place, with a match score Risk: read
Input Answers { place, match_score, context }. match_score runs from 0 to 1. name, address, city and cc are all required, and cc must be a 2-letter code; Foursquare supports English-speaking countries only. Its reference lists 422 Unsupported country for a code outside that set, and the call can also answer 404 Match not found or a 400 asking for ll. Output

photos

places.photos List the photos attached to a place Risk: read
Input Returns { photos: [...] }: Foursquare answers a bare array and the plugin wraps it. sort accepts POPULAR or NEWEST. Build an image URL by concatenating prefix, a size (32, 44, 64, 88, 120 or 512) and suffix, as in {prefix}512{suffix}. Output

places.search Search the Foursquare places database by text, category or location Risk: read
Input Take a location as ll with an optional radius, as near, or as ne and sw. With none of them the search falls back to IP biasing. Array filters such as fsq_category_ids and fields are comma-joined before sending. limit caps at 50 and defaults to 10. Each response carries nextCursor when more results exist; pass it back as cursor to fetch the next page of the same search. Output

tips

places.tips List the user tips left on a place Risk: read
Input Returns { tips: [...] }: Foursquare answers a bare array and the plugin wraps it. A tip carries fsq_tip_id, created_at and text by default; ask for agree_count, disagree_count, lang or url through fields. sort accepts POPULAR or NEWEST. Output