Fruits Basket API

A technical project and a love letter

Dedicated to my husband,
who watched Fruits Basket with me,
and needed a little guide to remember everyone.

Endpoints:

Examples:

GET /characters/yuki
GET /characters?zodiac=dog
GET /characters?family=sohma
GET /characters?zodiac=cat&alive=true
GET /episodes?themes=trauma
GET /episodes?characters=yuki
GET /episodes?themes=family&characters=tohru
GET /characters?zodiac=cat&alive=true

Rules:

Query-based filtering

You can filter any collection by any field using:

GET /collection?field=value

Multiple filters = intersection

All filters must match (logical AND):

GET /characters?zodiac=cat&alive=true
GET /episodes?themes=family&characters=tohru

Multiple IDs (special case)

id accepts a comma-separated list and works as OR.
So it's easy to combine characters to groups, ex. Mabudachi Trio:

GET /characters?id=shigure,hatori,ayame