API Reference
Characters

Characters

Retrieve character data to populate your applications.

1. Get All Characters

Returns the list of available characters (name, image, ID, description).

  • Endpoint: GET https://api.luvr.ai/v1/characters

Response

[
  {
    "id": "ember",
    "name": "Ember",
    "description": "Fiery and passionate...",
    "profilePicture": "https://...",
    "tags": ["flirty", "adventurous"]
  },
  ...
]

2. Get Character Details

Get full details for a specific character (prompts, bio, etc).

  • Endpoint: GET https://api.luvr.ai/v1/characters/{username}

Response

{
  "id": "ember",
  "name": "Ember",
  "prompt": "You are Ember...",
  "likesDislikes": "...",
  ...
}