Description

Returns a list of mini-venues partially matching the search term, near the location.


Request

GET https://api.foursquare.com/v2/venues/suggestcompletion


Authentication

User or userless authentication.


Parameters

Name Example Description
ll 44.3,37.2 required Latitude and longitude of the user’s location. (Required for query searches)
near Chicago, IL required unless ll is provided. A string naming a place in the world. If the near string is not geocodable, returns a failed_geocode error. Otherwise, searches within the bounds of the geocode. Adds a geocode object to the response. (Required for query searches)
llAcc 10000.0 Accuracy of latitude and longitude, in meters. (Does not currently affect search results.)
alt 0 Altitude of the user’s location, in meters. (Does not currently affect search results.)
altAcc 10000.0 Accuracy of the user’s altitude, in meters. (Does not currently affect search results.)
query foursqu required A search term to be applied against titles. Must be at least 3 characters long.
limit 30 Number of results to return, up to 50.
radius 800 Limit results to venues within this many meters of the specified location. Defaults to a city-wide area. The maximum supported radius is currently 80,000 meters.
sw 44.3,37.2 With ne, limits results to the bounding box defined by the latitude and longitude given by sw as its south-west corner, and ne as its north-east corner. Not valid with ll or radius. Bounding boxes with an area up to approximately 10,000 square kilometers are supported.
ne 44.1,37.4 See sw

Try it Now!


Response Fields

Field Description
id A unique string identifier for this venue.
name The best known name for this venue.
location An object containing none, some, or all of address (street address), crossStreet, city, state, postalCode, country, lat, lng, and distance. All fields are strings, except for lat, lng, and distance. Distance is measured in meters. Some venues have their locations intentionally hidden for privacy reasons (such as private residences). If this is the case, the parameter isFuzzed will be set to true, and the lat/lng parameters will have reduced precision.
categories An array, possibly empty, of categories that have been applied to this venue. One of the categories will have a primary field indicating that it is the primary category for the venue. For the complete category tree, see categories.

Response

