Places API
The world’s top companies and more than 125,000 developers rely on Foursquare to power geo-tagging, venue search and more in their apps. Join them.
Inspire and Delight
Your Users
See what you can build when you bring the power of people and place together.
Example:
I’m in NYC’s Greenwich Village. What is my precise location?
Can you recommend a trending tea shop in San Francisco?
I’m in Hell’s Kitchen, NYC. Where’s the nearest ShopMart?
What are people saying about Ruby’s Cafe?

Endpoint: venues/search
Parameters: lat/long = 40.7337621,-74.0095604; intent = checkin

//...
{
  "id": "40abf500f964a52035f31ee3",
  "name": "Washington Square Park",
  "contact": {
     "twitter": "nycparks",
     "facebook": "104475634308"
     //...
  },
  "location": {
     "address": "W 4th St",
     "crossStreet": "btwn MacDougal St & University Pl",
     "lat": 40.73076755657555,
     "lng": -73.99745069069391,
     "distance": 0,
     "postalCode": "10012",
     "cc": "US",
     "city": "New York",
     "state": "NY",
     "country": "United States"
     //...
  },
  "categories": [
     {
        "id": "4bf58dd8d48988d163941735",
        "name": "Park",
        "pluralName": "Parks",
        "shortName": "Park",
        "icon": {
          "prefix": "https://ss3.4sqi.net/img/categories_v2/parks_outdoors/park_",
          "suffix": ".png"
        },
        "primary": true
     }
  ],
  "stats": {
        "checkinsCount": 190068,
        "usersCount": 74788,
        "tipCount": 652
  },
  "url": "http://nyc.gov/parks"
  //...
}


Endpoint: venues/explore
Parameters: near = San Francisco; query = Tea Shop

//...
{
  "reasons": {
    "items": [
      {
        "summary": "This spot is popular"
        //...
      }
    ]
  },
  "venue": {
    "id": "574254c7498e1eb5e05a9d51",
    "name": "Squarefour Brewing Company",
    "contact": {
      "twitter": "squarefourbrewing",
      "facebook": "136972233062651"
    },
    "location": {
      "address": "6098 Geary Blvd",
      "crossStreet": "at 25th Ave",
      "lat": 37.7800379,
      "lng": -122.4843178,
      "postalCode": "94121",
      "cc": "US",
      "city": "San Francisco",
      "state": "CA",
      "country": "United States"
       //...
    },
    "categories": [
      {
        "id": "4bf58dd8d48988d1dc931735",
        "name": "Tea Room"
        //...
      }
    ],
    "stats": {
      "checkinsCount": 4000,
      "usersCount": 1500,
      "tipCount": 50
    },
    "url": "http://squarefourbrewing.com",
    "price": {
      "tier": 2,
      "message": "Moderate",
      "currency": "$"
    },
    "rating": 9.1,
    "menu": {
      "url": "http://www.squarefourbrewing.com/menu/"
        //...
      }
    //...
  },
  "tips": [
    {
      "id": "58191e2138facd013099ec02",
      "createdAt": 1478041121,
      "text": "They brew amazing tea here. Highly recommend the Squarefour Oolong Specialty Blend.",
      "type": "user",
      "canonicalUrl": "https://foursquare.com/item/58191e2138facd013099aa05",
      "photo": {
        "id": "599a0241018cbb2372f5f8d9"
         //...
      },
      "user": {
        "id": "111111",
        "firstName": "Jane",
        "lastName": "Doe",
        "gender": "female"
      }
    }
  ],
},
{
  //...
  "venue": {
    "id": "5877d2fb8cb34e044d035abc",
    "name": "ShopMart Tea Shop"
  }
  //...
},
{
  //...
  "venue": {
    "id": "5877d2fb8cb34e044d035bcd",
    "name": "Boba Express"
  }
  //...
},
{
  //...
  "venue": {
    "id": "5877d2fb8cb34e044d035cde",
    "name": "Little Tea Room"
  }
  //...
}


Endpoint: venues/search
Parameters: lat/long = 40.7629212,-73.9935085; query = ShopMart; intent = browse; radius = 500

