MOODBOARD DATA FROM THE AESTHETICS WIKI

AESTHETICS API

The AESTHETICS API serves names, links, and moodboard images for 200+ aesthetics as clean, lightweight JSON.

◎219AESTHETICS
⌘6ENDPOINTS
⊘0AUTH REQUIRED
QUICK START → OPEN EXPLORER ✦

◎ PURPOSE

The AESTHETICS API is a free, open JSON API providing structured data about internet aesthetics — including names, descriptions, references, and moodboard images.

It exists to help developers, designers, and researchers build tools, visualizations, and experiences around aesthetic culture.

  • Curated from the Aesthetics Wiki
  • Clean, consistent, and easy to use
  • No authentication required
  • Open source & community driven

✹ QUICK START

  1. 1

    Base URL

    All API requests start with the base URL.

    http://127.0.0.1:8000
  2. 2

    Make a Request

    Use any endpoint to get started.

    GET /aesthetics
  3. 3

    Parse the JSON

    All responses are returned as JSON.

    Content-Type: application/json
  4. 4

    Use the Data

    Build apps, sites, or tools with the data.

    Enjoy building! ⚡

ENDPOINTS

/aestheticsGET

Retrieve a list of all aesthetics.

Query
  • limit (optional)
  • offset (optional)
Returns

Array of aesthetics

/aesthetics/{slug}GET

Retrieve a single aesthetic by slug.

Params
  • slug (string)
Returns

Aesthetic object

/aesthetics/{slug}/imageGET

Get the primary moodboard image for an aesthetic.

Params
  • slug (string)
Returns

Image URL (string)

/randomGET

Get a random aesthetic.

Query
  • exclude (optional)
Returns

Aesthetic object

/search?q=GET

Search aesthetics by name or keyword.

Query
  • q (string)
  • limit (optional)
Returns

Array of matches

/healthzGET

Check API health status.

Returns

{ status: "ok" }

✦ EXAMPLES

curl -X GET "http://127.0.0.1:8000/aesthetics/vaporwave" \
  -H "Accept: application/json"
const response = await fetch(
  "http://127.0.0.1:8000/random"
);
const aesthetic = await response.json();
import requests

result = requests.get(
  "http://127.0.0.1:8000/search?q=acid"
).json()
{
  "slug": "vaporwave",
  "name": "Vaporwave",
  "image_url": "/images/vaporwave.jpg"
}
{
  "slug": "vaporwave",
  "name": "Vaporwave",
  "description": "A nostalgic, surreal aesthetic drawing from 80s/90s consumer culture and early internet visuals.",
  "aliases": ["ヴェイパーウェイヴ", "vaporpunk"],
  "image": "https://cdn.aesthetics.wiki/images/vaporwave.jpg",
  "wiki": "https://aesthetics.fandom.com/wiki/Vaporwave"
}

API EXPLORER

Try the API directly in your browser.

RESPONSE200 OK
{
  "count": 20,
  "next": "http://127.0.0.1:8000/aesthetics?offset=20",
  "results": [
    { "slug": "vaporwave", "name": "Vaporwave" },
    { "slug": "y2k", "name": "Y2K" }
  ]
}
RESPONSE TIME: 124ms

✣ LICENSE & ATTRIBUTION

Free to use for personal and commercial projects with proper attribution.

TEXT DATA (JSON)

LICENSE: CC BY-SA 3.0

You are free to share and adapt the structured text data, including commercially, as long as you credit the Aesthetics Wiki and preserve the same license.

REQUIREMENTS:

  • Attribution to Aesthetics Wiki

IMAGES (MOODBOARDS)

LICENSE: VARIES

Images are hosted for reference only. Each image may have different copyright terms.

REQUIREMENTS:

  • Check the source before use
  • Follow the original license