Attribution & Linking

Just as you’d never quote someone without attribution, credit Foursquare when using our data. We think our policies below are conveyed clearly but if you have any questions, please reach out to us at api@foursquare.com. Under certain circumstances, other terms may apply.

Attribution When Using Foursquare Venues

One of the most popular ways to interact with our API is using our venues database, and certain attribution policies apply when you do. If you aren’t using any venues data (quick check: are you ever hitting a venues/* endpoint?), you can skip straight to Visual Attribution.

Linking to Us: Basic Data

Give your users the opportunity to learn more about the venues they see in your app. To do this, provide links back to corresponding Foursquare venue pages whenever you display any basic data (name, location, and category) retrieved from our venues database. Common approaches to this include:

  • linking the venue name directly
  • creating your own place detail page and linking that back to us
  • having some other dedicated “More Details” link

Use the sample link below as a reference for how to format your URLs:

https://foursquare.com/v/john-f-kennedy-international-airport-jfk/43a52546f964a520532c1fe3?ref=YOUR_APPS_CLIENT_ID

This is a standard web link that degrades nicely to a mobile view, but we also encourage mobile clients to consider using a direct link to the venue detail page in the Foursquare native app. You can find the base URL in the canonicalUrl field in a venue details response, or you could also stitch a URL together with http://foursquare.com/v/ + venueId.

Make sure to supply the ref parameter whose value is your app's CLIENT_ID so that we can confirm your app is attributing properly. Don't set rel="nofollow" on your links back to Foursquare.

If it absolutely doesn’t make sense to provide in links to Foursquare in your app's UI, you may provide Visual Attribution (see below) in lieu of linking. We expect most apps to be able to support linking.

EXAMPLE

Beyond Basic Data

If you display any non-basic venue data such as tips or photos, you must both link back to the corresponding venue page and give Visual Attribution.

Search Results

If you are displaying a list of venues as part of search results, you do not need to link to us on that screen. Instead, provide Visual Attribution.

Visual Attribution

This section applies if you are not using any venue data or need to give Visual Attribution as specified above.

You can think of Visual Attribution like a citation in a paper, and the guideline here is simple: whenever Foursquare data is showing on the screen, attribution to Foursquare must be visible simultaneously or before the Foursquare data is shown. We don’t put any specific stipulation on how to attribute us (you can use some of our assets, some text containing the word “Foursquare,” a combination of both, etc.), we only stipulate where and when.

EXAMPLES
This page last updated: Feb 26, 2014