//...
  {
    "id": "40abf500f964a52035f31ee4",
    "name": "ShopMart",
    "contact": {
      "twitter": "shopmart",
      "facebook": "1044756343124"
      //...
      },
    "location": {
      "address": "593 Ninth Ave",
      "crossStreet": "at W 43rd St",
      "lat": 40.758934,
      "lng": -73.992516,
      "distance": 451,
      "postalCode": "10036",
      "cc": "US",
      "city": "New York",
      "state": "NY",
      "country": "United States"
      //...
    },
    "categories": [
      {
        "id": "4d954b0ea243a5684a65b473",
        "name": "Convenience Store",
        "pluralName": "Convenience Stores",
        "shortName": "Convenience Store",
        "icon": {
          "prefix": "https://ss3.4sqi.net/img/categories_v2/food/coffeeshop_",
          "suffix": ".png"
        },
        "primary": true
      }
    ],
    "stats": {
      "checkinsCount": 12443,
      "usersCount": 4661,
      "tipCount": 652
    },
    "url": "http://shopmart.com",
    "menu": {
      "url": "http://www.starbucks.com/menu"
    },
    "storeId": "9467",
    "venueChains": [
      {
        "id": "556f676fbd6a75a99038d8ec"
      }
    ]
  },
  //...
  {
    "id": "40abf500f964a52035f3zzz1",
    "name": "ShopMart",
    "location": {
      "distance": 125
      //...
    }
    //...
  },
  {
    "id": "40abf500f964a52035f3awdj",
    "name": "ShopMart",
    "location": {
      "distance": 281
      //...
    }
    //...
  }
//...


Endpoint: venues/X/tips
Parameters: venueId = 4ef0e7cf7beb5932d5bdeb4e; sort = recent

//...
"count": 318,
"items": [
  {
    "id": "59bbb0108b98fd4bfdaf203b",
    "createdAt": 1472305544,
    "text": "Delicious fried chicken burgers, avocado shrimp salad, fries with truffle aioli.",
    "type": "user",
    "canonicalUrl": "https://foursquare.com/item/57c19988498e1bebce6f14f8",
    "likes": {
      "count": 0,
      "groups": []
    },
    "logView": true,
    "agreeCount": 1,
    "disagreeCount": 0,
    "todo": {
      "count": 0
    },
    "user": {
      "id": "311272",
      "firstName": "Janice",
      "lastName": "Doe",
      "gender": "female",
      "photo": {
        "prefix": "https://igx.4sqi.net/img/user/",
        "suffix": "/31472-J3VPBIQ1WXYG1DB0.jpg"
      }
    },
    "authorInteractionType": "liked"
  },
  {
    "id": "575e4deb498e0ab9c53a4x09",
    "createdAt": 1465798123,
    "text": "Every single thing on the menu is delicious! From their creative salads, to pasta dishes and their infamous burgers, you can't go wrong! Such a fun atmosphere and friendly waiters. My favorite spot!"
    //...
  },
  {
    "id": "596ab8fde57ca6555f62bf23",
    "createdAt": 1465798123,
    "text": "I've enjoyed watching this location expand over the years. Food & service are incredible. Pasta, burgers are gluten free by request. Coffee counter culture. Casual, fast, top quality, worth the wait!"
    //...
  },
  {
    "id": "58a1426e04f4d77ed0ae961c",
    "createdAt": 1465798123,
    "text": "My top burger choice in NYC! Bronte is a must for first timers, classic cheeseburger is epic and the fries are from another planet."
    //...
  },
  //...
]
//...
Explore
Account Types
All Accounts Include
105M+ points-of-interest
RESTful API
Access to tips, tastes, photos & more
Internationalization
Instant set-up
Email support
Usage Rules
Max # of Apps
Calls per day period limit
Calls per hour limit
Max #of Apps
Usage Rules
Calls per day period limit
Calls per hour limit
Popular
Unverifed
Free
Verified
Free
Public,
Non-Commercial
Applications
Public,
Non-Commercial
Applications
1
1
1,000
100,000
1,000
5,000
Enterpise
Premium
Commercial,
Private Applications
Unlimited
Unlimited
Unlimited
Join our developer
community
Join the conversation on
Stack Overflow
Receive news and alerts about our
Foursquare API on Twitter
Check out the Foursquare Developer blog
for product updates and tech details
Join our team and build cool products