RoScripts API

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

Make a request

Hit the search endpoint. No authentication needed.

curl "https://api.roscripts.io/v1/scripts/search?q=blox%20fruits&max=3"

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…" }
}

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.

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:

Capability	RoScripts
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.

Overview

Guides

Endpoints

Quickstart

Endpoints

The Script object

Best practices

Base URL

Quickstart

What you can do

Fetch & filter

Full-text search

Trending

Batch & sync

How it compares

Quickstart

Endpoints

The Script object

Best practices

​Base URL

​Quickstart

​What you can do

Fetch & filter

Full-text search

Trending

Batch & sync

​How it compares

Base URL

Quickstart

What you can do

How it compares