BSS Index API

Почему именно это API

Базовый URL

https://bss-index.vercel.app/api/v1

Все ответы отдаются как application/json с открытой политикой CORS. Заголовки Cache-Control управляются CDN.

Эндпоинты

Параметры

GET/api/v1/items/{slug}.json

Полная запись одного предмета: компактные поля плюс описание, история цен с датами, роллы beequip и до 10 связанных предметов.

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

GET/api/v1/items/{slug}/history.json

История цен одного предмета в виде двух параллельных массивов (даты + цены), а также min/max/average и изменения за 7 и 30 дней. Такой файл есть только у предметов с записанной историей.

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

GET/api/v1/categories/{slug}/items.json

Все предметы одной категории в той же компактной структуре, что и /api/v1/items.json, отсортированные по убыванию стоимости.

curl "https://bss-index.vercel.app/api/v1/categories/bee-stickers/items.json"

GET/api/v1/search

Поиск на стороне сервера. Ищет по названию на любом из двух языков, по slug и по сленгу сообщества для каждой категории (например, «куб» находит Cub Skins). Результаты отсортированы сначала по релевантности, затем по стоимости.

curl "https://bss-index.vercel.app/api/v1/search?q=bee&limit=10"

Примеры

Готово к копированию. Каждый URL ниже сразу возвращает JSON.

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

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

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

curl "https://bss-index.vercel.app/api/v1/categories/bee-stickers/items.json"

curl "https://bss-index.vercel.app/api/v1/changes.json"

curl "https://bss-index.vercel.app/api/v1/search-index.json"

JavaScript (fetch, прямо из браузера)

const items = await fetch('https://bss-index.vercel.app/api/v1/items.json').then(r => r.json());
const bee = await fetch('https://bss-index.vercel.app/api/v1/items/star-cub.json').then(r => r.json());
console.log(bee.value, bee.change7d, bee.rolls.length);

Python

import requests

r = requests.get('https://bss-index.vercel.app/api/v1/items/star-cub.json').json()
print(r['nameRu'], r['value'], r['change7d'])

Структура предмета

Компактная структура, которую используют items.json и categories/<slug>/items.json. Документ отдельного предмета дополнительно содержит description, historicalDates, historicalPrices, rolls и related.

API сначала на английском: name и category всегда содержат английское значение, а русское лежит в nameRu и categoryRu. nameRu равен null, если у предмета нет отдельного русского названия.

Легенды

Спрос

Стабильность

Категории

Как рассчитываются изменения

OpenAPI

Полное машинночитаемое описание: https://bss-index.vercel.app/api/v1/openapi.json — укажите на него свой API-клиент, Swagger UI, Redoc, Postman или собственный кодогенератор.