Skip to main content
RoZod Logo

​
Welcome to RoZod

RoZod makes working with Roblox APIs simple and type-safe in TypeScript. With 650+ classic Roblox web API endpoints and 95+ OpenCloud endpoints (all code-generated from official Roblox documentation), you get comprehensive coverage of virtually every available Roblox API with full type safety. Perfect for everything from small one-time NodeJS/Bun/Deno scripts to large-scale production applications. RoZod powers RoGold, a browser extension with 800,000+ active users, handling millions of API requests daily across both frontend extensions and backend workflows.

​
Key features

Type safety

Complete TypeScript type safety for all 750+ endpoints with requests and responses validated at compile time

Production ready

Battle-tested in applications serving 800,000+ users with millions of daily API requests

Universal runtime

Works seamlessly in NodeJS, Bun, Deno, and browsers with zero configuration changes

Simple interface

Easy to understand API with minimal boilerplate - get started in minutes

Pagination helpers

Built-in tools for handling paginated responses with automatic page fetching

Batch processing

Automatically split large requests to avoid API limits without manual splitting

Smart error handling

Choose between safe type unions or throw-on-error based on your preference

Custom endpoints

Define your own endpoints with full type safety using Zod schemas

​
What’s included

RoZod provides comprehensive coverage of the Roblox API ecosystem:
  • 650+ classic web API endpoints - Complete coverage of traditional *.roblox.com APIs
  • 95+ OpenCloud endpoints - Modern apis.roblox.com/cloud APIs with API key authentication
  • Automatic authentication - Cookie management, CSRF tokens, HBA signatures, and challenge handling
  • Type-safe schemas - All endpoints generated from official Roblox documentation with Zod validation
  • Advanced features - Pagination, batching, cookie pools, user agent rotation, and more

​
Quick example

import { fetchApi, isAnyErrorResponse } from 'rozod';
import { getUsersUserdetails } from 'rozod/lib/endpoints/usersv1';

// Fetch user details with full type safety
const userInfo = await fetchApi(getUsersUserdetails, { userIds: [1, 123456] });
if (isAnyErrorResponse(userInfo)) {
  return;
}
console.log(userInfo.data[0].displayName); // Properly typed!
RoZod automatically handles Roblox’s authentication requirements including CSRF tokens, hardware-backed authentication, and cookie rotation.

​
Get started

Installation

Install RoZod with npm, yarn, pnpm, or bun

Quickstart

Get a working example running in minutes

API reference

Explore the core API functions

Authentication

Learn about cookie management and OpenCloud keys

​
Use cases

RoZod is perfect for:
  • Automation scripts - Automate repetitive Roblox tasks with type-safe APIs
  • Monitoring tools - Track game statistics, player activity, and group events
  • Browser extensions - Build powerful Roblox extensions like RoGold
  • Backend services - Create scalable services that interact with Roblox
  • Data analysis - Collect and analyze Roblox data with confidence
  • Bot development - Build sophisticated Roblox bots with full type safety
RoZod works in both browser and server environments without any configuration changes. Write once, run anywhere.

Build docs developers (and LLMs) love

Get started for freeTalk to us