{
  "name": "MemoryMatch.ai",
  "about": "MemoryMatch.ai puts members into memories: pictures of them with the people they match, anywhere, any era. These endpoints give everyone's public profile, the \"canon\" to draw them consistently, and every public memory. Every picture on MemoryMatch.ai is AI-made: members appear as their avatars, never in a real photo.",
  "version": "2026-10-24",
  "auth_required": false,
  "authentication": "none: no key, no sign-in, no headers. Every endpoint here is a plain GET.",
  "reuse": {
    "status": "open_with_credit",
    "commercial_use": true,
    "credit_required": true,
    "pictures": "Anyone may copy, share and reuse the pictures and films on MemoryMatch.ai, and make new pictures, films, songs, stories and games with our members, for any purpose, commercial included, without asking. © 2026 Yarkii LLC. Free to reuse with credit to the people shown: memorymatch.ai/use",
    "data": "The words and data in these endpoints (profiles, avatar sheets, canons, memory titles and captions) may be reused on the same terms.",
    "credit": "Credit is required: name each person shown and link to their MemoryMatch.ai profile, for example \"Nora Blythe on MemoryMatch.ai: https://www.memorymatch.ai/u/nora-blythe\".",
    "rules": "Keep everyone an adult; no nudity or sexual content; never change a person's face, body, weight or sex, or make them cross-dress; no hate, harassment or use that breaks the law; never present a person as saying or endorsing something they did not, and never imply that MemoryMatch.ai endorses your work.",
    "terms_url": "https://www.memorymatch.ai/use",
    "ask_url": "https://www.memorymatch.ai/contact",
    "use_page": "https://www.memorymatch.ai/use"
  },
  "please": "Cache what you fetch (responses say for how long) and prefer the small images.",
  "endpoints": {
    "index": {
      "url": "https://www.memorymatch.ai/api/index.json",
      "what": "This document."
    },
    "members": {
      "url": "https://www.memorymatch.ai/api/members.json?offset=0&limit=100",
      "what": "Everyone with a finished public profile, in username order (a total order: page with offset until next_offset is null). limit at most 200.",
      "item": "members[] = the summary fields below."
    },
    "member": {
      "url": "https://www.memorymatch.ai/api/members/{username}.json",
      "what": "One person in full: summary, sheet info, appearance, pretend life, counts, canon and every public memory they are in."
    },
    "memories": {
      "url": "https://www.memorymatch.ai/api/memories.json?offset=0&limit=100",
      "what": "Every public memory, newest first (date, then id). limit at most 200. ?person={username} narrows to memories that person is in."
    },
    "memory": {
      "url": "https://www.memorymatch.ai/api/memories/{section}/{category}/{slug}.json",
      "what": "One memory: the same fields as an item of memories.json."
    },
    "markdown": {
      "url": "https://www.memorymatch.ai/u/{username}.md",
      "what": "A person's profile and canon as markdown. Their avatar sheet's words: /u/{username}/sheet.md."
    },
    "sheet": {
      "url": "https://www.memorymatch.ai/u/{username}/sheet.json",
      "what": "Their avatar sheet as typed data: height_cm, weight_kg (estimated), build, age band, personality and traits lists, the labelled colour palette, the sheet and portrait image URLs, and the sheet's fixed panel layout for cutting it up (the sheet is one picture; no per-panel images exist)."
    },
    "llms": {
      "url": "https://www.memorymatch.ai/llms.txt",
      "what": "A short guide and everyone's links. /llms-full.txt has every profile in full."
    },
    "mcp": {
      "url": "https://www.memorymatch.ai/api/mcp/public",
      "what": "The same data over the Model Context Protocol, read only, no sign-in: search_members, get_member (with canon), build_prompt, search_memories, get_memory."
    },
    "use": {
      "url": "https://www.memorymatch.ai/use",
      "what": "What you may do with it, and how to credit."
    }
  },
  "fields": {
    "member": {
      "username": "Their unique name; their profile is /u/{username}.",
      "name": "The name shown on their profile.",
      "profile_url": "Their profile page.",
      "json_url": "Their full record (member endpoint).",
      "markdown_url": "Their profile as markdown.",
      "avatar_sheet_url": "Their avatar sheet: the reference image to attach when drawing them (face, hair, body, height, colours). Null while it is being made.",
      "face_url": "Their round profile picture (a cut-out from the avatar sheet). Null until it exists.",
      "role": "The ROLE line printed on their avatar sheet, or null.",
      "vip": "True when they show the VIP badge on their profile right now.",
      "sheet_info": "The words printed on their avatar sheet's info box: role, age, height, build, personality, distinguishing traits. Null if not recorded.",
      "appearance": "How they look, as read off their avatar sheet (and the checks of their setup photos for members): gender, apparent age, height in cm, an ESTIMATED weight in kg, eyes, hair, skin, build, facial hair, and every other trait by name. Ethnicity only where the sheet prints it.",
      "colours": "The signature colours printed on their avatar sheet (hex), in order.",
      "life": "Their pretend life on the site: home city and a job with weekly hours. Made up for the site's calendar, not their real life.",
      "counts": "memories = how many public memories they are in (the length of memories[]); matches = the matches count on their profile.",
      "canon": "How to draw them the same way every time: constants (never change), identity text to paste into a prompt (close = close and medium shots, wide = full-length and wider), signature look, references to attach, the never-list and an example prompt.",
      "memories": "Every public memory they are in, newest first (memory fields)."
    },
    "memory": {
      "id": "section/category/slug; the page is /{id}.",
      "kind": "original = a built-in scene; variant = a built-in made by putting someone else into an original (variant_of names it); upload = made from a member's uploaded photo, remade so nobody real is recognisable; memory_match = made from another memory with members put in.",
      "title": "The memory's own title.",
      "caption": "The words under the title, about this picture's people.",
      "alt": "The picture's alt text.",
      "keywords": "Search keywords for this picture.",
      "section": "Its section (see list_sections on the MCP).",
      "category": "Its category within the section.",
      "setting": "Where it happens (beach, city, home...), or null.",
      "place": "A best-guess real place, region or country, or null.",
      "date": "When it was made or added (ISO 8601), or null.",
      "people": "Everyone in the picture, LEFT TO RIGHT as they appear. profile_url is null for someone without a public profile; a deleted account shows as 'A former member' with no username.",
      "credited_to": "The person the picture belongs to: whoever made it, or for a built-in the first person in it.",
      "images": "small = about 600 px wide; large = up to 1080 px wide; clean = the full picture without our QR mark; shareable = the copy with our QR mark and its title, caption, people and rights in its metadata. Link or embed clean or shareable: the /images/ files refuse other sites' pages."
    }
  }
}