Foursquare Connector

Intro

Foursquare is a local search and discovery 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 (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 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.

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.

Menu

Description

Report

Select a Foursquare report. The following reports are available:

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.
List Suggest Venues	Returns suggested venues for a given list.
Mayorships	Returns mayorships for the authenticated user.
Next Venues	Returns venues that users often check in to after the current venue.
Page Updates	Returns page update details.
Page Venues	Returns the venues for a given page.
Photos	Returns information about photos for the authenticated user.
Requests	Shows pending friend requests for the authenticated user.
Search	Returns information for provided names, email addresses, phone numbers, Twitter handles, or Facebook IDs.
Specials List	Returns a list of available specials.
Specials Search	Returns a list of specials for a given latitude and longitude.
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 Categories	Returns a list of categories applied to venues.
Venue Events	Returns information about events taking place at a given venue.
Venue Explore	Returns a list of recommended venues near the location with the provided latitude and longitude.
Venue Groups	Returns details about a given venue group.
Venue Herenow	Returns a count of the number of people currently at a given venue.
Venue Likes	Returns friends and a total count of users who have liked a given venue.
Venue Links	Returns URLs or identifiers from third parties that have been applied to this venue.
Venue Listed	Returns lists in which the given venue appears.
Venue Menu	Returns menu information for a given venue.
Venue Photo	Returns information about photos for the given venue.
Venues	Returns details about venues, including location, mayorship, tags, tips, specials, and category.
Venue Search	Returns venues for a provided latitude and longitude.
Venue Similar	Returns a list of venues similar to a given venue.
Venue Stats	Returns venue stats over a given time range.
Venue Suggest Completion	Returns a list of venues partially matching the search term for a provided latitude and longitude.
Venue Tips	Returns tips for a given venue.
Venue Timeseries	Returns daily stats for a given venue for the provided number of days.
Venue Trending	Returns a list of venues near the provided latitude and longitude with the most people checked in.

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 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.