RoScripter API

Search and read the public Roblox scripts on RoScripter from your website, Discord bot or app. The API is read-only, answers in JSON and needs a free key.

Every response has success, then data or an error. Using the API means following its rules.

Get an API key

Base URL

https://api.roscripter.com/v1

Authentication

Send your key in the Authorization header of every request. X-API-Key works too.

Keep the key on your server or bot, never in a web page or a shared script. A key sent in the URL is refused. If a key leaks, roll it on API Access.

Authenticated request

curl https://api.roscripter.com/v1/me \
  -H "Authorization: Bearer YOUR_API_KEY"

Rate limits

Per key, for each user of your app	60 requests / minute
Per key	300 requests / minute
Per account	5,000 requests / day

Each response has RateLimit-Remaining and X-Daily-Remaining headers. Going over returns 429; the daily count resets at 00:00 UTC. Need more? Ask on Discord.

Errors

Errors use HTTP status codes and return an error with a code and a readable message.

400	`VALIDATION_ERROR` A parameter is invalid. The message says which.	A parameter is invalid. The message says which.
400	`KEY_IN_URL` The key was sent in the URL. Send it in a header.	The key was sent in the URL. Send it in a header.
401	`UNAUTHORIZED` The key is missing, wrong or was rolled.	The key is missing, wrong or was rolled.
403	`KEY_DISABLED` The key was turned off for breaking the rules.	The key was turned off for breaking the rules.
404	`NOT_FOUND` No public script with that slug, or no such endpoint.	No public script with that slug, or no such endpoint.
405	`METHOD_NOT_ALLOWED` Only GET is supported.	Only GET is supported.
429	`RATE_LIMITED` Too many requests this minute.	Too many requests this minute.
429	`DAILY_LIMIT` Your account used today's requests.	Your account used today's requests.
500	`INTERNAL_ERROR` Something went wrong on our side.	Something went wrong on our side.
503	`SERVICE_UNAVAILABLE` The API is briefly down. Try again in a minute.	The API is briefly down. Try again in a minute.
503	`BUSY` The API is busy. Retry after the Retry-After seconds.	The API is busy. Retry after the Retry-After seconds.

Error response400

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "limit is at most 50"
  }
}

Rules

Important

Keep your key secret: use it only on your server or in your app, never in a public web page or a shared script.
Wherever you show our scripts, show “Powered by RoScripter” with a link, and link each script to its url, as it is.
Don't get around the limits, for example with extra accounts or keys.

Breaking a rule gets your API access turned off.

