Categories

Discover place and world categories (e.g., art-gallery, social, game). Categories help users find content based on their interests.

List all categories

get

https://places.decentraland.org/apihttp://localhost:4000/api

/categories

Retrieve all active categories with item counts.

Categories help users discover:

• Art galleries and museums

• Social hangout spots

• Games and interactive experiences

• Event venues

• Shopping and commerce

• Educational content

Counts: Each category includes the number of places/worlds tagged with it.

Filtering: Use the target parameter to get counts for only places, only worlds, or both.

Query parameters

targetstring · enumOptional

Filter category counts by type:

• all: Count both places and worlds (default)
• places: Count only Genesis City places
• worlds: Count only Decentraland Worlds

Default: allExample: placesPossible values:

Responses

200

Categories retrieved successfully

application/json

okbooleanOptional

400

Bad request - Invalid parameters or malformed request

application/json

500

Internal server error - Something went wrong on the server

application/json

get/categories

HTTPcURLJavaScriptPython

GET /api/categories HTTP/1.1
Host: places.decentraland.org
Accept: */*

{
  "ok": true,
  "data": [
    {
      "name": "art-gallery",
      "active": true,
      "count": 45,
      "i18n": {
        "en": "Art Gallery"
      }
    },
    {
      "name": "social",
      "active": true,
      "count": 128,
      "i18n": {
        "en": "Social"
      }
    },
    {
      "name": "game",
      "active": true,
      "count": 89,
      "i18n": {
        "en": "Game"
      }
    }
  ]
}