{
  "meta": {
    "code": 200,
    "requestId": "5a3adfe81ed21913b428c83a"
  },
  "response": {
    "minivenues": [
      {
        "id": "4f045eeb00399761c77301e3",
        "name": "Prince Street Pizza",
        "location": {
          "address": "27 Prince St",
          "crossStreet": "btwn Mott & Elizabeth St",
          "city": "New York",
          "state": "NY",
          "postalCode": "10012",
          "country": "US",
          "lat": 40.722905825704764,
          "lng": -73.99466690110555,
          "distance": 343
        },
        "categories": [
          {
            "id": "4bf58dd8d48988d1ca941735",
            "name": "Pizza Place",
            "pluralName": "Pizza Places",
            "shortName": "Pizza",
            "icon": {
              "prefix": "https://ss3.4sqi.net/img/categories_v2/food/pizza_",
              "suffix": ".png"
            }
          },
          {
            "id": "4d4b7105d754a06374d81259",
            "name": "Food",
            "pluralName": "Food",
            "shortName": "Food",
            "icon": {
              "prefix": "https://ss3.4sqi.net/img/categories_v2/food/default_",
              "suffix": ".png"
            }
          }
        ],
        "hasPerk": false
      },
      {
        "id": "45ebc982f964a52091431fe3",
        "name": "Joe's Pizza",
        "location": {
          "address": "7 Carmine St",
          "crossStreet": "at 6th Ave",
          "city": "New York",
          "state": "NY",
          "postalCode": "10014",
          "country": "US",
          "lat": 40.730491197306435,
          "lng": -74.00188088169593,
          "distance": 728
        },
        "categories": [
          {
            "id": "4bf58dd8d48988d1ca941735",
            "name": "Pizza Place",
            "pluralName": "Pizza Places",
            "shortName": "Pizza",
            "icon": {
              "prefix": "https://ss3.4sqi.net/img/categories_v2/food/pizza_",
              "suffix": ".png"
            }
          },
          {
            "id": "4d4b7105d754a06374d81259",
            "name": "Food",
            "pluralName": "Food",
            "shortName": "Food",
            "icon": {
              "prefix": "https://ss3.4sqi.net/img/categories_v2/food/default_",
              "suffix": ".png"
            }
          }
        ],
        "hasPerk": false
      },
      {
        "id": "3fd66200f964a52062e61ee3",
        "name": "Lombardi's Coal Oven Pizza",
        "location": {
          "address": "32 Spring St",
          "crossStreet": "at Mott St",
          "city": "New York",
          "state": "NY",
          "postalCode": "10012",
          "country": "US",
          "lat": 40.72156708733683,
          "lng": -73.99559138323225,
          "distance": 480
        },
        "categories": [
          {
            "id": "4bf58dd8d48988d1ca941735",
            "name": "Pizza Place",
            "pluralName": "Pizza Places",
            "shortName": "Pizza",
            "icon": {
              "prefix": "https://ss3.4sqi.net/img/categories_v2/food/pizza_",
              "suffix": ".png"
            }
          },
          {
            "id": "4d4b7105d754a06374d81259",
            "name": "Food",
            "pluralName": "Food",
            "shortName": "Food",
            "icon": {
              "prefix": "https://ss3.4sqi.net/img/categories_v2/food/default_",
              "suffix": ".png"
            }
          }
        ],
        "hasPerk": false
      },
      {
        "id": "51351c3fe4b0c58b63965114",
        "name": "Joe's Pizza",
        "location": {
          "address": "150 E 14th St",
          "crossStreet": "3rd Ave.",
          "city": "New York",
          "state": "NY",
          "postalCode": "10003",
          "country": "US",
          "lat": 40.733386570577345,
          "lng": -73.98731060842591,
          "distance": 1097
        },
        "categories": [
          {
            "id": "4bf58dd8d48988d1ca941735",
            "name": "Pizza Place",
            "pluralName": "Pizza Places",
            "shortName": "Pizza",
            "icon": {
              "prefix": "https://ss3.4sqi.net/img/categories_v2/food/pizza_",
              "suffix": ".png"
            }
          },
          {
            "id": "4d4b7105d754a06374d81259",
            "name": "Food",
            "pluralName": "Food",
            "shortName": "Food",
            "icon": {
              "prefix": "https://ss3.4sqi.net/img/categories_v2/food/default_",
              "suffix": ".png"
            }
          }
        ],
        "hasPerk": false
      },
      {
        "id": "3fd66200f964a520c7f11ee3",
        "name": "Otto Enoteca Pizzeria",
        "location": {
          "address": "1 5th Ave",
          "crossStreet": "at E 8th St",
          "city": "New York",
          "state": "NY",
          "postalCode": "10003",
          "country": "US",
          "lat": 40.731990997794966,
          "lng": -73.99622300550848,
          "distance": 681
        },
        "categories": [
          {
            "id": "4bf58dd8d48988d1ca941735",
            "name": "Pizza Place",
            "pluralName": "Pizza Places",
            "shortName": "Pizza",
            "icon": {
              "prefix": "https://ss3.4sqi.net/img/categories_v2/food/pizza_",
              "suffix": ".png"
            }
          },
          {
            "id": "4bf58dd8d48988d123941735",
            "name": "Wine Bar",
            "pluralName": "Wine Bars",
            "shortName": "Wine Bar",
            "icon": {
              "prefix": "https://ss3.4sqi.net/img/categories_v2/food/winery_",
              "suffix": ".png"
            }
          },
          {
            "id": "4bf58dd8d48988d110941735",
            "name": "Italian Restaurant",
            "pluralName": "Italian Restaurants",
            "shortName": "Italian",
            "icon": {
              "prefix": "https://ss3.4sqi.net/img/categories_v2/food/italian_",
              "suffix": ".png"
            }
          },
          {
            "id": "4d4b7105d754a06374d81259",
            "name": "Food",
            "pluralName": "Food",
            "shortName": "Food",
            "icon": {
              "prefix": "https://ss3.4sqi.net/img/categories_v2/food/default_",
              "suffix": ".png"
            }
          },
          {
            "id": "4d4b7105d754a06376d81259",
            "name": "Nightlife Spot",
            "pluralName": "Nightlife Spots",
            "shortName": "Nightlife",
            "icon": {
              "prefix": "https://ss3.4sqi.net/img/categories_v2/nightlife/default_",
              "suffix": ".png"
            }
          },
          {
            "id": "4bf58dd8d48988d116941735",
            "name": "Bar",
            "pluralName": "Bars",
            "shortName": "Bar",
            "icon": {
              "prefix": "https://ss3.4sqi.net/img/categories_v2/nightlife/pub_",
              "suffix": ".png"
            }
          }
        ],
        "hasPerk": false
      }
    ]
  }
}