Foursquare API

Varies by plan (check documentation)

68 Score

Grade C

Visit Official Site Compare Alternatives

Overview

Foursquare is a location intelligence platform that lets you access venue data, user check-ins, photos, and tips from millions of real-world places. You can build apps that recommend nearby spots, track visits, or display location-based social activity. It uses OAuth 2.0, so users authenticate through Foursquare before your app can act on their behalf.

💡

Beginner Tip

Start with the Places API to search for venues without needing user authentication — you only need an OAuth app token. Use the venue search endpoint with a latitude/longitude pair to quickly get nearby results.

Available Data

IP address details

latitude and longitude

city and country

timezone

ISP information

event dates and names

Example Response

JSON Response

{
  "id": "Dwu85P9SOIk",
  "urls": {
    "full": "https://images.unsplash.com/photo-...",
    "regular": "https://images.unsplash.com/photo-...?w=1080",
    "thumb": "https://images.unsplash.com/photo-...?w=200"
  },
  "width": 4000,
  "height": 3000,
  "user": {
    "name": "John Doe",
    "username": "johndoe"
  }
}

Field Reference

fsq_id Unique Foursquare identifier for the venue

name Display name of the place or venue

location Address details including address, city, country, and formatted_address

categories List of category objects describing the type of venue such as Coffee Shop or Restaurant

distance Distance in meters from the search location to the venue

geocodes Latitude and longitude of the venue under geocodes.main.latitude and geocodes.main.longitude

Implementation Example

const url = "https://developer.foursquare.com/";
// Replace headers or query params with the values required by this API.
const response = await fetch(url, {
  headers: {
  "Authorization": "Bearer YOUR_API_KEY"
  }
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
const data = await response.json();
console.log(data);