Collections - SkyTools API

All API requests require an X-API-Key header. Get your key from the Developer Dashboard.

curl -H "X-API-Key: sk_your_key_here" \
  "https://api.skytools.app/v1/..."

See Authentication for details on key formats and tier limits.

GET /v1/collections

Returns all SkyBlock collections organized by category, with tier requirements and unlock rewards. Cache: 1 hour

Query parameters

None.

Examples

curl -H "X-API-Key: sk_your_key_here" \
  "https://api.skytools.app/v1/collections"

const response = await fetch("https://api.skytools.app/v1/collections", {
  headers: { "X-API-Key": "sk_your_key_here" },
});
const { data } = await response.json();

// List all farming collection items
const farming = data.collections["FARMING"];
console.log(Object.keys(farming.items));

import requests

response = requests.get(
    "https://api.skytools.app/v1/collections",
    headers={"X-API-Key": "sk_your_key_here"},
)
collections = response.json()["data"]["collections"]

# List farming categories
for item_id, item in collections["FARMING"]["items"].items():
    print(f"{item['name']}: {item['maxTiers']} tiers")

Response

{
  "success": true,
  "data": {
    "collections": {
      "FARMING": {
        "name": "Farming",
        "items": {
          "WHEAT": {
            "name": "Wheat",
            "maxTiers": 9,
            "tiers": [
              { "tier": 1, "amountRequired": 50, "unlocks": ["Wheat Minion I"] },
              { "tier": 2, "amountRequired": 100, "unlocks": ["Enchanted Book (Harvesting V)"] }
            ]
          }
        }
      },
      "MINING": { ... },
      "COMBAT": { ... },
      "FORAGING": { ... },
      "FISHING": { ... }
    }
  },
  "meta": { "cached": true, "api_version": "v1" }
}

Field	Type	Description
`collections`	object	Map of category name to category data
`collections[category].name`	string	Display name of the category
`collections[category].items`	object	Map of item ID to collection data
`items[id].name`	string	Display name
`items[id].maxTiers`	integer	Total number of collection tiers
`items[id].tiers`	array	Tier details
`tiers[].tier`	integer	Tier number
`tiers[].amountRequired`	integer	Items needed to reach this tier
`tiers[].unlocks`	array	Recipes/rewards unlocked at this tier