MVP
Architecture

Turn your Google Sheets into a lightweight REST API for lean validation. Purpose-built for waitlists, feedback forms, and rapid MVP iteration.

Scope & Scale

SheetSandbox is optimized for zero-to-one validation. It is not intended for mid-to-large scale production databases or high-concurrency enterprise applications.

Base API URL
https://api.sheetsandbox.com/api

Security Layer

Authentication is required for every request. We use Bearer Token authorization to ensure your data remains private and secure.

Header Definition
Authorization: Bearer YOUR_KEY_HERE
Dev Concept: API Security

Always keep your API keys secure. Never expose them in client-side code.

NPM Package

JavaScript

The official SheetSandbox JavaScript SDK for npm. Install and start building with minimal setup.

Installation
npm install sheetsandbox
Initialize
import SheetSandbox from 'sheetsandbox';
const client = new SheetSandbox('your-api-token');
Create Record
const result = await client.post('Users', {
  name: 'John Doe',
  email: 'john@example.com'
});
Get All Records
const users = await client.get('Users');
Get Specific Record
const user = await client.getById('Users', 1);

PIP Package

Python

The official SheetSandbox Python SDK. Perfect for backend scripts, data processing, and automation.

Installation
pip install sheetsandbox
Initialize
from sheetsandbox import SheetSandbox
client = SheetSandbox('your-api-token')
Create Record
result = client.post('Users', {
    'name': 'John Doe',
    'email': 'john@example.com'
})
Get All Records
users = client.get('Users')
Get Specific Record
user = client.get_by_id('Users', 1)

List Records

GET Method

Fetches all rows from your connected sheet. Automatically handles JSON conversion of your column headers.

Instant SWR Support
Auto-formatting
Request
GET /api/SheetName
Response
{
  "success": true,
  "data": [
    { "id": 1, "name": "Dev" }
  ]
}

Create Entry

POST Method

Adds a new row to your sheet. Ensure all required fields are present in the request body.

Atomically Appends
Request Body
POST /api/SheetName
{
  "name": "New User",
  "email": "new@example.com"
}
Response
{
  "success": true,
  "data": "inserted"
}

Rate Limits

60
Req / Day (FREE TIER)
3,000
Req / Day (PRO TIER)

To ensure fair usage and maintain performance, we enforce rate limits on all API requests. Hitting these limits will result in a `429 Too Many Requests` error.

Status Code Glossary

200OK

Request successful.

201Created

Resource successfully created.

204No Content

Request successful, but no content to return.

400Bad Request

Invalid syntax in request.

401Unauthorized

Authentication credentials invalid.

403Forbidden

Authenticated but not authorized.

404Not Found

Resource does not exist.

429Too Many Requests

Rate limit exceeded.

500Internal Server Error

Server-side error.