# 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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/aesthetics-fandom/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## 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/credits/aesthetics-fandom/get-aesthetic-details \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/aesthetics-fandom/list-aesthetic-categories \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/aesthetics-fandom/list-aesthetics-by-category \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/aesthetics-fandom/list-design-aesthetics \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

## Next steps

- [All wrapped API providers](https://paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://paywithlocus.com/agent/index.md): every Locus agent page.