> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pixcraft.es/llms.txt
> Use this file to discover all available pages before exploring further.

# GET /niches

> List all available niches with their configuration.

# List Niches

```
GET /api/v1/niches
```

Returns all available niches for your API key's plan, with default configuration and constraints.

## Example response

```json theme={null}
{
  "niches": [
    {
      "id": "curtains",
      "name": "Cortinas",
      "description": "Diseña cortinas de lamas verticales u horizontales con patrones personalizados a partir de cualquier imagen.",
      "unit_name": "eslabon",
      "unit_name_plural": "eslabones",
      "row_name": "lama",
      "row_name_plural": "lamas",
      "defaults": {
        "unit_width_cm": 1.5,
        "unit_height_cm": 2.0
      },
      "constraints": {
        "min_width_cm": 10,
        "max_width_cm": 1000,
        "min_colors": 2,
        "max_colors": 15
      }
    },
    {
      "id": "mosaics",
      "name": "Mosaicos",
      "description": "Crea mosaicos de azulejos o teselas de colores a partir de cualquier imagen.",
      "unit_name": "tesela",
      "unit_name_plural": "teselas",
      "defaults": {
        "unit_width_cm": 2.0,
        "unit_height_cm": 2.0
      },
      "constraints": {
        "min_width_cm": 10,
        "max_width_cm": 1000,
        "min_colors": 2,
        "max_colors": 18
      }
    }
  ]
}
```

## Current niches

| ID             | Name                | Unit     | Default size   | Max colors |
| -------------- | ------------------- | -------- | -------------- | ---------- |
| `curtains`     | Cortinas            | eslabon  | 1.5 × 2.0 cm   | 15         |
| `mosaics`      | Mosaicos            | tesela   | 2.0 × 2.0 cm   | 18         |
| `crossstitch`  | Punto de cruz       | punto    | 0.3 × 0.3 cm   | 27         |
| `lego`         | LEGO                | stud     | 0.8 × 0.8 cm   | 20         |
| `diamond`      | Diamond Painting    | diamante | 0.25 × 0.25 cm | 30         |
| `embroidery`   | Bordado             | puntada  | 0.4 × 0.4 cm   | 27         |
| `rugs`         | Alfombras           | nudo     | 0.6 × 0.6 cm   | 21         |
| `hama`         | Hama Beads          | cuenta   | 0.5 × 0.5 cm   | 27         |
| `crochet`      | Crochet tapiz       | punto    | 0.5 × 0.6 cm   | 31         |
| `paintnumbers` | Pintura por números | zona     | 1.0 × 1.0 cm   | 34         |
| `minecraft`    | Minecraft Pixel Art | bloque   | 1.0 × 1.0 cm   | 16         |
| `bottlecaps`   | Tapones de botella  | tapón    | 3.2 × 3.2 cm   | 14         |
| `knitting`     | Tricot              | punto    | 0.4 × 0.6 cm   | 31         |
| `latchhook`    | Latch Hook          | hebra    | 1.0 × 1.0 cm   | 26         |
| `stainedglass` | Vitral              | pieza    | 2.0 × 2.0 cm   | 15         |
| `needlepoint`  | Bordado en cañamazo | punto    | 0.35 × 0.35 cm | 27         |
| `macrame`      | Macramé             | nudo     | 0.8 × 0.8 cm   | 15         |
| `roblox`       | Roblox Pixel Art    | bloque   | 1.0 × 1.0 cm   | 20         |
| `quilling`     | Quilling            | tira     | 0.5 × 0.5 cm   | 22         |
| `weaving`      | Tejido en telar     | pasada   | 0.3 × 0.4 cm   | 31         |
| `petitpoint`   | Petit Point         | punto    | 0.15 × 0.15 cm | 27         |

## Notes

* This list is generated dynamically. When new niches are added to PixCraft, they appear here automatically.
* If your API key has `allowed_niches` restrictions, only those niches will be returned.
* Use the `defaults` values when you don't want to ask the user for unit sizes — they are the recommended values for each niche.