In Discord, [Powered by RoScripter](https://roscripter.com) shows the link.

<a href="https://roscripter.com" target="_blank" rel="noopener">Powered by RoScripter</a>

List scripts

GET/v1/scripts

Returns public scripts, newest first, or search results when you pass q. Lists don't include code.

Query parameters

qstring
Search words, 1–100 characters.
placeIdstring
Only scripts for this Roblox game: the number in its URL. Hubs that support the game are included, except when searching with q.
typeenum
game, hub or universal.
sortenum
newest (default), views, likes or relevance (default when searching).
noKeySystemboolean
If true, only scripts without a key system.
mobileFriendlyboolean
If true, only scripts that work on mobile.
freeboolean
If true, paid scripts are left out.
verifiedOnlyboolean
If true, only scripts from verified creators.
includePatchedboolean
If true, patched scripts are included. Default false.
pageinteger
Page number, 1–200. Default 1.
limitinteger
Results per page, 1–50. Default 20.

Returns A list of script objects and meta with page, limit, total and totalPages.

curl "https://api.roscripter.com/v1/scripts?q=blox%20fruits&limit=1" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response200 OK

{
  "success": true,
  "data": [
    {
      "slug": "blox-fruits-auto-farm",
      "title": "Blox Fruits Auto Farm",
      "description": "Auto farm levels and bosses, fast attack and auto stats…",
      "url": "https://roscripter.com/scripts/blox-fruits-auto-farm?ref=Ab12Cd34",
      "image": "https://api.roscripter.com/api/images/roblox/2753915549",
      "type": "game",
      "game": {
        "placeId": "2753915549",
        "name": "Blox Fruits"
      },
      "keySystem": false,
      "paid": false,
      "mobileFriendly": true,
      "patched": false,
      "stats": {
        "views": 12840,
        "likes": 311,
        "dislikes": 9,
        "downloads": 2210,
        "runs": null
      },
      "author": {
        "username": "someone",
        "image": "https://images.roscripter.com/…",
        "verified": true,
        "url": "https://roscripter.com/profile/someone"
      },
      "createdAt": "2026-09-30T12:00:00.000Z",
      "updatedAt": "2026-10-05T08:30:00.000Z"
    }
  ],
  "meta": {
    "page": 1,
    "limit": 1,
    "total": 128,
    "totalPages": 128
  }
}

Get a script

GET/v1/scripts/{slug}

Returns one public script with every field, including its code.

Path parameters

slugstringrequired
The script's slug, from a list or its page URL.

curl "https://api.roscripter.com/v1/scripts/blox-fruits-auto-farm" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response200 OK

{
  "success": true,
  "data": {
    "slug": "blox-fruits-auto-farm",
    "title": "Blox Fruits Auto Farm",
    "description": "Auto farm levels and bosses, fast attack and auto stats. Works in all three seas.",
    "url": "https://roscripter.com/scripts/blox-fruits-auto-farm?ref=Ab12Cd34",
    "image": "https://api.roscripter.com/api/images/roblox/2753915549",
    "type": "game",
    "game": {
      "placeId": "2753915549",
      "name": "Blox Fruits"
    },
    "keySystem": false,
    "paid": false,
    "mobileFriendly": true,
    "patched": false,
    "stats": {
      "views": 12840,
      "likes": 311,
      "dislikes": 9,
      "downloads": 2210,
      "runs": null
    },
    "author": {
      "username": "someone",
      "image": "https://images.roscripter.com/…",
      "verified": true,
      "url": "https://roscripter.com/profile/someone"
    },
    "createdAt": "2026-09-30T12:00:00.000Z",
    "updatedAt": "2026-10-05T08:30:00.000Z",
    "features": [
      "Auto farm",
      "Fast attack",
      "Auto stats"
    ],
    "tags": [
      "blox fruits",
      "auto farm"
    ],
    "version": 3,
    "keyLink": null,
    "discord": "https://discord.gg/…",
    "video": null,
    "games": [],
    "code": "loadstring(game:HttpGet(\"https://…\"))()"
  }
}

GET/v1/trending

Returns the Trending chart: scripts ranked by how many different players opened them. It's updated once a day.

Query parameters

periodenum
today, week (default) or month.
limitinteger
Results per page, 1–50. Default 20.
offsetinteger
Places to skip, 0–99. Default 0.

Returns Up to 100 places, each with rank, players, move (places up or down since the period before, null when new) and the script.

curl "https://api.roscripter.com/v1/trending?period=week&limit=1" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response200 OK

{
  "success": true,
  "data": [
    {
      "rank": 1,
      "players": 4210,
      "move": 2,
      "script": {
        "slug": "blox-fruits-auto-farm",
        "title": "Blox Fruits Auto Farm",
        "description": "Auto farm levels and bosses, fast attack and auto stats…",
        "url": "https://roscripter.com/scripts/blox-fruits-auto-farm?ref=Ab12Cd34",
        "image": "https://api.roscripter.com/api/images/roblox/2753915549",
        "type": "game",
        "game": {
          "placeId": "2753915549",
          "name": "Blox Fruits"
        },
        "keySystem": false,
        "paid": false,
        "mobileFriendly": true,
        "patched": false,
        "stats": {
          "views": 12840,
          "likes": 311,
          "dislikes": 9,
          "downloads": 2210,
          "runs": null
        },
        "author": {
          "username": "someone",
          "image": "https://images.roscripter.com/…",
          "verified": true,
          "url": "https://roscripter.com/profile/someone"
        },
        "createdAt": "2026-09-30T12:00:00.000Z",
        "updatedAt": "2026-10-05T08:30:00.000Z"
      }
    }
  ],
  "meta": {
    "period": "week",
    "offset": 0,
    "limit": 1,
    "total": 100,
    "updatedAt": "2026-10-07T09:00:00.000Z"
  }
}

Usage

GET/v1/me

Returns your limits and how many requests your account made today.

curl "https://api.roscripter.com/v1/me" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response200 OK

{
  "success": true,
  "data": {
    "limits": {
      "perMinute": 60,
      "perDay": 5000
    },
    "today": {
      "used": 132,
      "remaining": 4868
    }
  }
}

Status

GET/v1/health

Returns { "status": "ok" } as data while the API is up. No key needed, so it's safe for uptime checks.

The script object

The fields every endpoint returns for a script.

Fields

slugstring
The script's ID in URLs. Use it with Get a script.
titlestring
The script's name.
descriptionstring
Plain text. Lists give the first ~300 characters.
urlstring
The script's page on RoScripter. Link to it as it is wherever you show the script: the ref at the end tells us the visit came from your app.
imagestring | null
The cover picture: the creator's own, or the game's.
typeenum
game, hub or universal.
gameobject | null
The main game: placeId and name. null for universal scripts.
keySystem, paid, mobileFriendly, patchedboolean
Whether it needs a key, costs money, works on mobile, or is patched.
statsobject
views, likes, dislikes, downloads, and runs (null unless the creator turned on Run Stats).
authorobject
The creator's username, image, verified and url.
createdAt, updatedAtstring
ISO 8601 dates.

Only in Get a script

features, tagsstring[]
What the script does, and its tags.
versioninteger
The current version number.
keyLink, discord, videostring | null
Where to get the key, the creator's Discord, and a showcase video.
gamesobject[]
The games the script is for, main game first: a game script's own game, or all of a hub's games. Empty for universal scripts.
codestring
The code as players copy it on the site, with a safety tip on top while the creator isn't verified.