Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.sirius.menu/llms.txt

Use this file to discover all available pages before exploring further.

The RoScripts API gives your script hub, executor, or site direct access to the entire RoScripts catalogue — search, filters, trending, per-game browsing, creator profiles, and a ready-to-run loadstring URL on every script. It’s open: no key is required to get started. An optional API key simply raises your rate limits and page sizes.

Quickstart

Your first request in under a minute — no signup.

Endpoints

Fetch, search, trending, games, owners, and more.

The Script object

Every field a script returns, and what it means.

Best practices

Cache, paginate, and sync the right way.

​
Base URL

https://api.roscripts.io/v1
All endpoints live under /v1. The version prefix is part of the contract — we won’t make breaking changes within v1.

​
Quickstart

1

Make a request

Hit the search endpoint. No authentication needed.
curl "https://api.roscripts.io/v1/scripts/search?q=blox%20fruits&max=3"
2

Read the response

Every successful response is wrapped in a result object, with pagination in meta.
{
  "result": {
    "query": "blox fruits",
    "scripts": [
      {
        "id": "lst_9f2c…",
        "title": "Blox Fruits Hub",
        "slug": "blox-fruits-hub",
        "scriptType": "free",
        "verified": true,
        "key": false,
        "views": 18234,
        "game": { "placeId": 2753915549, "name": "Blox Fruits", "image": "https://…" },
        "loadstring": "https://script.roscripts.io/Ab3xK9q",
        "updatedAt": "2026-05-28T11:04:00Z"
      }
    ],
    "page": 1, "max": 3, "total": 41, "totalPages": 14, "nextPage": 2, "nextCursor": "eyJ2Ijo…"
  },
  "meta": { "page": 1, "max": 3, "total": 41, "totalPages": 14, "nextPage": 2, "nextCursor": "eyJ2Ijo…" }
}
3

Run a script

Every script carries a loadstring URL — a stable, cached execution endpoint. From an executor:
local hit = game:HttpGetAsync("https://api.roscripts.io/v1/scripts/search?q=blox%20fruits&max=1")
local script = game:GetService("HttpService"):JSONDecode(hit).result.scripts[1]
loadstring(game:HttpGet(script.loadstring))()

​
What you can do

Fetch & filter

Page through the catalogue with filters for game, key-system, verified, free/paid, patched, UI library, and more.

Full-text search

Relevance-ranked search with typo-tolerant matching and synonym handling.

Trending

The hottest scripts right now, by a real ranking score.

Batch & sync

Resolve many scripts at once, or pull only what changed with updatedSince.

​
How it compares

RoScripts gives you everything a script-catalogue API should, plus the things hubs actually need:
CapabilityRoScripts
Fetch / search / trending✅
Per-script detail + raw source✅
loadstring execution URL on every script✅
Batch resolve (POST /scripts/batch)✅
Incremental sync (updatedSince)✅
Cursor pagination for stable deep paging✅
Per-game + per-creator browsing✅
ETag / 304 Not Modified✅
Ranking score + community signals✅
Official OpenAPI spec✅ (/v1/openapi.json)
The API is read-only. Publishing and managing scripts happens on roscripts.io. Owners can mint API keys from their account settings.