Live data for the game Rust: skin prices and history, items, item store, loot tables, servers.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Browse or search the item catalogue. One page of live items (seasonal, obsolete and unreleased items are excluded from browsing but still resolve by shortname). Each result carries `shortname`, `display_name`, `category`, `icon_url` and `is_craftable`; fetch `/items/{shortname}` for everything else. Same ordering and cache as the /items page on the site (15 minutes).
1-based page number.
`name` = alphabetical (similarity-ranked while searching); `category` = grouped by category, then name.
Fuzzy name search: substring match plus trigram similarity, so a typo like `asault` still finds the Assault Rifle. Results are ranked by similarity unless `sort=category`.
Restrict to one of the 14 wiki.facepunch.com item categories.
Results per page (max 200).
Tool list last changed Oct 26, 2026.
Browse or search the item catalogue. One page of live items (seasonal, obsolete and unreleased items are excluded from browsing but still resolve by shortname). Each result carries `shortname`, `display_name`, `category`, `icon_url` and `is_craftable`; fetch `/items/{shortname}` for everything else. Same ordering and cache as the /items page on the site (15 minutes).
| Argument | Type | Description |
|---|---|---|
| page | integer | 1-based page number. |
| sort | string | `name` = alphabetical (similarity-ranked while searching); `category` = grouped by category, then name. |
| search | string | Fuzzy name search: substring match plus trigram similarity, so a typo like `asault` still finds the Assault Rifle. Results are ranked by similarity unless `sort=category`. |
| category | string | Restrict to one of the 14 wiki.facepunch.com item categories. |
| per_page | integer | Results per page (max 200). |
{
"type": "object",
"properties": {
"page": {
"type": "integer",
"default": 1,
"minimum": 1,
"description": "1-based page number."
},
"sort": {
"enum": [
"name",
"category"
],
"type": "string",
"default": "name",
"description": "`name` = alphabetical (similarity-ranked while searching); `category` = grouped by category, then name."
},
"search": {
"type": "string",
"examples": [
"assault"
],
"maxLength": 80,
"minLength": 1,
"description": "Fuzzy name search: substring match plus trigram similarity, so a typo like `asault` still finds the Assault Rifle. Results are ranked by similarity unless `sort=category`."
},
"category": {
"enum": [
"weapon",
"construction",
"general",
"resource",
"attire",
"tool",
"medical",
"food",
"ammo",
"trap",
"component",
"electrical",
"fun",
"misc"
],
"type": "string",
"examples": [
"weapon"
],
"description": "Restrict to one of the 14 wiki.facepunch.com item categories."
},
"per_page": {
"type": "integer",
"default": 50,
"maximum": 200,
"minimum": 1,
"description": "Results per page (max 200)."
}
},
"additionalProperties": false
}Browse skins with the site's filters and sorts. One page of skin cards exactly as the /skins browser shows them: `itemdefid`, `name`, icons, `category`, `item_collection`, `market_hash_name`, flags (`is_twitch_drop`, `is_limited_time`, `marketable`, `tradable`, `is_permanent`...), `price` (canonical wiki price in cents, null when Steam has no listing), `subscriptions` (Workshop subscribers, the site's supply proxy), `store_price` (the original item-store price in cents), `store_change_pct` (market price vs store price) and `released` (date accepted into the store). Filters combine with AND. `total` is the filtered count; results are cached for 120 seconds per filter combination.
| Argument | Type | Description |
|---|---|---|
| item | string | Base item shortname, e.g. `rifle.ak` - every skin of that one item. |
| page | integer | 1-based page number. |
| sort | string | Ordering. `popularity` and `supply_asc` use Workshop subscribers; `trending` is the 7-day price change; `marketcap_desc` is price x subscribers. |
| color | string | Dominant icon colour bucket; matches any of a skin's up to five dominant colours. |
| glows | boolean | Only skins with glow-in-the-dark elements. |
| search | string | Fuzzy name search (trigram similarity; with sort=name results are relevance-ordered). Searches are never cached server-side. |
Raw materials to craft a list of items. Resolves every recipe down to raw materials, per unit (items made in batches, like gunpowder, are divided by their batch size), exactly as the craft calculator page does. `raw_materials` is the total, largest first; `items` echoes each input with its direct recipe; `unknown` lists inputs that matched no item.
| Argument | Type | Description |
|---|---|---|
| items* | string | Comma-separated `shortname:quantity` pairs (display names work too; quantity defaults to 1). |
{
"type": "object",
"required": [
"items"
],
"properties": {
"items": {
"type": "string",
"examples": [
"rocket:4,explosive.timed:2"
],
"maxLength": 2000,
"minLength": 1,
"description": "Comma-separated `shortname:quantity` pairs (display names work too; quantity defaults to 1)."
}
},
"additionalProperties": false
}Explosives needed to destroy a set of building pieces. For every explosive that can destroy all the given pieces: total units and sulfur, cheapest sulfur first; `cheapest` is the best single option. Single-explosive totals - damage adds up across explosives, so a mix can be cheaper (use /calculators/raid's damage_per_unit for that). Doors and deployables aren't covered yet.
| Argument | Type | Description |
|---|---|---|
| targets* | string | Comma-separated `slug:count` building pieces (slugs from /building, or display names). |
| explosives | string | `staples` (rockets, C4, satchels, explosive ammo, beancans), `all`, or a comma list of explosive shortnames. |
{
"type": "object",
"required": [
"targets"
],
"properties": {
"targets": {
"type": "string",
"examples": [
"stone-wall:2,sheet-metal-wall:1"
],
"maxLength": 2000,
"minLength": 1,
"description": "Comma-separated `slug:count` building pieces (slugs from /building, or display names)."
},
"explosives": {
"type": "string",
"default": "staples",
"description": "`staples` (rockets, C4, satchels, explosive ammo, beancans), `all`, or a comma list of explosive shortnames."
}
},
"additionalProperties": false
}What recycling a list of items yields. Expected outputs (quantity x per-unit yield x chance) per input and in total, for the chosen recycler.
| Argument | Type | Description |
|---|---|---|
| items* | string | Comma-separated `shortname:quantity` pairs (display names work too; quantity defaults to 1). |
| recycler | string | `recycler` (monument) or `safe_zone` (Outpost/Bandit Camp, lower yields). |
{
"type": "object",
"required": [
"items"
],
"properties": {
"items": {
"type": "string",
"examples": [
"gears:10,metalpipe:5"
],
"maxLength": 2000,
"minLength": 1,
"description": "Comma-separated `shortname:quantity` pairs (display names work too; quantity defaults to 1)."
},
"recycler": {
"enum": [
"recycler",
"safe_zone"
],
"type": "string",
"default": "recycler",
"description": "`recycler` (monument) or `safe_zone` (Outpost/Bandit Camp, lower yields)."
}
},
"additionalProperties": false
}Daily upkeep for a base. The upkeep calculator page's math: the block count walks Rust's default upkeep brackets to a blended daily rate, and each resource's daily upkeep is what was spent building times that rate (`per_week` = 7 days).
| Argument | Type | Description |
|---|---|---|
| wood | number | Total wood spent building the base. |
| stone | number | Total stone spent. |
| blocks* | integer | Number of building blocks (foundations, walls, floors... each counts one). |
| metal_fragments | number | Total metal fragments spent. |
| high_quality_metal | number | Total high quality metal spent. |
{
"type": "object",
"required": [
"blocks"
],
"properties": {
"wood": {
"type": "number",
"default": 0,
"minimum": 0,
"description": "Total wood spent building the base."
},
"stone": {
"type": "number",
"default": 0,
"minimum": 0,
"description": "Total stone spent."
},
"blocks": {
"type": "integer",
"maximum": 100000,
"minimum": 1,
"description": "Number of building blocks (foundations, walls, floors... each counts one)."
},
"metal_fragments": {
"type": "number",
"default": 0,
"minimum": 0,
"description": "Total metal fragments spent."
},
"high_quality_metal": {
"type": "number",
"default": 0,
"minimum": 0,
"description": "Total high quality metal spent."
}
},
"additionalProperties": false
}Overlay skins, baskets and indices on one date axis. The data behind rust.wiki/skins/compare: one shared `dates` axis and a `series` entry per token with `key`, `name`, `icon_url`, `is_basket`, `is_index` and `prices` aligned to the axis (null where that entry has no data yet). Skin and basket entries are prices in cents (a basket is the plain average of its members' prices); index entries are index levels rebased to 100. Spans over two years are downsampled to weekly points. Cached for 24 hours per parameter combination.
| Argument | Type | Description |
|---|---|---|
| range | string | Window: `7d`, `30d`, `90d`, `1y`, `2y`, `3y`, `4y`, `5y`, `all`, or `custom` with `start_date`/`end_date`. Spans over two years are downsampled to one point per week. |
| smooth | boolean | Apply a trailing 30-day moving average. |
| entries* | string | Comma-separated, up to 8: an `itemdefid` (that skin's price), `category:weapon` / `collection:Forest Raiders` / `item:shoes.boots` (the basket's average price) or `index:all` / `index:category:weapon` / `index:custom:123.456` (an index entry; custom ids joined with `.`). |
| end_date | string | Custom range end (YYYY-MM-DD, inclusive). Only read when range=custom. |
| trim_days | integer | Mask each constituent's first N days of history (0-90) to drop launch-week volatility. |
| start_date |
Executable buy-on-marketplace, sell-on-Steam flips. Every skin that can be bought on a third-party marketplace for less than it nets on Steam Community Market right now, as rust.wiki/skins/deals computes it. Per deal: `buy_market` and `buy_price` (the cheapest in-stock listing we poll, cents), `sell_url` (the Steam listing page), the two Steam references `bid_gross`/`bid_net` (highest buy order, and what you actually receive after Steam's 15% fee) and `ask_gross`/`ask_net` (lowest sell order, same), then for the chosen `steam_ref`: `sell_price` (the net proceeds), `sell_gross`, `spread_abs` (cents) and `spread_pct`. Only rows profitable under the chosen reference are returned. A stale buy order above a fresher ask is capped at the ask. Filters combine with AND; `search` matches the skin name case-insensitively. Marketplace links are not included. Recomputed every ~5 minutes from the marketplace poll.
| Argument | Type | Description |
|---|---|---|
| page | integer | 1-based page number. |
| sort | string | Best `pct` (spread as % of buy price) or `abs` (spread in cents) first. |
| search | string | Case-insensitive substring of the skin name (or Steam market name). |
| category | string | Only skins of this category. |
| per_page | integer | Results per page (max 200). |
| max_price | integer | Maximum buy price in cents. |
Best crossbreeding layout from a pool of plant clones. The gene calculator's beam search, ported exactly: which clones to plant around the centre, how many of each, and what the centre will most likely become (with every outcome's chance). Uses the game's gene weights (red W/X 1.0, green G/Y/H 0.6).
| Argument | Type | Description |
|---|---|---|
| centre | string | Optional genes of the plant in the centre slot (default: unknown). |
| clones* | string | Comma-separated 6-letter gene strings of the clones you have (G Y H W X). |
| target | string | Optional 6-letter target such as GGGGYY; default: as many G and Y as possible. |
| max_neighbours | integer | Most neighbouring plants to use (a planter grid allows 8). |
{
"type": "object",
"required": [
"clones"
],
"properties": {
"centre": {
"type": "string",
"description": "Optional genes of the plant in the centre slot (default: unknown)."
},
"clones": {
"type": "string",
"examples": [
"GGYYHX,GYYHWW,YYGGXH"
],
"maxLength": 400,
"minLength": 6,
"description": "Comma-separated 6-letter gene strings of the clones you have (G Y H W X)."
},
"target": {
"type": "string",
"description": "Optional 6-letter target such as GGGGYY; default: as many G and Y as possible."
},
"max_neighbours": {
"type": "integer",
"default": 8,
"maximum": 8,
"minimum": 1,
"description": "Most neighbouring plants to use (a planter grid allows 8)."
}
},
"additionalProperties": false
}What a plant will grow into from its neighbours. Every possible result for the centre plant with its probability, most likely first.
| Argument | Type | Description |
|---|---|---|
| centre | string | Genes of the centre plant, if known. |
| neighbours* | string | Comma-separated 6-letter gene strings of the neighbouring plants. |
{
"type": "object",
"required": [
"neighbours"
],
"properties": {
"centre": {
"type": "string",
"description": "Genes of the centre plant, if known."
},
"neighbours": {
"type": "string",
"examples": [
"GGYYHX,GGYYHX,YYGGXH"
],
"maxLength": 200,
"minLength": 6,
"description": "Comma-separated 6-letter gene strings of the neighbouring plants."
}
},
"additionalProperties": false
}One building piece: costs, durability, siblings. The piece's `slug`, `display_name`, `grade`, `health` and `decay_hours`, plus `costs` (`build`, `repair` and `upkeep` lists of `item_name`, `amount` or `min_amount`/`max_amount`, with `shortname`/`icon_url` when the material maps to a catalogue item), `durability` (up to ten entries each for `explosive`, `melee` and `bullet` damage: `item_name`, `seconds_taken` to destroy, `required_items` = how many of that weapon/explosive) and `siblings` - the same piece at every other grade, Twig to Armored. Cached for one hour.
| Argument | Type | Description |
|---|---|---|
| slug* | string | Piece slug from `/building`, e.g. `stone-wall`. |
{
"type": "object",
"required": [
"slug"
],
"properties": {
"slug": {
"type": "string",
"examples": [
"stone-wall"
],
"maxLength": 80,
"minLength": 1,
"description": "Piece slug from `/building`, e.g. `stone-wall`."
}
},
"additionalProperties": false
}CCTV camera codes by monument. The 12 monuments with working CCTV cameras and their Computer Station identifiers (60 codes). `codes` are the literal in-game console codes; when `randomized` is true the trailing `****` is a per-wipe random 4-digit suffix posted near the camera in-game, not a fixed code. `slug` links to `/monuments/{slug}` (null for Cargo Ship, which is a moving monument). Fixed reference data.
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": false
}When each dataset last changed and how often it refreshes. The quota-saver: for every dataset the API serves, `updated_at` (the newest timestamp actually in the table, UTC) and `refresh_seconds` (how often it can change), with the endpoints it feeds. Poll this cheap endpoint and only re-fetch a heavy payload such as /market/prices or /servers when its dataset's `updated_at` has moved; cache reference data (items, monuments, ...) locally since it only changes with Facepunch's monthly patch. Timestamps are read live from the database and cached for 60 seconds.
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": false
}Value a Steam account's Rust skins. Every Rust skin the account holds with `quantity`, unit `price` and `value` (cents), sorted by value, and the same attributes /skins filters on (`collection`, `creator`, `item_shortname`, `item_name`, `est_supply`, `released_year`, `colors`, and `flags`: limited_time, permanent, marketable, tradable, breakable, glows, commodity, drop), plus `total_value`, `item_count`, `distinct_skins`, a `categories` breakdown with share percentages, the owner's display name and avatar, and `value_history` (the current holdings re-priced at each of the last 365 days, in USD DOLLARS, not cents, at each day's Steam sale price - so its latest point can be below `total_value`, which is at current asking prices). `found` is false for private or empty inventories; `stale` is true when Steam was unreachable and the last stored snapshot was re-priced instead. Takes a 17-digit SteamID64 (use resolve_steam_profile for a profile URL or custom name); the inventory must be public. Served from the stored copy when the inventory was checked in the last 24 hours, otherwise read live from Steam. No key needed: keyless clients share a daily inventory cap; send your own free key (https://rust.wiki/api-keys) as X-API-Key for a private quota.
| Argument | Type | Description |
|---|---|---|
| steamid* | string | 17-digit SteamID64 (resolve URLs and vanity names with /players/resolve). |
{
"type": "object",
"required": [
"steamid"
],
"properties": {
"steamid": {
"type": "string",
"examples": [
"76561198869732295"
],
"description": "17-digit SteamID64 (resolve URLs and vanity names with /players/resolve)."
}
},
"additionalProperties": false
}Most valuable inventories ever checked. The rust.wiki/inventory leaderboard: every inventory anyone has looked up, ranked by total value at its last check (values are re-priced each time an inventory is viewed or by the daily warmer for the top 20). Includes the network-wide totals. 20 per page. No key needed.
| Argument | Type | Description |
|---|---|---|
| page | integer | 1-based page; 20 inventories per page. |
{
"type": "object",
"properties": {
"page": {
"type": "integer",
"default": 1,
"minimum": 1,
"description": "1-based page; 20 inventories per page."
}
},
"additionalProperties": false
}One saved daily snapshot. The inventory exactly as it was priced on that day: items with quantity and that day's price, total value and item count. Useful for 'what was this worth last month' comparisons. No key needed.
| Argument | Type | Description |
|---|---|---|
| date* | string | ISO date (YYYY-MM-DD) from /inventory/{steamid}/snapshots. |
| steamid* | string | 17-digit SteamID64. |
{
"type": "object",
"required": [
"steamid",
"date"
],
"properties": {
"date": {
"type": "string",
"examples": [
"2026-09-30"
],
"description": "ISO date (YYYY-MM-DD) from /inventory/{steamid}/snapshots."
},
"steamid": {
"type": "string",
"examples": [
"76561198869732295"
],
"description": "17-digit SteamID64."
}
},
"additionalProperties": false
}What an inventory is realistically worth. The inventory valued three ways, plus what selling would actually raise. `at_asks` is the headline number (each skin at its cheapest Steam listing, falling back to the best buy order); `at_bids` is every skin at its best buy order; `at_recent_sales` is every skin at its latest Steam median sale price (the inventory chart's basis). `sell_now` walks each skin's real buy-order ladder for the quantity held: `units_sellable` of `units_held` could be sold instantly for `gross` (what buyers pay) and `net_after_fees` (after Steam's 15%). `biggest_ask_gaps` lists the skins whose cheapest listing sits furthest above their recent sales - thin order books where the headline is least reliable. All cents. Uses the stored holdings (the last lookup) and current order books: never a live Steam call; look the inventory up first if `found` is false. No key needed. Use when asked what an inventory is REALLY worth or would sell for: asks vs bids vs recent sales, and instant-sell proceeds after Steam's 15% fee.
| Argument | Type | Description |
|---|---|---|
| steamid* | string | 17-digit SteamID64. |
{
"type": "object",
"required": [
"steamid"
],
"properties": {
"steamid": {
"type": "string",
"examples": [
"76561198869732295"
],
"description": "17-digit SteamID64."
}
},
"additionalProperties": false
}Inventory value over time. The inventory's value over time: the account's current holdings re-priced at each day's Steam SALE price (median sale), `values` in USD cents, oldest first - the line on the rust.wiki inventory chart. It shows how the market moved, not when items were bought. `headline_total_value` is the total at current Steam ASKING prices (lowest sell order) as of `headline_checked_at`, the number shown at the top of the inventory page; for thinly traded skins it can sit well above the latest point here. Only inventories that have been looked up have a series. Read from stored data: never a live Steam call. No key needed. Use this for the value-over-time graph's data points (any range, daily/weekly/monthly); get_inventory only carries a thinned one-year series. Look the inventory up with get_inventory first if it returns found=false.
| Argument | Type | Description |
|---|---|---|
| range | string | 7d, 30d, 90d, 1y, 2y, 3y, 4y, 5y, all, or custom (with start_date/end_date). |
| steamid* | string | 17-digit SteamID64. |
| end_date | string | YYYY-MM-DD, with range=custom. |
| interval | string | daily, weekly, monthly, or auto (daily up to 400 points, then weekly, then monthly past 400 weeks). |
| start_date | string | YYYY-MM-DD, with range=custom. |
Full item detail bundle. Everything the item page shows, in one response: `item` (name, description, category, icon, stack size, despawn seconds, craftable flag), `recipe` (components with quantities), `blueprint_costs` (unlock source, scrap cost, workbench tier), `recycle` (yields per recycler type with chance), `repair`, `loot_sources` (every crate/NPC/barrel that drops it, with `chance_pct` and `amount`, highest chance first), `used_in` (items this one is an ingredient of), `skins` (the first 24 skins by price, each with `price` and `store_price` in USD cents, `subscriptions` and `released`), `skins_total` and `similar` (six items from the same category). Page through all skins with `/items/{shortname}/skins`. Cached for 15 minutes.
| Argument | Type | Description |
|---|---|---|
| shortname* | string | The item's shortname, e.g. `rifle.ak` or `metal.fragments`. |
{
"type": "object",
"required": [
"shortname"
],
"properties": {
"shortname": {
"type": "string",
"examples": [
"rifle.ak"
],
"maxLength": 80,
"minLength": 1,
"description": "The item's shortname, e.g. `rifle.ak` or `metal.fragments`."
}
},
"additionalProperties": false
}All skins for an item, priced. Every skin for one base item, most expensive first (unpriced skins last, then by name) - the same list and order as the Skins tab on the item page. Each skin carries `itemdefid`, `name`, `icon_url`, `market_hash_name`, `item_collection`, `workshopid`, `price` (canonical wiki price, USD cents, null when nothing is listed), `store_price` (its original Rust item-store price, USD cents), `store_change_pct`, `subscriptions` (Workshop subscriber count), `released` and the tradable/marketable/banned flags. Prices refresh about every 12 minutes; this list is cached for 15.
| Argument | Type | Description |
|---|---|---|
| page | integer | 1-based page number. |
| per_page | integer | Results per page (max 200). |
| shortname* | string | The item's shortname, e.g. `rifle.ak`. |
{
"type": "object",
"required": [
"shortname"
],
"properties": {
"page": {
"type": "integer",
"default": 1,
"minimum": 1,
"description": "1-based page number."
},
"per_page": {
"type": "integer",
"default": 50,
"maximum": 200,
"minimum": 1,
"description": "Results per page (max 200)."
},
"shortname": {
"type": "string",
"examples": [
"rifle.ak"
],
"maxLength": 80,
"minLength": 1,
"description": "The item's shortname, e.g. `rifle.ak`."
}
},
"additionalProperties": false
}The current Rust item store. What is purchasable in Rust's item store right now, in the three sections the wiki shows: `limited_time` (this week's rotation, most Workshop subscribers first), `general` (the permanent catalogue) and `dlc_packs` (bundles, by name). Each item carries `itemdefid`, `name`, `icon_url`, `category`, `store_price` (cents), `market_price` (its Steam Community Market price in cents, null when unlisted), `rarity`, `item_collection`, `creator_name`/`creator_avatar_url`, `subscriptions`, `est_supply` with `est_supply_source` (`workshop` subscribers for brand-new items, the market estimate otherwise), `base_item_name` and the usual flags. Also `recent_rotations` (the last six, newest first, `is_current` marks the open one), `active_rotation_id` and `next_rotation_at` (the open rotation's start + 7 days; rotations land on Thursdays). Steam's own purchase URL for any item is `https://store.steampowered.com/buyitem/252490/{itemdefid}/{quantity}`. Cached 30 minutes.
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": false
}Past item-store rotations. Every weekly rotation, newest first (the open one included): `id` (the rotation slug, `YYYY-MM-DD-HHMM`, or `General` for the permanent catalogue), `name` (Facepunch's label when it had one, usually null), `start`, `end` (null while current), `itemdefid_count` and `icons` - every skin in it as `{url, name}`, DLC packs excluded. With `search`, only the rotations that sold a matching skin are returned (same shape, newest first), which answers "when was X in the store?". Full item lists via GET /store/rotations/{rotation_id}. Cached for an hour; searches are computed live.
| Argument | Type | Description |
|---|---|---|
| page | integer | 1-based page number. |
| search | string | Only rotations that contained a skin whose name matches this (case-insensitive substring), e.g. `Tempered`. |
| per_page | integer | Results per page (max 200). |
{
"type": "object",
"properties": {
"page": {
"type": "integer",
"default": 1,
"minimum": 1,
"description": "1-based page number."
},
"search": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Only rotations that contained a skin whose name matches this (case-insensitive substring), e.g. `Tempered`."
},
"per_page": {
"type": "integer",
"default": 50,
"maximum": 200,
"minimum": 1,
"description": "Results per page (max 200)."
}
},
"additionalProperties": false
}One loot table with every drop. The loot source's `id` and `name` plus `drops`, highest chance first: for each item `shortname`, `display_name`, `icon_url`, `chance_pct` (0-100), `amount_min`/`amount_max` and, for items that spawn damaged, `condition_min_pct`/`condition_max_pct`. Scraped from wiki.facepunch.com; cached for 30 minutes.
| Argument | Type | Description |
|---|---|---|
| source_id* | integer | Loot source id from `/loot-tables`, `/monuments/{slug}` or an item's `loot_sources`. |
{
"type": "object",
"required": [
"source_id"
],
"properties": {
"source_id": {
"type": "integer",
"minimum": 1,
"examples": [
1
],
"description": "Loot source id from `/loot-tables`, `/monuments/{slug}` or an item's `loot_sources`."
}
},
"additionalProperties": false
}Market cap of the Rust skin market. The rust.wiki Market Cap page as data: `total_value` (cents), `skin_count`, `unit_count`, `by_category` (`{category, value}`) and `top`, every skin ranked by value with `{itemdefid, name, icon_url, price, amount, value}`. Supply is not something Steam exposes, so `amount` is the skin's Steam Workshop subscriber count - a stated approximation (subscribing is not owning) - and `value` is price x amount. Only marketable skins with a live Steam price and a linked Workshop submission are included. Cached for 15 minutes.
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": false
}Skin market index series. The rust.wiki Market Index: a basket of skins rebased to 100 at the start of the window, like a stock index, built from Steam's daily price history (one point per day; weekly beyond two years). Returns `dates` (ISO dates), `values` (index level, 100 = the window's first day), `constituent_count` (skins that had a price at the baseline; baskets are capped at 300 constituents) and `label`. A skin whose history starts inside the window joins from its first price. Cached for 24 hours per parameter combination (history only gains a point every 6 hours); the full catalogue, every category and every collection are kept warm server-side.
| Argument | Type | Description |
|---|---|---|
| range | string | Window: `7d`, `30d`, `90d`, `1y`, `2y`, `3y`, `4y`, `5y`, `all`, or `custom` with `start_date`/`end_date`. Spans over two years are downsampled to one point per week. |
| smooth | boolean | Apply a trailing 30-day moving average. |
| end_date | string | Custom range end (YYYY-MM-DD, inclusive). Only read when range=custom. |
| trim_days | integer | Mask each constituent's first N days of history (0-90) to drop launch-week volatility. |
| start_date | string | Custom range start (YYYY-MM-DD, inclusive). Only read when range=custom. |
| basket_type | string | Which skins form the index: `all`, `high_value`/`low_value` (300 priciest/cheapest), `category`, `collection`, `color`, `item` (one base item's skins) or `custom` (your own list). |
Stonking, crashing and most-anticipated skins. The rust.wiki Insights page: `stonking` - the 10 skins trading closest to (or above) their all-time high, `crashing` - the 10 closest to their all-time low (each `{itemdefid, name, icon_url, price, reference_price}`, cents; the reference is that skin's own all-time high or low from Steam's multi-year history, skins with under 30 history points excluded), and `anticipated` - the 50 marketable skins with the most Steam Workshop subscribers (`{itemdefid, name, icon_url, subscriptions}`). Refreshed with each price-history run, about every 6 hours.
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": false
}One monument with its loot sources. The same fields as `/monuments` for one monument plus `loot_sources`: every crate/NPC loot table that spawns at it (`id`, `name`, `drop_count`), alphabetical - fetch each with `/loot-tables/{id}`. Cached for one hour.
| Argument | Type | Description |
|---|---|---|
| slug* | string | Monument slug from `/monuments`, e.g. `airfield`. |
{
"type": "object",
"required": [
"slug"
],
"properties": {
"slug": {
"type": "string",
"examples": [
"airfield"
],
"maxLength": 80,
"minLength": 1,
"description": "Monument slug from `/monuments`, e.g. `airfield`."
}
},
"additionalProperties": false
}Player profile, Rust stats and achievements. Profile summary (name, avatar, country, Steam level, account age), VAC/game bans, Rust playtime, every Rust stat Steam exposes grouped into Combat / Animals & NPCs / How you died / Gathering & loot / Building / Travel / Life on the island / Fishing / Music / Everything else, six headline figures (kills, deaths, K/D, headshots, bullet and arrow accuracy), and all 116 achievements with unlock dates. `stats_private` is true when the profile hides game details, in which case `groups` and `achievements` are empty.
| Argument | Type | Description |
|---|---|---|
| steamid* | string | 17-digit SteamID64. Use /players/resolve for URLs and vanity names. |
{
"type": "object",
"required": [
"steamid"
],
"properties": {
"steamid": {
"type": "string",
"examples": [
"76561199126382502"
],
"description": "17-digit SteamID64. Use /players/resolve for URLs and vanity names."
}
},
"additionalProperties": false
}Raid cost table: explosives and sulfur per building piece. The dataset behind the raid calculator. `explosives` lists every explosive the building durability data covers: `shortname`, `name`, `icon_url`, `group` (`staples`, `other` or `siege`), `staple` (true for rockets, C4, satchel charges, explosive 5.56 ammo and beancans - the page's default set), `sulfur_per_unit` and `raw_cost_per_unit` (the crafting recipe resolved down to raw resources such as sulfur, charcoal, metal fragments and low grade fuel, per single unit; both null for loot-only explosives like MLRS rockets), `batch` (units one craft makes: explosive ammo 2, mortar shells 2) and `recipe_source` (`wiki` = the wiki's own crafting data, `fallback` = Rust's standard recipe where that data has none yet, e.g. rockets). `targets` is every building piece with explosive data (`slug`, `name`, `grade`, `health`), each with `costs` - for every explosive that can damage it, `required` (how many destroy one piece), `damage_per_unit` and `sulfur` (null for loot-only) - and `cheapest_staple`, the single staple explosive that destroys it for the least sulfur. Damage from different explosives adds up, so a cheaper mix can be computed from `damage_per_unit`. Doors and deployables are not covered yet. Cached for 24 hours.
| Argument | Type | Description |
|---|---|---|
| grade | string | Restrict `targets` to one building grade. |
{
"type": "object",
"properties": {
"grade": {
"enum": [
"Twig",
"Wood",
"Stone",
"Metal",
"Armored",
"Boat"
],
"type": "string",
"examples": [
"Stone"
],
"description": "Restrict `targets` to one building grade."
}
},
"additionalProperties": false
}Recently wiped servers. Wipes detected across every online server in the window, newest first - the feed behind servers.rustprofit.com/wipes. A wipe is detected when a server's `world_seed` or `world_size` changes between two polls, or when the last-wipe time it advertises moves past our previous poll (for servers with A2S rules disabled). Each entry has `detected_at`, the old and new seed/size, and the full server record. Expect thousands of entries in the 24 hours after Rust's monthly forced wipe (first Thursday). Cached for five minutes.
| Argument | Type | Description |
|---|---|---|
| page | integer | 1-based page number. |
| hours | integer | Look-back window in hours (1-168). The site's /wipes page shows 24. |
| per_page | integer | Results per page (max 200). |
{
"type": "object",
"properties": {
"page": {
"type": "integer",
"default": 1,
"minimum": 1,
"description": "1-based page number."
},
"hours": {
"type": "integer",
"default": 24,
"maximum": 168,
"minimum": 1,
"examples": [
24
],
"description": "Look-back window in hours (1-168). The site's /wipes page shows 24."
},
"per_page": {
"type": "integer",
"default": 50,
"maximum": 200,
"minimum": 1,
"description": "Results per page (max 200)."
}
},
"additionalProperties": false
}Facepunch's Rust updates and devblogs. Every post from rust.facepunch.com/news, newest first. Each carries `slug`, `title`, `summary`, `category` (`devblog`, `news`, `update`, ...), `published_date` (UTC date), `thumbnail_url`, `url` (the official post, or this network's own write-up when `has_blog_post` is true) and `has_blog_post`. Polled every few minutes; the first page is refreshed the moment a new post is found.
| Argument | Type | Description |
|---|---|---|
| page | integer | 1-based page number. |
| per_page | integer | Results per page (max 200). |
{
"type": "object",
"properties": {
"page": {
"type": "integer",
"default": 1,
"minimum": 1,
"description": "1-based page number."
},
"per_page": {
"type": "integer",
"default": 50,
"maximum": 200,
"minimum": 1,
"description": "Results per page (max 200)."
}
},
"additionalProperties": false
}One server in full. Everything the server's page shows except the live player names: the full public record (see `/servers`) read fresh, plus `votes`, `rating` (1-5 average) and `rating_count`, the last ten detected `wipes` (newest first, with the seed/size before and after), `last_wipe_at`, `avg_wipe_cycle_hours` across those wipes, `next_wipe_estimate_at` (last wipe + average cycle; a guess, not a schedule), `next_force_wipe_at` (Rust's monthly forced wipe) and `map_preview` - null until a RustMaps render exists for the server's seed/size, otherwise `image_url`, `thumbnail_url`, `total_monuments`, `monuments` (`{type, x, y}`), `monument_types`, `land_percentage` and the five `biome_*` percentages. Offline servers still resolve; unknown ids are 404. Player-count history is at `/servers/{id}/history`. Aggregates are cached for five minutes.
| Argument | Type | Description |
|---|---|---|
| server_id* | integer | The server's numeric id (from `/servers`, or the number in its servers.rustprofit.com/server/{id} URL). |
{
"type": "object",
"required": [
"server_id"
],
"properties": {
"server_id": {
"type": "integer",
"minimum": 1,
"examples": [
1
],
"description": "The server's numeric id (from `/servers`, or the number in its servers.rustprofit.com/server/{id} URL)."
}
},
"additionalProperties": false
}Player-count history for one server. The per-poll `player_count`/`queued_count` readings behind the server page's 24-hour chart, oldest first, as `points` of `{t, players, queued}`. One reading lands per poll cycle (roughly hourly); when the window holds more than 500 readings they are averaged into equal time buckets (`resolution_seconds`, null when the points are raw) so a response never exceeds 500 points. Also `peak_players`, `avg_players` and `point_count`. A server that has never answered a poll has an empty series. Cached for five minutes.
| Argument | Type | Description |
|---|---|---|
| days | integer | How many days back to return (1-30). Snapshots are pruned nightly to the configured retention window (7 days by default - see `snapshot_retention_days` on `/servers/stats`), so longer ranges come back only as far as the table holds. |
| server_id* | integer | The server's numeric id. |
{
"type": "object",
"required": [
"server_id"
],
"properties": {
"days": {
"type": "integer",
"default": 1,
"maximum": 30,
"minimum": 1,
"examples": [
7
],
"description": "How many days back to return (1-30). Snapshots are pruned nightly to the configured retention window (7 days by default - see `snapshot_retention_days` on `/servers/stats`), so longer ranges come back only as far as the table holds."
},
"server_id": {
"type": "integer",
"minimum": 1,
"examples": [
1
],
"description": "The server's numeric id."
}
},
"additionalProperties": false
}Site-wide totals and data freshness. The headline numbers from the servers.rustprofit.com homepage: `online_servers`, `total_players` and `queued_players` summed across every online server, `tracked_servers` (every row ever discovered, offline included), `steam_global_players` (Rust's concurrent player count from Steam, null if Steam did not answer), `next_force_wipe_at` (the first Thursday of the month at 2 PM US Eastern: 18:00 UTC during US daylight saving time, 19:00 UTC otherwise), the poller's configuration (`poll_interval_seconds` between cycles, `offline_after_seconds` before an unanswering server is marked offline, `snapshot_retention_days` of per-server history kept) and `workers` - the live heartbeat status of the discovery, polling and map-generation jobs, so you can tell how fresh the data is. Includes next_force_wipe_at (Rust's monthly forced wipe).
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": false
}Full skin detail: price, order book, history, cross-market prices. Everything the skin's wiki page shows, as data. `skin` is the full catalogue record (creator, workshop title and dates, collection, flags, store price and availability, crafting components, glow/cutout ratios, colours). `price` is the canonical wiki price in cents and `price_source` says which side of the book it came from. `orderbook` is Steam's live book: lowest sell order, highest buy order, order counts, the `buy_orders` and `sell_orders` depth ladders (`{price, quantity}`, best first) and `fetched_at`; the headline price refreshes more often than the ladders, so they can briefly trail it. `steam_history` is the last year of Steam's own sale history (`recorded_at`, median sale `price`, `volume`; `sale_basis` false means Steam has no sale series and the points are our ask-price readings instead) - wider ranges via /skins/{itemdefid}/history. `market_stats` is the page's Community & Market Stats card: an archived SCMM snapshot (frozen September 2026) of `supply_total`/`supply_total_estimated`/`supply_total_owners_estimated`, Workshop `subscriptions_current`/ `subscriptions_lifetime`, `favourited_current`, `views`, `votes_up`/`votes_down`, `market_24hr_value`, `market_168hr_value`, `market_last_30d_sales`, `market_rank_index`, `market_liquidity_score`, the market high/low with their dates, `change_7d_percent`/`change_30d_percent`/`change_90d_percent` and `ath_percent`; null for skins SCMM never covered. `cros
| Argument | Type | Description |
|---|---|---|
| itemdefid* | integer | The skin's Steam item definition id (also its rust.wiki URL: /skin/{itemdefid}). |
{
"type": "object",
"required": [
"itemdefid"
],
"properties": {
"itemdefid": {
"type": "integer",
"minimum": 1,
"examples": [
10138
],
"description": "The skin's Steam item definition id (also its rust.wiki URL: /skin/{itemdefid})."
}
},
"additionalProperties": false
}One collection with all its skins. The collection's `name`, `slug`, `count`, `total_value` and `avg_value` (cents), `released` (the earliest member's store-acceptance date) and `skins`: every member as `{itemdefid, name, icon_url, rarity, category, price}` ordered by price, highest first. The collection's value-over-time series is GET /market/collection-value. Cached for 30 minutes.
| Argument | Type | Description |
|---|---|---|
| slug* | string | Collection slug (lower-case, hyphenated name), e.g. `forest-raiders`. |
{
"type": "object",
"required": [
"slug"
],
"properties": {
"slug": {
"type": "string",
"examples": [
"forest-raiders"
],
"maxLength": 120,
"description": "Collection slug (lower-case, hyphenated name), e.g. `forest-raiders`."
}
},
"additionalProperties": false
}Full Steam order book for one skin. Steam Community Market's current order book for the skin, straight from our scraper's latest snapshot: `lowest_sell_order` and `highest_buy_order` (cents; null when that side is empty), `sell_order_count` and `buy_order_count`, the COMPLETE `sell_orders` and `buy_orders` depth ladders as `[{price, quantity}, ...]` best price first (every level Steam publishes, not a top-N cut), and `fetched_at`, when the snapshot was taken. The headline ask is refreshed by a market-wide sweep every ~12 minutes; the depth ladders come from the per-item rotation (every few hours), so they can trail it slightly. 404 when the skin has no Steam order book (unmarketable items). Not cached: this is one indexed row.
| Argument | Type | Description |
|---|---|---|
| itemdefid* | integer | The skin's item definition id. |
{
"type": "object",
"required": [
"itemdefid"
],
"properties": {
"itemdefid": {
"type": "integer",
"minimum": 1,
"examples": [
10138
],
"description": "The skin's item definition id."
}
},
"additionalProperties": false
}Live price, order book depth, extremes and 7d/30d change for one skin. The compact price card the rust.wiki Discord bot's /price command shows, as data. All prices are integer USD cents: `price_cents` (the canonical wiki price - Steam's lowest sell order, or the highest buy order when nothing is listed), `ask_cents` and `bid_cents` (the two sides of Steam's book), `sell_orders`/`buy_orders` (how many orders stand on each side), `sell_ladder` and `buy_ladder` (the top five price levels on each side, best first, as `{price, quantity}`), `ath_cents`/`atl_cents` (the skin's all-time high and low from Steam's sale history), `change_7d`/`change_30d` (percent move of today's price against our closest Steam price reading 7 and 30 days back; null without enough history) and `sales_30d` (units sold on Steam in the last 30 days, null when none). Plus `name`, `icon_url`, `market_hash_name` and `category`. Cached for 5 minutes.
| Argument | Type | Description |
|---|---|---|
| itemdefid* | integer | The skin's item definition id. |
{
"type": "object",
"required": [
"itemdefid"
],
"properties": {
"itemdefid": {
"type": "integer",
"minimum": 1,
"examples": [
10138
],
"description": "The skin's item definition id."
}
},
"additionalProperties": false
}Steam sale history for one skin. Steam Community Market's own sale history for the skin, scraped from Steam's listing page: `points` of `{recorded_at, price, volume}` where `price` is Steam's median sale price for that interval in cents and `volume` the number of sales. Steam reports roughly hourly points for the recent month and daily beyond; ranges of a year or more are condensed to one point per day (median price, summed volume). Empty when Steam has no sale series for the item (unmarketable skins). History goes back to the skin's first sale, as far as 2015. Refreshed continuously; the full series is cached for an hour.
| Argument | Type | Description |
|---|---|---|
| range | string | How far back: `1d`, `1w`, `1m`, `3m`, `6m`, `1y`, `2y`, `5y` or `all`. |
| itemdefid* | integer | The skin's item definition id. |
{
"type": "object",
"required": [
"itemdefid"
],
"properties": {
"range": {
"enum": [
"1d",
"1w",
"1m",
"3m",
"6m",
"1y",
"2y",
"5y",
"all"
],
"type": "string",
"default": "1y",
"examples": [
"1y"
],
"description": "How far back: `1d`, `1w`, `1m`, `3m`, `6m`, `1y`, `2y`, `5y` or `all`."
},
"itemdefid": {
"type": "integer",
"minimum": 1,
"examples": [
10138
],
"description": "The skin's item definition id."
}
},
"additionalProperties": false
}One rotation's full item list. One rotation as the wiki's /store/rotation page shows it: `rotation` (`id`, `name`, `start`, `end`, `itemdefid_count` - the number of items that still resolve in the catalogue) and its items split into `limited_time`, `general` and `dlc_packs`, each item in the same shape as GET /store, including today's `market_price` and `is_available_on_store` (a past rotation can still contain evergreen catalogue items). Cached for an hour.
| Argument | Type | Description |
|---|---|---|
| rotation_id* | string | Rotation id from /store/history, e.g. `2017-07-13-2006`, or `General`. |
{
"type": "object",
"required": [
"rotation_id"
],
"properties": {
"rotation_id": {
"type": "string",
"examples": [
"2017-07-13-2006"
],
"maxLength": 40,
"description": "Rotation id from /store/history, e.g. `2017-07-13-2006`, or `General`."
}
},
"additionalProperties": false
}Most populated servers right now. The online servers with the most players right now - the same query behind the rust.wiki Discord bot's `/servers` command - as a compact list: `id`, `name`, `players`, `max_players`, `country` and the server's page `url`. Use `/servers?sort=players` for the full records. Cached for 60 seconds.
| Argument | Type | Description |
|---|---|---|
| limit | integer | How many servers to return (1-50). |
| country | string | Restrict to one ISO 3166-1 alpha-2 country. |
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"default": 10,
"maximum": 50,
"minimum": 1,
"examples": [
10
],
"description": "How many servers to return (1-50)."
},
"country": {
"type": "string",
"pattern": "^[A-Za-z]{2}$",
"examples": [
"US"
],
"maxLength": 2,
"minLength": 2,
"description": "Restrict to one ISO 3166-1 alpha-2 country."
}
},
"additionalProperties": false
}Current Rust Twitch and Kick drops. The live drops campaigns (Twitch and Kick: round, dates, general and streamer drops with the skin each one gives), the most valuable drop skins ever by Steam price, and past rounds - the data behind rust.wiki/drops.
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": false
}Upkeep decay brackets and decay times. Rust's dedicated-server upkeep defaults (the `decay.bracket_*` and `decay.duration_*` ConVars, as most servers run them). `brackets` are applied in order to a base's block count: the first 15 blocks cost 10% of their build cost per day, the next 35 cost 15%, the next 75 cost 20%, and every block beyond 125 costs 33.3% (`blocks` null = unbounded); a base's blended daily rate is the block-weighted average of the brackets it fills, paid in the resources each piece was built from. `decay_hours` is how long an unmaintained piece of each grade takes to decay completely. Fixed constants, no computation happens server-side.
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": false
}One world entity with its loot. The entity's `slug`, `display_name`, `is_npc`, `npc_hp`, `icon_url` and `loot_source_id` (null when it drops nothing), plus `drops` - its five likeliest drops (`shortname`, `display_name`, `icon_url`, `chance_pct`, `amount_min`, `amount_max`) - and `drop_count`, the full number of distinct drops. The complete table is `/loot-tables/{loot_source_id}`. Cached for one hour.
| Argument | Type | Description |
|---|---|---|
| slug* | string | Entity slug from `/world`, e.g. `bear`. |
{
"type": "object",
"required": [
"slug"
],
"properties": {
"slug": {
"type": "string",
"examples": [
"bear"
],
"maxLength": 80,
"minLength": 1,
"description": "Entity slug from `/world`, e.g. `bear`."
}
},
"additionalProperties": false
}Dates with a saved daily snapshot. Every date (newest first, up to 400) on which a daily snapshot of this inventory was stored, plus `totals`: each of those days' total value in cents (that day's holdings at that day's prices). Snapshots are written when an inventory is looked up; fetch one with /inventory/{steamid}/snapshots/{date}. No key needed. Only inventories someone has looked up have snapshots. `totals` gives each saved day's total value (that day's holdings at that day's prices).
| Argument | Type | Description |
|---|---|---|
| steamid* | string | 17-digit SteamID64. |
{
"type": "object",
"required": [
"steamid"
],
"properties": {
"steamid": {
"type": "string",
"examples": [
"76561198869732295"
],
"description": "17-digit SteamID64."
}
},
"additionalProperties": false
}Every loot source (crates, NPCs, barrels). One page of loot sources, alphabetical. Each carries `id`, `name` (Facepunch's own loot-table name, e.g. `Elite Tier Crate`), `drop_count` (how many distinct items it can drop) and `icons` (the icons of its four likeliest drops). Fetch the full drop table with `/loot-tables/{id}`. Cached for 30 minutes.
| Argument | Type | Description |
|---|---|---|
| page | integer | 1-based page number. |
| per_page | integer | Results per page (max 200). |
{
"type": "object",
"properties": {
"page": {
"type": "integer",
"default": 1,
"minimum": 1,
"description": "1-based page number."
},
"per_page": {
"type": "integer",
"default": 50,
"maximum": 200,
"minimum": 1,
"description": "Results per page (max 200)."
}
},
"additionalProperties": false
}All 60 fixed monuments. Every fixed-location monument, alphabetical, in one response (no pagination - the set is 60 and static). Each carries `slug`, `name`, `tier` (1-3, null for safe zones and minor monuments), `is_safezone`, `has_radiation` and `radiation_level`, `recyclers` (count on site), `has_tunnel_entrance` (underground rail), `has_chinook_drop_zone`, `allows_patrol_heli_crash`, `no_build_area_sqm` and `icon_url`. Moving monuments (Cargo Ship) are not included. Cached for one hour.
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": false
}Skin collections with counts and values. Every skin collection (about 750, e.g. `Forest Raiders`, `Abyss`): `name`, `count` (members), `total_value` and `avg_value` (cents, over the priced members only; null when nothing in it is priced) and `icons`, one `{url, name}` per member skin. The collection's URL slug is its lower-cased name with non-alphanumerics collapsed to `-` (`Forest Raiders` -> `forest-raiders`), which is what GET /skins/collections/{slug} takes. Cached for 30 minutes.
| Argument | Type | Description |
|---|---|---|
| page | integer | 1-based page number. |
| sort | string | `value_*` sorts by the summed wiki price of the collection's skins, `count_*` by member count. |
| per_page | integer | Results per page (max 200). |
{
"type": "object",
"properties": {
"page": {
"type": "integer",
"default": 1,
"minimum": 1,
"description": "1-based page number."
},
"sort": {
"enum": [
"value_desc",
"value_asc",
"count_desc",
"count_asc",
"name"
],
"type": "string",
"default": "value_desc",
"examples": [
"value_desc"
],
"description": "`value_*` sorts by the summed wiki price of the collection's skins, `count_*` by member count."
},
"per_page": {
"type": "integer",
"default": 50,
"maximum": 200,
"minimum": 1,
"description": "Results per page (max 200)."
}
},
"additionalProperties": false
}Resolve a profile URL or vanity name to a SteamID64. Turns any of the accepted identifier forms into a 17-digit SteamID64. Does not fetch the profile. Turn a steamcommunity.com/id/... or /profiles/... link, or a custom URL name, into the SteamID64 the inventory and player tools need.
| Argument | Type | Description |
|---|---|---|
| q* | string | A steamcommunity.com profile URL, a custom URL name, or a SteamID64. |
{
"type": "object",
"required": [
"q"
],
"properties": {
"q": {
"type": "string",
"examples": [
"https://steamcommunity.com/id/willjum"
],
"maxLength": 200,
"minLength": 1,
"description": "A steamcommunity.com profile URL, a custom URL name, or a SteamID64."
}
},
"additionalProperties": false
}Console and server commands. One page of Rust console/server commands, alphabetical. Each carries `command`, `syntax`, `description`, `category` (Rust's own ConVar namespace, e.g. `server`, `gather`), `command_type` (`command` or `variable`), `default_value` (variables only) and `permission_required` (null when any player can run it). Cached for 30 minutes.
| Argument | Type | Description |
|---|---|---|
| page | integer | 1-based page number. |
| search | string | Case-insensitive substring match on the command name, its description OR its category (so `workbench` finds every workbench ConVar). |
| per_page | integer | Results per page (max 200). |
| admin_only | boolean | `true` = only commands that need admin/moderator permission. |
{
"type": "object",
"properties": {
"page": {
"type": "integer",
"default": 1,
"minimum": 1,
"description": "1-based page number."
},
"search": {
"type": "string",
"examples": [
"gather"
],
"maxLength": 80,
"minLength": 1,
"description": "Case-insensitive substring match on the command name, its description OR its category (so `workbench` finds every workbench ConVar)."
},
"per_page": {
"type": "integer",
"default": 50,
"maximum": 200,
"minimum": 1,
"description": "Results per page (max 200)."
},
"admin_only": {
"type": "boolean",
"default": false,
"description": "`true` = only commands that need admin/moderator permission."
}
},
"additionalProperties": false
}Search the RustProfit blog's Rust guides. Published guides from blog.rustprofit.com (monuments, recyclers, farming, base building, raiding, gear, NPCs, wipes, update explainers), best match first: every word must appear somewhere in the guide, and title matches rank above summary and tag matches, which rank above body-text matches. Link the `url` when citing one. Rust how-to guides from blog.rustprofit.com; cite and link the url.
| Argument | Type | Description |
|---|---|---|
| q* | string | Words to find in guide titles, summaries, tags and text. |
| limit | integer | Most results to return. |
{
"type": "object",
"required": [
"q"
],
"properties": {
"q": {
"type": "string",
"examples": [
"recycler locations"
],
"maxLength": 100,
"minLength": 2,
"description": "Words to find in guide titles, summaries, tags and text."
},
"limit": {
"type": "integer",
"default": 5,
"maximum": 20,
"minimum": 1,
"description": "Most results to return."
}
},
"additionalProperties": false
}Item name / shortname typeahead. Up to 25 live items matching `q`, best match first: a case-insensitive substring match on the display name OR the shortname, plus trigram similarity on the display name so typos still resolve (`asault` finds the Assault Rifle) - the same ILIKE + similarity search the site's item pickers use. Each result is `{shortname, display_name, category, icon_url}`; use the shortname with `/items/{shortname}`. For filtered, paginated results use `/items?search=` instead. Cached for 5 minutes per query.
| Argument | Type | Description |
|---|---|---|
| q* | string | Part of an item's display name or shortname (2+ characters). |
{
"type": "object",
"required": [
"q"
],
"properties": {
"q": {
"type": "string",
"examples": [
"assault"
],
"maxLength": 80,
"minLength": 2,
"description": "Part of an item's display name or shortname (2+ characters)."
}
},
"additionalProperties": false
}Browse, filter and search the server list. One page of servers with the same filters, ordering and five-minute cache as the servers.rustprofit.com list and its hub pages (/country/de, /vanilla, /solo, /gather/2x ...). Each result is the full public server record: identity and connect details (`ip`, `game_port`, `query_port`, `connect` as a `steam://` URI), `map`, `world_seed`, `world_size`, `country`/`country_name`, live `current_players`/`max_players`/`queued_players`, the `kind` (official/modded/vanilla) and `is_*` flags, `password_protected`, `vac_enabled`, `gather_rate` with its `gather_bucket`, `group_limit` with its `group` label, `tags`, owner-supplied `description` (first 500 characters), `banner_url`, `website_url`, `discord_url`, `first_seen_at`/`last_seen_at`/`last_polled_at`, the aggregates `votes`, `rating` (1-5 average, null when unrated) and `last_wipe_at`, and the server's page `url` plus embeddable `widget_url`/`badge_url`. Ties in every sort are broken by `id` so pages never overlap.
| Argument | Type | Description |
|---|---|---|
| kind | string | `vanilla` = not modded; `modded` = reports a modded flag over A2S; `official` = a Facepunch-run public server (by name convention). |
| page | integer | 1-based page number. |
| sort | string | `players` = most players online first (default); `votes` = most community votes; `rating` = highest average rating; `wiped` = most recently wiped; `name` = alphabetical. |
| biome | string | Only servers whose generated map preview is mostly this biome (its percentage is the highest of the five). |
Skin name typeahead. Up to 10 skins whose name matches `q`, best match first (the same ILIKE + trigram search the site's search boxes use). Each result is `{itemdefid, name, icon_url}`; use the `itemdefid` with the other skin endpoints. For filtered, paginated results use GET /skins with `search=` instead.
| Argument | Type | Description |
|---|---|---|
| q* | string | Part of a skin name (2+ characters). |
{
"type": "object",
"required": [
"q"
],
"properties": {
"q": {
"type": "string",
"examples": [
"tempered"
],
"maxLength": 100,
"minLength": 2,
"description": "Part of a skin name (2+ characters)."
}
},
"additionalProperties": false
}Browse or search Workshop submissions. One page of submissions. Each carries `workshopid` (the Steam published-file id), `title`, `author_steamid64`, `preview_image_url`, `submitted_at` (UTC ISO-8601, may be null), `accepted` and `accepted_itemdefid` (the in-game item definition id when Facepunch accepted it - use it with `/skins/{itemdefid}`), `target_item_tag`, `subscriptions` and `vote_score` (Steam's 0-1 score; both null when Steam has not reported them). Same filters, ordering and cache as the /workshop page.
| Argument | Type | Description |
|---|---|---|
| page | integer | 1-based page number. |
| sort | string | `newest` = most recently submitted first; `popular` = most subscribers first. |
| search | string | Case-insensitive substring match on the submission title. |
| target | string | Only submissions for this target item, exactly as the Workshop tags it (e.g. `AK47`, `Garage Door`); `/workshop/targets` lists every value. |
| accepted | string | `yes` = only submissions Facepunch accepted into the game; `no` = only ones it has not. |
| per_page | integer | Results per page (max 200). |
{
"type": "object",
"properties": {
"page": {
"type": "integer",
"default": 1,
"minimum": 1,
"description": "1-based page number."
},
"sort": {
"enum": [
"newest",
"popular"
],
"type": "string",
"default": "newest",
"description": "`newest` = most recently submitted first; `popular` = most subscribers first."
},
"search": {
"type": "string",
"examples": [
"dragon"
],
"maxLength": 120,
"minLength": 1,
"description": "Case-insensitive substring match on the submission title."
},
"target": {
"type": "string",
"examples": [
"AK47"
],
"maxLength": 80,
"minLength": 1,
"description": "Only submissions for this target item, exactly as the Workshop tags it (e.g. `AK47`, `Garage Door`); `/workshop/targets` lists every value."
},
"accepted": {
"enum": [
"any",
"yes",
"no"
],
"type": "string",
"default": "any",
"description": "`yes` = only submissions Facepunch accepted into the game; `no` = only ones it has not."
},
"per_page": {
"type": "integer",
"default": 50,
"maximum": 200,
"minimum": 1,
"description": "Results per page (max 200)."
}
},
"additionalProperties": false
}World entities: animals, NPCs, resource nodes. One page of world entities (anything not tied to one monument), alphabetical. Each carries `slug`, `display_name`, `is_npc`, `npc_hp` (null for resources) and `icon_url`. Cached for one hour.
| Argument | Type | Description |
|---|---|---|
| kind | string | `npc` = anything with hit points (animals, scientists, bosses, vehicles); `resource` = nodes, trees, barrels and other harvestables. |
| page | integer | 1-based page number. |
| search | string | Case-insensitive substring match on the display name. |
| per_page | integer | Results per page (max 200). |
{
"type": "object",
"properties": {
"kind": {
"enum": [
"npc",
"resource"
],
"type": "string",
"examples": [
"npc"
],
"description": "`npc` = anything with hit points (animals, scientists, bosses, vehicles); `resource` = nodes, trees, barrels and other harvestables."
},
"page": {
"type": "integer",
"default": 1,
"minimum": 1,
"description": "1-based page number."
},
"search": {
"type": "string",
"examples": [
"scientist"
],
"maxLength": 80,
"minLength": 1,
"description": "Case-insensitive substring match on the display name."
},
"per_page": {
"type": "integer",
"default": 50,
"maximum": 200,
"minimum": 1,
"description": "Results per page (max 200)."
}
},
"additionalProperties": false
}| creator | string | Workshop creator: a 17-digit SteamID64 for an exact match, or part of the creator's display name. |
| category | string | Skin category. |
| min_subs | string | Minimum Steam Workshop subscriber count of the skin's original submission. |
| per_page | integer | Results per page (max 200). |
| released | string | Year the skin was accepted into the item store. |
| tradable | boolean | Only tradable skins. |
| breakable | boolean | Only skins with a recycle yield (`recycle_hint`). |
| commodity | boolean | Only Steam commodity items. |
| permanent | boolean | Only permanent store items. |
| collection | string | Exact collection name, e.g. `Forest Raiders` (see /skins/collections). |
| hide_drops | boolean | Hide loot-crate drops, publisher drops and Twitch drops (what the site calls DLCs and drops). |
| marketable | boolean | Only Steam-marketable skins. |
| limited_time | boolean | Only limited-time store items. |
{
"type": "object",
"properties": {
"item": {
"type": "string",
"maxLength": 80,
"description": "Base item shortname, e.g. `rifle.ak` - every skin of that one item."
},
"page": {
"type": "integer",
"default": 1,
"minimum": 1,
"description": "1-based page number."
},
"sort": {
"enum": [
"price_desc",
"price_asc",
"name",
"popularity",
"supply_asc",
"released_desc",
"released_asc",
"trending",
"marketcap_desc"
],
"type": "string",
"default": "price_desc",
"examples": [
"price_desc"
],
"description": "Ordering. `popularity` and `supply_asc` use Workshop subscribers; `trending` is the 7-day price change; `marketcap_desc` is price x subscribers."
},
"color": {
"enum": [
"red",
"orange",
"yellow",
"green",
"cyan",
"blue",
"purple",
"pink",
"brown",
"white",
"gray",
"black",
"tan",
"olive",
"navy",
"maroon",
"silver"
],
"type": "string",
"description": "Dominant icon colour bucket; matches any of a skin's up to five dominant colours."
},
"glows": {
"type": "boolean",
"default": false,
"description": "Only skins with glow-in-the-dark elements."
},
"search": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Fuzzy name search (trigram similarity; with sort=name results are relevance-ordered). Searches are never cached server-side."
},
"creator": {
"type": "string",
"maxLength": 100,
"description": "Workshop creator: a 17-digit SteamID64 for an exact match, or part of the creator's display name."
},
"category": {
"enum": [
"weapon",
"clothing",
"deployable",
"decoration",
"crate",
"resource",
"mask",
"none"
],
"type": "string",
"examples": [
"weapon"
],
"description": "Skin category."
},
"min_subs": {
"enum": [
"1000",
"5000",
"10000",
"25000",
"50000"
],
"type": "string",
"description": "Minimum Steam Workshop subscriber count of the skin's original submission."
},
"per_page": {
"type": "integer",
"default": 50,
"maximum": 200,
"minimum": 1,
"description": "Results per page (max 200)."
},
"released": {
"enum": [
"2026",
"2025",
"2024",
"2023",
"2022",
"2021",
"2020",
"2019",
"2018",
"2017",
"2016",
"2015"
],
"type": "string",
"description": "Year the skin was accepted into the item store."
},
"tradable": {
"type": "boolean",
"default": false,
"description": "Only tradable skins."
},
"breakable": {
"type": "boolean",
"default": false,
"description": "Only skins with a recycle yield (`recycle_hint`)."
},
"commodity": {
"type": "boolean",
"default": false,
"description": "Only Steam commodity items."
},
"permanent": {
"type": "boolean",
"default": false,
"description": "Only permanent store items."
},
"collection": {
"type": "string",
"maxLength": 120,
"description": "Exact collection name, e.g. `Forest Raiders` (see /skins/collections)."
},
"hide_drops": {
"type": "boolean",
"default": false,
"description": "Hide loot-crate drops, publisher drops and Twitch drops (what the site calls DLCs and drops)."
},
"marketable": {
"type": "boolean",
"default": false,
"description": "Only Steam-marketable skins."
},
"limited_time": {
"type": "boolean",
"default": false,
"description": "Only limited-time store items."
}
},
"additionalProperties": false
}| string |
| Custom range start (YYYY-MM-DD, inclusive). Only read when range=custom. |
| index_weight_mode | string | Weighting for any `index:` entries (see /market/index). |
{
"type": "object",
"required": [
"entries"
],
"properties": {
"range": {
"enum": [
"7d",
"30d",
"90d",
"1y",
"2y",
"3y",
"4y",
"5y",
"all",
"custom"
],
"type": "string",
"default": "90d",
"examples": [
"90d"
],
"description": "Window: `7d`, `30d`, `90d`, `1y`, `2y`, `3y`, `4y`, `5y`, `all`, or `custom` with `start_date`/`end_date`. Spans over two years are downsampled to one point per week."
},
"smooth": {
"type": "boolean",
"default": false,
"description": "Apply a trailing 30-day moving average."
},
"entries": {
"type": "string",
"examples": [
"10337,10148,category:weapon"
],
"maxLength": 400,
"minLength": 1,
"description": "Comma-separated, up to 8: an `itemdefid` (that skin's price), `category:weapon` / `collection:Forest Raiders` / `item:shoes.boots` (the basket's average price) or `index:all` / `index:category:weapon` / `index:custom:123.456` (an index entry; custom ids joined with `.`)."
},
"end_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Custom range end (YYYY-MM-DD, inclusive). Only read when range=custom."
},
"trim_days": {
"type": "integer",
"default": 0,
"maximum": 90,
"minimum": 0,
"description": "Mask each constituent's first N days of history (0-90) to drop launch-week volatility."
},
"start_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Custom range start (YYYY-MM-DD, inclusive). Only read when range=custom."
},
"index_weight_mode": {
"enum": [
"equal",
"marketcap"
],
"type": "string",
"default": "equal",
"description": "Weighting for any `index:` entries (see /market/index)."
}
},
"additionalProperties": false
}| min_price | integer | Minimum buy price in cents. |
| steam_ref | string | Steam exit price: `buy` = sell instantly into the highest buy order (default), `sell` = list just under the lowest sell order. |
| marketplace | array | Only deals whose cheapest listing is on one of these marketplaces (repeat the parameter). |
{
"type": "object",
"properties": {
"page": {
"type": "integer",
"default": 1,
"minimum": 1,
"description": "1-based page number."
},
"sort": {
"enum": [
"pct",
"abs"
],
"type": "string",
"default": "pct",
"examples": [
"pct"
],
"description": "Best `pct` (spread as % of buy price) or `abs` (spread in cents) first."
},
"search": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Case-insensitive substring of the skin name (or Steam market name)."
},
"category": {
"enum": [
"weapon",
"clothing",
"deployable",
"decoration",
"crate",
"resource",
"mask",
"none"
],
"type": "string",
"description": "Only skins of this category."
},
"per_page": {
"type": "integer",
"default": 50,
"maximum": 200,
"minimum": 1,
"description": "Results per page (max 200)."
},
"max_price": {
"type": "integer",
"minimum": 0,
"description": "Maximum buy price in cents."
},
"min_price": {
"type": "integer",
"minimum": 0,
"description": "Minimum buy price in cents."
},
"steam_ref": {
"enum": [
"buy",
"sell"
],
"type": "string",
"default": "buy",
"examples": [
"buy"
],
"description": "Steam exit price: `buy` = sell instantly into the highest buy order (default), `sell` = list just under the lowest sell order."
},
"marketplace": {
"type": "array",
"items": {
"enum": [
"Skinport",
"CSDealsMarketplace",
"DMarket",
"RustTM",
"CSTrade",
"Waxpeer",
"LISSkins",
"ManncoStore",
"SwapGGTrade",
"TradeitGG",
"RapidSkins",
"LootFarm",
"RustSkins"
],
"type": "string"
},
"default": [],
"description": "Only deals whose cheapest listing is on one of these marketplaces (repeat the parameter)."
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"steamid"
],
"properties": {
"range": {
"type": "string",
"default": "1y",
"description": "7d, 30d, 90d, 1y, 2y, 3y, 4y, 5y, all, or custom (with start_date/end_date)."
},
"steamid": {
"type": "string",
"examples": [
"76561198869732295"
],
"description": "17-digit SteamID64."
},
"end_date": {
"type": "string",
"description": "YYYY-MM-DD, with range=custom."
},
"interval": {
"type": "string",
"default": "auto",
"description": "daily, weekly, monthly, or auto (daily up to 400 points, then weekly, then monthly past 400 weeks)."
},
"start_date": {
"type": "string",
"description": "YYYY-MM-DD, with range=custom."
}
},
"additionalProperties": false
}| weight_mode | string | `equal`: every constituent's % move counts the same. `marketcap`: weighted by price x Workshop subscribers, like an S&P-style index. |
| basket_value | string | The category, collection name, colour, item shortname, or for `custom` a comma-separated list of up to 300 itemdefids. Ignored for all/high_value/low_value. |
{
"type": "object",
"properties": {
"range": {
"enum": [
"7d",
"30d",
"90d",
"1y",
"2y",
"3y",
"4y",
"5y",
"all",
"custom"
],
"type": "string",
"default": "90d",
"examples": [
"90d"
],
"description": "Window: `7d`, `30d`, `90d`, `1y`, `2y`, `3y`, `4y`, `5y`, `all`, or `custom` with `start_date`/`end_date`. Spans over two years are downsampled to one point per week."
},
"smooth": {
"type": "boolean",
"default": false,
"description": "Apply a trailing 30-day moving average."
},
"end_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Custom range end (YYYY-MM-DD, inclusive). Only read when range=custom."
},
"trim_days": {
"type": "integer",
"default": 0,
"maximum": 90,
"minimum": 0,
"description": "Mask each constituent's first N days of history (0-90) to drop launch-week volatility."
},
"start_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Custom range start (YYYY-MM-DD, inclusive). Only read when range=custom."
},
"basket_type": {
"enum": [
"all",
"high_value",
"low_value",
"category",
"collection",
"color",
"item",
"custom"
],
"type": "string",
"default": "all",
"examples": [
"category"
],
"description": "Which skins form the index: `all`, `high_value`/`low_value` (300 priciest/cheapest), `category`, `collection`, `color`, `item` (one base item's skins) or `custom` (your own list)."
},
"weight_mode": {
"enum": [
"equal",
"marketcap"
],
"type": "string",
"default": "equal",
"description": "`equal`: every constituent's % move counts the same. `marketcap`: weighted by price x Workshop subscribers, like an S&P-style index."
},
"basket_value": {
"type": "string",
"examples": [
"weapon"
],
"maxLength": 2000,
"description": "The category, collection name, colour, item shortname, or for `custom` a comma-separated list of up to 300 itemdefids. Ignored for all/high_value/low_value."
}
},
"additionalProperties": false
}| group |
| string |
| Team-size cap: `solo` (1), `duo` (2) or `trio` (3). Only servers whose cap is known match. |
| gather | string | Gather-rate bucket parsed from the server name: `2x` (2-2.99), `3x` (3-4.99), `5x` (5-9.99) or `10x` (10 and above). Servers with no `Nx` in their name never match. |
| online | boolean | `true` (default) = only servers that were online at their last poll; `false` = only servers currently marked offline. |
| search | string | Case-insensitive substring match on the server name. |
| country | string | ISO 3166-1 alpha-2 country the server is hosted in (GeoIP of its address); `/servers/countries` lists the values in use. |
| monument | string | Only servers whose current map (when a preview has been generated) contains this monument type, exactly as `/servers/monument-types` lists it. |
| per_page | integer | Results per page (max 200). |
| min_rating | number | Only servers whose average community rating (1-5) is at least this. |
| min_players | integer | Only servers with at least this many players online right now. |
{
"type": "object",
"properties": {
"kind": {
"enum": [
"vanilla",
"modded",
"official"
],
"type": "string",
"examples": [
"vanilla"
],
"description": "`vanilla` = not modded; `modded` = reports a modded flag over A2S; `official` = a Facepunch-run public server (by name convention)."
},
"page": {
"type": "integer",
"default": 1,
"minimum": 1,
"description": "1-based page number."
},
"sort": {
"enum": [
"players",
"votes",
"rating",
"wiped",
"name"
],
"type": "string",
"default": "players",
"examples": [
"players"
],
"description": "`players` = most players online first (default); `votes` = most community votes; `rating` = highest average rating; `wiped` = most recently wiped; `name` = alphabetical."
},
"biome": {
"enum": [
"snow",
"desert",
"forest",
"tundra",
"jungle"
],
"type": "string",
"examples": [
"snow"
],
"description": "Only servers whose generated map preview is mostly this biome (its percentage is the highest of the five)."
},
"group": {
"enum": [
"solo",
"duo",
"trio"
],
"type": "string",
"examples": [
"solo"
],
"description": "Team-size cap: `solo` (1), `duo` (2) or `trio` (3). Only servers whose cap is known match."
},
"gather": {
"enum": [
"2x",
"3x",
"5x",
"10x"
],
"type": "string",
"examples": [
"2x"
],
"description": "Gather-rate bucket parsed from the server name: `2x` (2-2.99), `3x` (3-4.99), `5x` (5-9.99) or `10x` (10 and above). Servers with no `Nx` in their name never match."
},
"online": {
"type": "boolean",
"default": true,
"description": "`true` (default) = only servers that were online at their last poll; `false` = only servers currently marked offline."
},
"search": {
"type": "string",
"examples": [
"rustoria"
],
"maxLength": 120,
"minLength": 1,
"description": "Case-insensitive substring match on the server name."
},
"country": {
"type": "string",
"pattern": "^[A-Za-z]{2}$",
"examples": [
"DE"
],
"maxLength": 2,
"minLength": 2,
"description": "ISO 3166-1 alpha-2 country the server is hosted in (GeoIP of its address); `/servers/countries` lists the values in use."
},
"monument": {
"type": "string",
"examples": [
"Launch Site"
],
"maxLength": 80,
"minLength": 1,
"description": "Only servers whose current map (when a preview has been generated) contains this monument type, exactly as `/servers/monument-types` lists it."
},
"per_page": {
"type": "integer",
"default": 50,
"maximum": 200,
"minimum": 1,
"description": "Results per page (max 200)."
},
"min_rating": {
"type": "number",
"maximum": 5,
"minimum": 1,
"examples": [
4
],
"description": "Only servers whose average community rating (1-5) is at least this."
},
"min_players": {
"type": "integer",
"maximum": 10000,
"minimum": 1,
"examples": [
50
],
"description": "Only servers with at least this many players online right now."
}
},
"additionalProperties": false
}