Sign in
Models

Get public models with pagination

get/v1/models/public

Query parameters

gender'male' | 'female'
Example:female

Filter by gender

searchstring
Example:Emily

Search models by name (case-insensitive). Authenticated users only — ignored for unauthenticated requests.

ethnicity'caucasian' | 'latina' | 'asian' | 'arab' | 'afro' | 'indian' | 'furry' | 'kemonomimi' | 'tiefling'
Example:caucasian

Filter by ethnicity

personality'Caregiver' | 'Sage' | 'Innocent' | 'Jester' | 'Temptress' | 'Dominant' | 'Submissive' | 'Lover' | 'Nympho' | 'Mean' | 'Confidant' | 'Experimenter'
Example:Dominant

Filter by personality type

agenumber
Example:20

Filter by age range (enum value: 18=18-20, 20=21-29, 30=30-39, 40=40-49, 50=50+)

pagenumber
Example:1

Page number (starts from 1)

pageSizenumber
Example:20

Number of results per page (max 100)

sort'recommended' | 'most_popular' | 'top_rated'

Sort order: recommended (default editorial order), most_popular (by views), top_rated (by likes)

localestring
Example:ja-JP

Preferred locale for localized model fields (unauthenticated requests only; authenticated users always get their profile locale). Unsupported values fall back to en-US.

Response

Public models retrieved successfully

totalnumber required

Total number of models

pageSizenumber required

Number of models per page

pagenumber required

Current page number

Example response

{
  "total": 100,
  "pageSize": 20,
  "page": 1,
  "items": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "slug": "anna-smith-x7f2k",
      "name": "Emily Davis",
      "status": "IN_PROGRESS",
      "description": "Emily, a 5'8\" blonde model...",
      "photo": "https://example.com/emily.jpg",
      "avatarIcon": "https://cdn.example.com/avatars/annika-avatar.webp",
      "video": "https://example.com/emily.mp4",
      "useVideo": true,
      "isPublic": true,
      "gender": "female",
      "age": 18,
      "relationship": "Colleague",
      "hairColor": "Black",
      "hairStyle": "Long",
      "eyesColor": "Blue",
      "ethnicity": "caucasian",
      "buttSize": "small",
      "bodyType": "slim",
      "breastType": "large",
      "personality": "Playful, Adventurous",
      "occupation": "Model",
      "hobbies": "Yoga, Beach Volleyball",
      "isPro": true,
      "isNew": true,
      "tiktokVideo": "https://example.com/tiktok/annika_tiktok.mp4",
      "onboardingImage": "https://example.com/onboarding/annika_onboarding.webp",
      "allowedChatModes": [
        "ROLEPLAY"
      ],
      "defaultScenarioCover": "https://cdn.example.com/chat-images/uuid.jpg",
      "socialRating": {
        "views": 1234,
        "likes": 87
      }
    }
  ]
}

Changes

No recorded changes to this endpoint across all 1 revision of this API.