get_place_details
DEPRECATED — use `get_place_details_current` instead. Retrieve comprehensive details about a specific place by its Foursquare ID. Returns rich data including name, address, coordinates, categories, hours, contact info, ratings, popularity, and more. Use the fields parameter to request only specific attributes.
find_nearby_places
DEPRECATED — use `get_geotagging_candidates` instead. Find places closest to a specific geographic coordinate. Unlike search, this endpoint focuses on immediate proximity and is designed for identifying what's around a precise location. Ideal for "what's near me" use cases.
get_place_photos
DEPRECATED — use `get_place_photos_current` instead. Retrieve photos for a specific place. Returns photo metadata and assembled URLs. Photos can be filtered by classification and sorted by popularity or recency.
submit_place_feedback
DEPRECATED — use `suggest_place_changes` instead. Propose edits to place attributes or flag problematic places in the Foursquare database. Supports two modes: **propose an edit** to correct or update place details (name, address, phone, categories, etc.), or **flag a problem** to report issues like closures, duplicates, or incorrect locations.
search_places
DEPRECATED — use `search_places_current` instead. Search for places (points of interest) in the Foursquare database. Supports searching by keyword, location, category, chain, and geographic area. Results can be filtered by price range, operating hours, and sorted by relevance, rating, distance, or popularity.
match_place
DEPRECATED — use `match_place_current` instead. Match a place name and location to a Foursquare POI record. Useful for enriching in-house datasets with Foursquare data by matching against known place names and addresses or coordinates.
get_feedback_status
DEPRECATED — use `get_suggestion_status` instead. Check the status of a previously submitted place feedback (edit proposal or flag). Use the feedback ID returned from the Submit Place Feedback tool.
autocomplete_places
DEPRECATED — use `autocomplete_places_current` instead. Provides type-ahead search suggestions for places, addresses, and geographic areas. Returns a mix of result types as the user types, ideal for building search-as-you-type experiences.
get_place_tips
DEPRECATED — use `get_place_tips_current` instead. Retrieve tips and reviews for a specific place. Tips are user-submitted text reviews that provide insight about the venue experience.
match_place_current
Match a place name and address to a current Foursquare place. The provider currently supports English-speaking countries.
get_geotagging_candidates
Find candidates for tagging a device location. Results may include lower-quality places omitted from normal search.
get_place_details_current
Retrieve the selected fields of a current Foursquare place, preserving all returned metadata.
suggest_new_place
Suggest a place missing from the current database. Foursquare first attempts to match an existing place before creating a new suggestion.
confirm_geotagging_selection
Report which candidate the user selected from a previous geotagging request.
get_suggestion_status
Monitor current place edit suggestions by their IDs, or list suggestions made by the calling service key.
get_current_user
Retrieve the signed-in Foursquare user profile through the V2 user API. Requires a V2 OAuth connection; Places service/API keys do not represent a user.
search_places_current
Search current Foursquare Places by query, geographic area, category, chain, hours, and price. Without a location the provider uses IP biasing.
autocomplete_places_current
Get current place, search, and geographic suggestions as text is entered.
get_place_tips_current
Retrieve current place tips with full provider metadata. Select additional fields for language, links, votes, or photos.
get_place_photos_current
Retrieve current place photos with complete metadata, original image URLs, and downloadable images.
suggest_place_changes
Suggest edits, removal, merging duplicates, or incorrect fields for a current Foursquare place. Changes are suggestions and may require review.