Description

Returns a hierarchical list of categories applied to venues. This list is also available on our categories page.


Request

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


Authentication

User or userless authentication.


Response Fields

Field Description
id A unique identifier for this category.
name Name of the category.
pluralName Pluralized version of the category name.
shortName Shorter version of the category name.
icon Pieces needed to construct category icons at various sizes. Combine prefix with a size (32, 44, 64, and 88 are available) and suffix, e.g. https://foursquare.com/img/categories/food/default_64.png. To get an image with a gray background, use bg_ before the size, e.g. https://foursquare.com/img/categories_v2/food/icecream_bg_32.png.
primary If this is the primary category for parent venue object.
categories A list of categories that are descendants of this category in the hierarchy.

Response

{
  "meta": {
    "code": 200,
    "requestId": "5854a3664434b94a0959cfb7"
  },
  "notifications": [
    {
      "item": {
        "unreadCount": 13
      },
      "type": "notificationTray"
    }
  ],
  "response": {
    "categories": [
      {
        "categories": [
          {
            "categories": [],
            "icon": {
              "prefix": "https://ss3.4sqi.net/img/categories_v2/arts_entertainment/default_",
              "suffix": ".png"
            },
            "id": "56aa371be4b08b9a8d5734db",
            "name": "Amphitheater",
            "pluralName": "Amphitheaters",
            "shortName": "Amphitheater"
          },
          {
            "categories": [],
            "icon": {
              "prefix": "https://ss3.4sqi.net/img/categories_v2/arts_entertainment/aquarium_",
              "suffix": ".png"
            },
            "id": "4fceea171983d5d06c3e9823",
            "name": "Aquarium",
            "pluralName": "Aquariums",
            "shortName": "Aquarium"
          },
          {
            "categories": [],
            "icon": {
              "prefix": "https://ss3.4sqi.net/img/categories_v2/arts_entertainment/arcade_",
              "suffix": ".png"
            },
            "id": "4bf58dd8d48988d1e1931735",
            "name": "Arcade",
            "pluralName": "Arcades",
            "shortName": "Arcade"
          },
          //...