# Foursquare integration

> Foursquare Places API: search, details, photos, tips, autocomplete, geotagging and place-edit suggestions for global points of interest.

- Authentication: apiKey

## Tools (21)

- **Ask**: Ask is a natural language place search that returns a list of places matching a natural-language question. Provide `query` with what the user wants (e.g., "best cocktail lounge in Williamsburg"). Ask needs a search area from one of three places: a place mentioned in `query`, `ll` (lat,lng), or `loca
- **Autocomplete**: Returns a list of top places, geos, and/or searches partially matching the provided keyword and location inputs.
- **Confirm Geotagging Candidate Selection**: Report the selection of a place as the result of a Geotagging Candidates request.
- **Edit a Place**: Suggest edits to an existing Place's information such as address, phone number, and hours of operation via its `fsq_place_id`. Providing values for the parameters below constitute the proposed edit.
- **Execute an Offline Job**: Execute a previously initialized offline job. Note you may not execute jobs that are already running or have completed, but you may use this endpoint to re-execute failed jobs. For more details on how to use the Offline Jobs Endpoints, please refer to the [onboarding guide](https://docs.foursquare.c
- **Find Geotagging Candidates**: Utilize Foursquare's Snap to Place technology to detect where your user's device is and what is around them. This endpoint will intentionally return lower quality results not found in Place Search. It is not intended to replace Place Search as the primary way to search for top, recommended POIs.
- **Flag a Place**: Flag a field(s) on a Place as incorrect. Does not require you to provide the correct value.
- **Get Offline Jobs Status**: Check the status of previously submitted Places API offline jobs. Jobs and their statuses are retained for 90 days after initialization. For more details on how to use the Offline Jobs Endpoints, please refer to the [onboarding guide](https://docs.foursquare.com/fsq-developers-places/reference/offli
- **Get Place Details**: Retrieve comprehensive information and metadata for a FSQ Place using the fsq_place_id.
- **Get Place Photos**: Retrieve photos for a FSQ Place using the fsq_place_id. To retrieve photos from a Photos response, learn [how to assemble photo URLs](https://docs.foursquare.com/fsq-developers-places/reference/place-photo-guides#assembling-a-photo-url).
- **Get Places With Pending Suggested Edits**: Get a list of the top places that need review for a given location.
- **Get Place Tips**: Retrieve tips for a FSQ Place using the fsq_place_id.
- **Get Suggestion Status**: Monitor the status of the places edits provided by your users or service keys.
- **Initialize an Offline Job**: Initialize an offline job and generate temporary AWS credentials for uploading and reading data. For more details on how to use the Offline Jobs Endpoints, please refer to the [onboarding guide](https://docs.foursquare.com/fsq-developers-places/reference/offline-job-onboarding-guide).
- **Merge Places**: Suggest the merge of two or more places.
- **Place Match**: Return the Foursquare record of a POI (via fsq_place_id) given a name and location.
- **Place Resolve**: Check whether a partner-provided place identifier has been matched to FSQ Places.
- **Place Search**: Search for places in the FSQ Places database using a location and querying by name, category name, telephone number, taste label, or chain name. For example, search for "coffee" to get back a list of recommended coffee shops. You may pass a location with your request by using one of the following op
- **Refresh Offline Job Credentials**: Refreshes temporary AWS credentials for an existing offline job. This is useful if your original credentials have expired. For more details on how to use the Offline Jobs Endpoints, please refer to the [onboarding guide](https://docs.foursquare.com/fsq-developers-places/reference/offline-job-onboard
- **Remove a Place**: Flag an entire place for removal for reasons such as closed, doesn't exist, inappropriate, or private.
- **Suggest a New Place**: Add a new place that does not currently exist. We will first attempt to find a match in our database. If we do not find a match, we will create a new suggested place.

Connect Foursquare in General Input: https://www.generalinput.com/apps/foursquare