Foursquare SDKs & Libraries: Official & Community (2026)

SDKs overview

Foursquare offers a range of Software Development Kits (SDKs) and libraries designed to facilitate the integration of its location intelligence services into various applications. These tools abstract the complexities of direct API interaction, providing language-specific interfaces for accessing Foursquare's core products, including the Places API, Pilgrim SDK, and Visits API. The SDKs enable developers to build features such as venue search, user check-ins, location-based recommendations, and geospatial analytics.

The primary benefit of using an SDK over direct API calls is the reduction in development time and effort. SDKs often handle authentication, request formatting, response parsing, and error handling, allowing developers to focus on application logic rather than the underlying communication protocols. Foursquare provides official SDKs for widely used programming languages and supports a community of developers who contribute additional libraries.

Official SDKs by language

Foursquare maintains official SDKs for several popular programming languages, ensuring direct support and compatibility with their latest API versions. These SDKs are typically the recommended approach for integrating Foursquare services into new projects due to their reliability and direct support from Foursquare's developer team. Each SDK is tailored to the conventions and best practices of its respective language environment, providing a native development experience.

The following table outlines the official SDKs, their corresponding package names, and typical installation methods:

For detailed API client setup and usage, developers should consult the Foursquare API reference documentation.

Installation

Installation of Foursquare SDKs typically follows the standard package management practices for each programming language. Before installing, developers need to obtain API credentials, which usually include a Client ID and Client Secret, from their Foursquare developer account. These credentials are essential for authenticating requests made through the SDKs.

JavaScript (Node.js/Browser)

For JavaScript environments, the foursquare-places package is installed via npm or yarn:

npm install foursquare-places
# or
yarn add foursquare-places

After installation, the SDK can be imported and initialized with API credentials.

Python

The Python SDK is installed using pip, the standard Python package installer:

pip install foursquare

Once installed, the foursquare library can be imported, and a client object can be instantiated using your Foursquare API keys.

Java

Java projects typically use Maven or Gradle for dependency management. For Maven, add the following dependency to your pom.xml file:

<dependency>
    <groupId>com.foursquare</groupId>
    <artifactId>foursquare-api-java</artifactId>
    <version>[latest_version]</version>
</dependency>

Replace [latest_version] with the most recent version number, which can be found in the Foursquare Java SDK documentation. After adding the dependency, the project build tools will download the required libraries.

Ruby

The Ruby SDK, foursquare2, is installed as a Ruby gem:

gem install foursquare2

Once the gem is installed, it can be required in your Ruby application, and an API client can be created with your Foursquare credentials.

Quickstart example

This example demonstrates how to use the Python SDK to search for venues near a specific location. Before running this code, ensure you have installed the Python SDK and replaced the placeholder credentials with your actual Foursquare Client ID and Client Secret.

import foursquare

# Replace with your Foursquare API credentials
CLIENT_ID = 'YOUR_CLIENT_ID'
CLIENT_SECRET = 'YOUR_CLIENT_SECRET'

# Initialize the Foursquare client
client = foursquare.Foursquare(client_id=CLIENT_ID, client_secret=CLIENT_SECRET)

# Define search parameters
latitude = 34.052235
longitude = -118.243683
query = 'coffee shop'
limit = 5

# Perform a venue search
try:
    venues = client.venues.search(params={
        'll': f"{latitude},{longitude}",
        'query': query,
        'limit': limit
    })
    
    print(f"Found {len(venues['venues'])} {query} near {latitude},{longitude}:")
    for venue in venues['venues']:
        print(f"- {venue['name']} (Category: {venue['categories'][0]['name'] if venue['categories'] else 'N/A'})")
        print(f"  Address: {', '.join(venue['location']['formattedAddress']) if 'formattedAddress' in venue['location'] else 'N/A'}")

except foursquare.FoursquareException as e:
    print(f"An error occurred: {e}")

This Python snippet demonstrates a basic venue search, retrieving the name, category, and address of coffee shops near the specified coordinates. The foursquare.Foursquare object handles the API request, and the response is parsed into a Python dictionary, making it accessible for further processing within the application. For more advanced queries and API endpoints, refer to the Foursquare Venues Search API documentation.

Community libraries

Beyond the officially supported SDKs, the Foursquare developer community contributes a variety of libraries and wrappers in different programming languages. These community-driven projects can offer support for languages not officially covered, alternative architectural approaches, or specialized functionalities. While not directly supported by Foursquare, they can be valuable resources for developers.

When considering a community library, it is important to evaluate its maintenance status, documentation, and the activity level of its contributors. Developers should check the project's repository (e.g., on GitHub) for recent commits, open issues, and pull requests to gauge its reliability. Examples of languages often supported by community efforts include PHP, Go, and C#.

For instance, a developer looking for a PHP client might find a community-maintained library that wraps the Foursquare API. These libraries often follow the patterns of their respective language ecosystems, such as using Composer for PHP or modules for Go. While specific community libraries are subject to change and may not always be up-to-date with the latest Foursquare API features, they can provide quick integration options. Developers can explore popular code hosting platforms like GitHub for Foursquare-related repositories, often using search terms like "foursquare client [language]".

It is generally advisable to use official SDKs when available, as they receive direct updates and support from Foursquare. However, community libraries can fill specific gaps or provide tailored solutions for niche requirements, complementing the official offerings. For a comprehensive list of all SDKs and libraries, official and community-contributed, developers should consult the Foursquare Developer documentation on SDKs.