Public API · No key required

BSS Index API

Every sticker, voucher and beequip in Roblox Bee Swarm Simulator with its current value, price history and market state. Free, CORS enabled, and ready to read from a browser, a bot or a spreadsheet.

Read the docs Документация на русском Live demo BSS Index site

Quick start

// one item, 3 KB
fetch('/api/v1/items/bee-cub.json')
  .then(r => r.json())
  .then(({ name, value, demand, change7d }) =>
    console.log(name, value, demand, change7d));
// -> Bee Cub 290 Low -14.5

// search, server-side
fetch('/api/v1/search?q=bee&limit=5').then(r => r.json());

// curl
curl https://bss-index.vercel.app/api/v1/items/star-cub.json

What you get

Values as numbersReal JSON numbers, not strings. Ready to sum and compare.
Per-item endpoints3 KB for one price instead of downloading the whole list.
Price historyFull series plus 7 and 30 day change on every item.
Beequip rollsEvery roll with its own price, including the floored ones.
Server-side searchRanking, sorting and pagination, Russian names included.
Market moversWhat went up and what went down this week.

Endpoints

MethodPathWhat it returns
GET /api/v1/index.json Discovery document: version, categories, every endpoint.
GET /api/v1/items.json Every item with its current value. Also at /api/v1/values.json.
GET /api/v1/items/{slug}.json One item: value, range, history, rolls and related items.
GET /api/v1/items/{slug}/history.json The full price series with 7 and 30 day change.
GET /api/v1/categories.json Every category with counts and value statistics.
GET /api/v1/categories/{slug}/items.json All items of one category.
GET /api/v1/changes.json Biggest gainers and losers of the last 7 days.
GET /api/v1/stats.json Market summary: counts, average, median, extremes.
GET /api/v1/search-index.json A 41 KB index for instant client-side search.
GET /api/v1/search?q=&category=&sort=&limit=&offset= Server-side search with ranking and pagination.
GET /api/v1/openapi.json OpenAPI 3.1 specification.
GET /api/v1/docs.html This documentation, in English.
GET /api/v1/docs.ru.html The same documentation, in Russian.

Notes

Every primary field is English. The Russian counterpart sits next to it in a *Ru field, so nothing is lost: name / nameRu, demand / demandRu.

CORS is *, so you can call it straight from a browser. The older API shape is still available under /api/v0/ and is deprecated.