Foursquare Connector
Intro
Foursquare is a local search and discovery https://developer.foursquare.com/).
service mobile app which provides a personalized local search experience for its users. Use Domo's Foursquare connector to retrieve data about checkins, friends, mayorships, venues, and the like. To learn more about the Foursquare API, visit their page (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 Data 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 Data 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 Managing User Accounts for Connectors.
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.
Menu |
Description |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Report |
Select a Foursquare report. The following reports are available:
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
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. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
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 Data 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
Do I need a certain kind of account with the data service to set up the connector?
No. A standard FourSquare account is all this required to power up the connector.
How often can the data be updated?
DataSets should be set to update once a day.
Are there any API limits I should be aware of?
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.