> ## Documentation Index > Fetch the complete documentation index at: https://domoinc-openapi-sync-dataflows.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Foursquare Connector ## Intro Foursquare is a local search and discovery service mobile app which provides a personalized local search experience for its users. To learn more about the Foursquare API, visit their page ([https://developer.foursquare.com/](https://developer.foursquare.com/ "https://developer.foursquare.com/") ). The Foursquare connector is a "Cloud App" connector, meaning it retrieves data stored in the cloud. In the Data Center, you can access the connector page for this and other Cloud App connectors by clicking **Cloud App** in the toolbar at the top of the window. You connect to your Foursquare account in the Data Center. This topic discusses the fields and menus that are specific to the Foursquare connector user interface. General information for adding DataSets, setting update schedules, and editing DataSet information is discussed in [Adding a DataSet Using a Connector](/s/article/360042926274 "Adding a DataSet Using a Connector").

Primary Use Cases	Use this connector to find out what your friends are doing, learn about new places, and check on mayorships and venues.
Primary Metrics	Engagements
Primary Company Roles	Social media reps
Average Implementation Time	\~1 hour
Ease of Use (on a 1-to-10 scale with 1 being easiest)	2

## Best Practices This connector works best when the update mode is set to "Replace." ## Prerequisites To connect to your Foursquare account and create a DataSet, you must have the following: * The email address or phone number you entered when you signed up for Foursquare * Your Foursquare password Alternatively, you can log into your Foursquare account using your Facebook credentials. ## Connecting to Your Foursquare Account This section enumerates the options in the **Credentials** and **Details** panes in the Foursquare Connector page. The components of the other panes in this page, **Scheduling** and **Name & Describe Your DataSet**, are universal across most connector types and are discussed in greater length in [Adding a DataSet Using a Connector](https://domo-support.domo.com/s/article/360042926274?language=en_US "Adding a DataSet Using a Connector"). ### Credentials Pane The Domo Foursquare connector uses OAuth to connect, so there is no need to enter credentials within Domo. Click **Connect** (or select **Add Account** if you have existing Foursquare accounts in Domo) to open the Foursquare OAuth screen where you can enter the email address or phone number you entered when you signed up for Foursquare, along with your Foursquare password. You can also connect using Facebook credentials. Once you have entered valid credentials, you can use the same account any time you go to create a new Foursquare DataSet. You can manage connector accounts in the **Accounts** tab in the Data Center. For more information about this tab, see [Manage Connector/Adapter Accounts](https://domo-support.domo.com/s/article/360042926054?language=en_US "Manage Connector/Adapter Accounts"). **Note:** If you are already logged into Foursquare when you connect in Domo, you are authenticated automatically when you click Add account. If you want to connect to an account that is different from the one you are logged into, you must first log out of Foursquare. ### Details Pane This pane contains a primary **Reports** menu, along with various other menus which may or may not appear depending on the report type you select.

Description

Report

Select a Foursquare report. The following reports are available:

Report Name	Description
Checkins	Returns a history of checkins for the authenticated user.
Checkin Likes	Returns friends and a total count of users who have liked each checkin.
Friends	Returns a list of the authenticated user's friends.
List Followers	Returns information about users following a given list.
Lists	Returns details about lists.
List Saves	Returns friends and a total count of users who have saved a given list.
Mayorships	Returns mayorships for the authenticated user.
Photos	Returns information about photos for the authenticated user.
Tips	Returns details about tips, including which users have marked a given tip as to-do.
Tips Likes	Returns friends and a total count of users who have liked a given tip.
Tips Listed	Returns lists in which a given tip appears.
Tips Saves	Returns friends and a total count of users who have saved a given tip.
Venue Likes	Returns friends and a total count of users who have liked a given venue.
Venues	Returns details about venues, including location, mayorship, tags, tips, specials, and category.
Venue Stats	Returns venue stats over a given time range.

Past Days

Enter the number of past days of data that should appear in the report. You can use the format x , xday , or xdays , where x is a positive integer. Example: 30days

Search By

Select the type of query you want to search for.

Search Query

Enter the query term(s) to search for. If you selected Name in Search By , you can search for a single search string, which may consist of a first name, a last name, or both. For example, you could enter any of the following for the name "Phil Jones": phil , jones , or phil jones

If you selected any other option in Search By , you may enter multiple search strings using a comma-separated list.

Latitude and Longitude

Enter the latitude and longitude of the location you want to retrieve data for, separated by commas. Both latitude and longitude must be in signed degrees format: DDD.dddd . Example: 40.63, -111.91 . Compass directions and degree symbols (º) are not allowed.

Query

Enter a title to search for. The query must be at least three letters long.

### Other Panes For information about the remaining sections of the connector interface, including how to configure scheduling, retry, and update options, see [Adding a DataSet Using a Connector](https://domo-support.domo.com/s/article/360042926274?language=en_US "Adding a DataSet Using a Connector"). ## Rate Limits * 5,000 userless requests per hour for venues * 500 userless requests to most other endpoints per hour * 500 authenticated requests per hour per OAuth token ## FAQs No. A standard FourSquare account is all this required to power up the connector. DataSets should be set to update once a day. Each authenticated user may make up to 500 requests per hour. Note that a single run of a DataSet may require making multiple requests. Domo as a whole may make up to 100,000 requests per day. ## Troubleshooting If the connector returns an error, make sure to read the error description as well as check the authentication and report configuration.