Character AI Search API

Dokumentasi resmi Character AI Search API dari Maelyn API untuk mencari karakter berdasarkan kata kunci

Base Information

  • BASE_URL_API: https://api.maelyn.eu
  • Path / Endpoint: /ai/character/search
  • Full URL: https://api.maelyn.eu/ai/character/search
  • Method: POST
  • Credit Usage: 3

Authentication

Gunakan header berikut pada setiap request:

maelyn_auth: YOUR_API_KEY
Content-Type: application/json

Request Body

Endpoint ini digunakan untuk mencari karakter dari Character AI berdasarkan kata kunci.

{
  "query": "anime girl"
}

Body Parameters

NameTypeRequiredDescription
querystringYes*Kata kunci pencarian
qstringYes*Alternatif dari query
textstringYes*Alternatif dari query

Salah satu dari query, q, atau text wajib diisi.

Example Usage

{
  "query": "anime girl"
}

Success Response

{
  "success": true,
  "result": [
    {
      "char_id": "abcdefghijklmn123",
      "char_name": "Anime Girl",
      "title": "Cute Anime Character",
      "avatar_file_name": "https://characterai.io/i/80/static/avatars/avatar.png",
      "greeting": "Hi! I'm your anime companion!",
      "search_score": 0.98
    }
  ],
  "total": 1
}

Error Response

Invalid JSON

{
  "success": false,
  "error": "INVALID_JSON",
  "message": "Body request harus berupa JSON"
}

Query Required

{
  "success": false,
  "error": "QUERY_REQUIRED",
  "message": "Field query wajib diisi"
}

Upstream Error

{
  "success": false,
  "error": "UPSTREAM_HTTP_ERROR",
  "message": "Gagal mengambil hasil pencarian character"
}

Data Not Found

{
  "success": false,
  "error": "NEXT_DATA_NOT_FOUND",
  "message": "Data pencarian character tidak ditemukan"
}

Invalid Data

{
  "success": false,
  "error": "INVALID_NEXT_DATA",
  "message": "Struktur data pencarian character tidak valid"
}

Fetch Failed

{
  "success": false,
  "error": "FETCH_FAILED",
  "message": "Terjadi gangguan saat mengambil data character"
}

Internal Server Error

{
  "success": false,
  "error": "INTERNAL_SERVER_ERROR",
  "message": "Terjadi kesalahan pada sistem"
}

Playground