---
title: "Memeverse semantic map points"
method: GET
path: "/v1/memeverse/points"
tags: ["Memeverse"]
---

# Memeverse semantic map points

`GET /v1/memeverse/points`

## Request

- Base URL: `https://api.memestack.ai`
- URL: `https://api.memestack.ai/v1/memeverse/points`
- Auth: none declared

Columnar payload for the /memeverse WebGL map: 16 fixed category "galaxies" (geometry) plus every approved, placed image as a point (parallel arrays — ids as dashless UUID hex, integer x/y world coordinates, a category index, a 0-255 engagement glow byte, and a packed atlas sheet/tile reference or -1 when the point has no baked thumbnail yet). Edge-cached 10 minutes, matching the worker-trending placement cron cadence. No authentication required. Returns 404 while the feature is disabled (MEMEVERSE_ENABLED off); returns 200 with empty arrays before the first layout has ever been computed (frontend renders a "forming" state).

## Response `200`

Map points payload.

- object
  - `layout_version` integer: 0 before the first full rebuild has ever run.
  - `world` object
    - `size` integer
  - `generated_at` string, date-time
  - `categories` object[]
    - `slug` string
    - `name` string
    - `x` integer
    - `y` integer
    - `r` integer
    - `count` integer
  - `points` object: Parallel columnar arrays — all the same length, one entry per index across ids/x/y/cat/glow/atlas.
    - `ids` string[]: Dashless 32-char UUID hex.
    - `x` integer[]
    - `y` integer[]
    - `cat` integer[]: Index into the categories array.
    - `glow` integer[]: 0-255 engagement-derived brightness.
    - `atlas` integer[]: Packed (sheet << 12 | tile) thumbnail atlas reference, or -1 when the point has no baked thumbnail yet.

## Other responses

- `404`: Memeverse is disabled (MEMEVERSE_ENABLED is not 'true').

---

[API](https://skmtc.dev/memestack/apis/memestack-api.md) · [All operations](https://skmtc.dev/memestack/apis/memestack-api/llms.txt) · [OpenAPI document](https://skmtc.dev/memestack/apis/memestack-api/revisions/9d3a19565f75?raw)