Sign in
Worlds

List Decentraland Worlds

Retrieve a paginated list of Decentraland Worlds with filtering and sorting.

Worlds vs Places: Worlds are privately owned virtual spaces accessed via unique URLs, while Places are scenes in Genesis City at specific coordinates.

Common Queries:

  • Most active worlds: ?order_by=most_active
  • Search by name: ?search=party
  • Specific worlds: ?names=world-name-1&names=world-name-2
get/worlds

Query parameters

limitinteger

Maximum number of worlds to return (max 100)

offsetinteger

Number of worlds to skip for pagination

namesstring[]

Filter by specific world names (exact match, case-insensitive). Multiple names return worlds matching ANY name (OR logic).

only_favoritesboolean

Show only authenticated user's favorite worlds (requires auth)

order_by'like_score' | 'most_active' | 'created_at'

Sort worlds by:

  • like_score: Best rated (VP-weighted, default)
  • most_active: Current user count
  • created_at: Newest first
order'asc' | 'desc'

Sort direction

searchstring

Full-text search in world title, description (min 3 chars)

categoriesstring[]

Filter by categories

disabledboolean

Include disabled/opt-out worlds in results

ownerstring

Filter by owner's Ethereum address

Response

Worlds retrieved successfully

okboolean
totalinteger

Total number of worlds matching the query

Changes

No recorded changes to this endpoint across all 1 revision of this API.