Map

Specialized endpoints for map applications that need coordinate-based queries and bulk place data. Optimized for displaying places on a visual map interface.

Get places for map display

get

/map

Retrieve places organized by coordinates, optimized for map visualization.

Map Response Format: Returns an object with coordinates as keys and place data as values, making it easy to display places on a coordinate grid.

Use Case: Building interactive maps of Genesis City showing which places exist at each parcel.

Performance: Higher limit (1000 default) for bulk map loading.

Query parameters

limitinteger · max: 2000Optional

Maximum number of places (default 1000, suitable for maps)

Default: 1000

offsetintegerOptionalDefault: 0

positionsstring[]Optional

Filter by specific coordinates

only_favoritesbooleanOptional

only_highlightedbooleanOptional

order_bystring · enumOptionalPossible values:

orderstring · enumOptionalPossible values:

with_realms_detailbooleanOptional

Include real-time realm data for each place

searchstring · min: 3Optional

categoriesstring[]Optional

Responses

200

Map data retrieved successfully

application/json

Places indexed by coordinates for map display

okbooleanOptionalExample: true

totalintegerOptional

Total number of unique coordinates with places

Example: 2

400

Bad request - Invalid parameters or malformed request

application/json

500

Internal server error - Something went wrong on the server

application/json

get/map

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

{
  "ok": true,
  "total": 2,
  "data": {
    "-23,-96": {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "title": "Art Gallery",
      "base_position": "-23,-96",
      "user_count": 5
    },
    "0,0": {
      "id": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
      "title": "Genesis Plaza",
      "base_position": "0,0",
      "user_count": 42
    }
  }
}

Get all places and worlds for map

get

/map/places

Retrieve both Genesis City places AND Decentraland Worlds in a single query.

Combined Data: Merges places and worlds into one result set for comprehensive map display.

Use Case: Applications that need to show all available content (places + worlds) on a single map interface.

Higher Limits: Default limit of 2000 to accommodate both places and worlds.

Query parameters

limitinteger · max: 5000Optional

Maximum results (default 2000 for places + worlds)

Default: 2000

offsetintegerOptionalDefault: 0

positionsstring[]Optional

Filter places by coordinates

namesstring[]Optional

Filter worlds by names

only_favoritesbooleanOptional

only_highlightedbooleanOptional

order_bystring · enumOptionalPossible values:

orderstring · enumOptionalPossible values:

with_realms_detailbooleanOptional

searchstring · min: 3Optional

categoriesstring[]Optional

Responses

200

Combined places and worlds retrieved

application/json

okbooleanOptional

totalintegerOptional

Total count of places and worlds

400

Bad request - Invalid parameters or malformed request

application/json

500

Internal server error - Something went wrong on the server

application/json

get/map/places

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

{
  "ok": true,
  "data": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "title": "Art Gallery",
      "description": "A contemporary art gallery featuring digital sculptures and interactive installations.",
      "image": "https://peer.decentraland.org/content/contents/QmXYZ...",
      "owner": "0xabcdef1234567890abcdef1234567890abcdef12",
      "positions": [
        "-23,-96",
        "-22,-96",
        "-23,-95"
      ],
      "base_position": "-23,-96",
      "contact_name": "John Doe",
      "contact_email": "[email protected]",
      "content_rating": "T",
      "likes": 45,
      "dislikes": 3,
      "like_score": 0.92,
      "like_rate": 0.94,
      "ranking": 0.75,
      "highlighted": false,
      "exclude_from_ranking": false,
      "favorites": 12,
      "disabled": false,
      "disabled_reason": null,
      "disabled_at": "2026-01-01T00:00:00.000Z",
      "created_at": "2023-01-15T10:30:00Z",
      "updated_at": "2023-06-20T14:45:00Z",
      "deployed_at": "2023-06-20T14:45:00Z",
      "deployment_id": "text",
      "user_like": false,
      "user_dislike": false,
      "user_favorite": true,
      "user_count": 8,
      "user_visits": 234,
      "categories": [
        "art-gallery",
        "social"
      ],
      "realms_detail": [
        {
          "serverName": "unicorn",
          "url": "https://realm-provider.decentraland.org/main",
          "usersCount": 145,
          "userParcels": [
            [
              -23,
              -96
            ],
            [
              0,
              0
            ],
            [
              -22,
              -95
            ]
          ]
        }
      ],
      "sdk": "7",
      "connected_addresses": [
        "0x1234567890abcdef1234567890abcdef12345678",
        "0xabcdef1234567890abcdef1234567890abcdef12"
      ],
      "live": true,
      "live_event_name": "Watch Party Wednesdays"
    }
  ],
  "total": 1
}