# Aesthetics Fandom — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Explore thousands of design aesthetics from the Aesthetics Wiki by browsing the complete catalog or diving into detailed information about any specific aesthetic style. Discover the visual elements, inspirations, and characteristics that define each aesthetic movement to fuel your creative projects.

**Category:** Other | **Website:** [aesthetics.fandom.com/wiki/Category:Design_Aesthetics](https://aesthetics.fandom.com/wiki/Category:Design_Aesthetics) | **Docs:** [parse.bot/marketplace/48e5c2c8-2f36-4099-b98e-45e5ebb73be8/aesthetics-fandom-com-api](https://parse.bot/marketplace/48e5c2c8-2f36-4099-b98e-45e5ebb73be8/aesthetics-fandom-com-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-aesthetics-fandom-com-api-48e5c2c8/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_aesthetic_details

Retrieves detailed information for a specific design aesthetic by title. Returns structured infobox data (decade of origin, location, key motifs, colours, values, related aesthetics, iconic figures, predecessors/successors), an introductory summary paragraph, and the page's wiki categories. Titles are case-sensitive and match the wiki page name exactly (e.g. 'Art Deco', 'Bauhaus', 'Y2K Futurism'). Use list_design_aesthetics to discover valid titles.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `title` | string | Yes | Exact title of the aesthetic wiki page (e.g. 'Art Deco'). Case-sensitive. Obtain from list_design_aesthetics results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-aesthetics-fandom-com-api-48e5c2c8/get_aesthetic_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title":"<string>"}'
```

### list_aesthetic_categories

Lists all aesthetic type categories available on the Aesthetics Wiki (subcategories of 'Aesthetics by Type'). Returns category names, keys, page IDs, and URLs. Use the returned category_key or name as input to list_aesthetics_by_category. Currently returns ~22 categories including Design Aesthetics, Internet Aesthetics, Music Genres, Fashion Styles, Subcultures, Art Movements, etc. A single call retrieves all categories.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-aesthetics-fandom-com-api-48e5c2c8/list_aesthetic_categories \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### list_aesthetics_by_category

Lists all aesthetics within a specified category on the Aesthetics Wiki. Returns page_id, title, and URL for every aesthetic page in the category. Accepts the category name (spaces or underscores). Use list_aesthetic_categories to discover valid category names. Internally paginates against the wiki API with a hard cap of 20 iterations.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | Yes | Category name, e.g. 'Internet Aesthetics', 'Music Genres', 'Fashion Styles'. Accepts spaces or underscores. Use list_aesthetic_categories to discover valid names. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-aesthetics-fandom-com-api-48e5c2c8/list_aesthetics_by_category \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>"}'
```

### list_design_aesthetics

Lists all design aesthetics from the Design Aesthetics category on the Aesthetics Wiki. Returns the complete set of aesthetics with their page IDs, titles, and wiki URLs. The category currently contains ~163 entries. A single call retrieves all entries (internally paginated against the wiki API with a hard cap of 20 iterations).

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-aesthetics-fandom-com-api-48e5c2c8/list_design_aesthetics \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```