CosplayTele REST API

Node.js · Express · Cheerio scraper · In-memory cache · CORS enabled

—Uptime

—Cached

—Version

GET

Quick:

📡

Select an endpoint above and click Send to test the API

API Reference

All endpoints scrape data live from cosplaytele.com with a 5-minute in-memory cache.

GET

/api/status

Server health, uptime, cache size & list of all endpoints.

Params: none

GET

/api/posts

Paginated list of cosplay posts from the homepage.

Params: page (default 1, max ~457)

Returns: posts[], total_pages, current_page

GET

/api/posts/search

Full-text search across all cosplay posts.

Params: q (required), page

Returns: posts[], query, total_pages

GET

/api/posts/category/:slug

Posts filtered by category slug.

Params: :slug (e.g. game-cosplay), page

Returns: posts[], category, total_pages

GET

/api/posts/:slug

Full detail of a single cosplay post including images, categories, tags and parsed meta.

Params: :slug (e.g. tifa-lockhart)

Returns: title, images[], meta {cosplayer, character, appear_in, photos, file_size}

GET

/api/categories

All known category slugs and URLs.

Params: none

Returns: categories[] {name, slug, url}

GET

/api/popular

Popular posts shown in the footer carousel on cosplaytele.com.

Params: none

Returns: posts[] {id, title, thumbnail, categories}

Post Object Schema

{
  "id":        "tifa-lockhart",
  "slug":      "tifa-lockhart",
  "title":     "Tiny Asa アサ cosplay Tifa Lockhart – Final Fantasy",
  "url":       "https://cosplaytele.com/tifa-lockhart/",
  "thumbnail": "https://cosplaytele.com/wp-content/uploads/...",
  "cosplayer": "Tiny Asa アサ (tiny.asababy)",
  "character": "Tifa Lockhart",
  "appear_in": "Final Fantasy",
  "photos":    "80 photos and 2 videos",
  "has_video": true,
  "excerpt":   "Cosplayer: ... Character: ... Photos: ..."
}

Loading posts…