PxPixel
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

Personal

Non-Commercial

FREE

  • 105M+ points-of-interest
  • 2 Photos & 2 Tips per Venue
  • 2 Queries per Second (QPS)
  • 1 App per Account
  • Insight into API Usage
  • API Call Quota
    99,500 Regular Calls + 500 Premium Calls
Continue

Start-Up

Commercial

$599per month

  • A Commercial License
  • 2X More QPS, Venue Photos & Tips
  • Unlimited Apps per Account
  • Featured on Foursquare Website
  • 72-Hour Email Support
  • Unlimited API Calls
    $0.001 per Regular Call
    $0.06 per Premium call
ContinueCompare Full Specs

Enterprise

Commercial

Contact Us

  • Even more photos, tips, and QPS
  • Dedicated technical support
  • Higher call volume with tiered price discounts
Let's Talk

Looking to just get started with the Foursquare Places API? Get 950 regular and 50 premium API calls per day as well as 1 photo and tip per venue by continuing as a Sandbox Account here.

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
Introducing Places API for Start-Ups
Does your app have a commercial use case? Do you want access to Enterprise-grade place data without the premium price tag?