Roast as a Service
How it works
RaaS exposes sharded JSON datasets over GitHub Pages, then a tiny client SDK picks, filters, and caches roasts in the browser, giving you an API‑like experience with pure static hosting.
Static API
Roasts are stored in language‑specific shards (en, bn) and served
as JSON over GitHub Pages’ global CDN for low TTFB.
Smart client
The bundled client fetches a small shard, caches it, and returns random roasts with optional intensity and length filters.
Zero ops
No servers, no cold starts, no scaling issues. Push to main, let Pages deploy and cache everything at the edge.
Why this architecture feels overkill
RaaS is not a toy endpoint glued to a random server. It is a static API designed to exploit CDN edge caching and sharded JSON so you get API-level UX without any backend attached.
Edge-first delivery
All JSON/JS is served from global PoPs, satisfied from edge cache with minimal latency and no application server in the path.
Static API, dynamic feel
The API surface is files, but the SDK handles randomness and filtering to make it behave like a dynamic service while staying 100% static.
Shard & scale
Roasts are split into language shards, which keeps payloads small, cache hit rates high, and lets you grow without slowing down clients.
Operationally boring
No servers, no containers, no autoscaling. Git pushes become deployments, and the CDN takes care of distribution and reliability.
Quick start
npm install
npm install roast-api
// Usage
const RaaS = require('roast-api');
RaaS.getRandomRoast({ lang: 'en' })
.then(r => console.log(r.text));Script include
<script src="https://maijied.github.io/roast-as-a-service/api/client.js"></script>
<script>
RaaS.getRandomRoast({ lang: 'bn', intensity: 2 })
.then(r => console.log(r.text));
</script>Composer (PHP)
composer require maizied/roast-api
// Usage
use Maizied\RoastApi\RaaS;
$roast = RaaS::getRandomRoast(['lang' => 'en']);
echo $roast['text'];pip (Python)
pip install roast-api
# Usage
from roast_api import get_random_roast
roast = get_random_roast(lang='en')
print(roast['text'])Performance
Zero backend, zero cold starts. Optimized for extreme throughput and low TTFB using GitHub Pages' edge CDN.
Postman Collection
Prefer GUI testing? Import our collection and hit the static endpoints directly.
Ready to Test?
Download the official Postman collection to explore all API shards and endpoints instantly.
Download Collection (JSON)