# Overview

The Decentraland Places API provides programmatic access to scenes, worlds, and user interactions within Decentraland.

This API allows you to discover places in Genesis City and Decentraland Worlds, search for content, manage user favorites and ratings, and retrieve user activity data.

Authentication: Some endpoints require authentication using Decentraland's authentication system with Bearer tokens:

```
Authorization: Bearer <your-decentraland-auth-token>
```

Endpoints requiring authentication are marked with a 🔒 icon.

#### Response Format

All responses follow a consistent structure:

**Success Response:**

```json
{
  "ok": true,
  "data": [...],
  "total": 100
}
```

**Error Response:**

```json
{
  "ok": false,
  "error": "Error message description"
}
```

#### Coordinates Format

Parcel coordinates are represented as comma-separated integers: `"x,y"` (e.g., `"-23,-96"`). Valid range: `-150` to `150` for both x and y coordinates.

Place ID Semantics

Each place has a persistent UUID that follows specific rules across scene redeployments:

**UUID Preservation Rules:**

A new scene deployment will **keep the same UUID** if it meets one of these criteria:

* The new scene parcels contain **every parcel** from the previous scene (allows growing)
* The new scene has the **same base parcel** as the previous scene (allows reshaping/shrinking)

A new deployment gets a **new UUID** when:

* Moving to completely different parcels with a different base parcel
* Shrinking without preserving the base parcel

**Examples:**

* ✅ Same UUID: Expanding from 1 to 4 parcels (contains all previous)
* ✅ Same UUID: Reshaping the scene but keeping the same base parcel
* ✅ Same UUID: Shrinking but maintaining the same base parcel
* ❌ New UUID: Moving to entirely different parcels with different base
* ❌ New UUID: Shrinking and changing the base parcel

**Why This Matters:** This ensures user favorites, likes, and social data persist when scenes are updated, while creating new places when the scene fundamentally changes location.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.decentraland.org/apis/apis/places/overview.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.