latestOpenAPI 3.1.02026-08-1013317298.0 KB
d94e0e0f1821
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