AstralMC APIstore.astralmc.cc ↗
Retrieve AstralMC's current top donator username and 5 most recent payment usernames from the Minecraft server store via a single API endpoint.
What is the AstralMC API?
The AstralMC Store API exposes 2 response fields from the AstralMC Minecraft server store via a single get_store_info endpoint: the current monthly top donator username and an ordered array of the 5 most recent payment usernames. No input parameters are required. The data reflects the live state of the store homepage, making it straightforward to display donation activity in dashboards, bots, or community tools.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/b6fb090d-5a07-47bc-86ac-60c64610cec3/get_store_info' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace store-astralmc-cc-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: AstralMC Store SDK — bounded, re-runnable; every call capped."""
from parse_apis.store_astralmc_cc_api import AstralMC, ParseError
client = AstralMC()
# Fetch current store info: top donator and recent payments
try:
info = client.store_infos.get()
print("Top donator:", info.top_donator)
for username in info.recent_payments:
print(" Recent payment:", username)
except ParseError as e:
print(f"Error: {e}")
print("exercised: store_infos.get")
Returns the current top donator username (the player who paid the most this month) and the 5 most recent payment usernames. Data is extracted from the store homepage and reflects live state.
No input parameters required.
{
"type": "object",
"fields": {
"top_donator": "username of the current top donator",
"recent_payments": "array of the 5 most recent payment usernames in reverse chronological order"
},
"sample": {
"data": {
"top_donator": "Kinted",
"recent_payments": [
"CatGirlGab",
"Kingslayer_M",
"Jeremy_Knutson",
"Kinted",
"Kinted"
]
},
"status": "success"
}
}About the AstralMC API
What the API Returns
The get_store_info endpoint returns two fields. top_donator is a single username string identifying the player who has contributed the most to the AstralMC store in the current month. recent_payments is an array of exactly 5 usernames listed in reverse chronological order — most recent purchase first — representing the latest players who completed a transaction on the store.
Endpoint Details
get_store_info takes no input parameters. Every call returns the same structure: a top_donator string and a recent_payments array. The data reflects the current live state of the store homepage, so values will change as new purchases are made or the monthly top-donator ranking updates.
Coverage and Scope
The API covers the AstralMC store at store.astralmc.cc. It surfaces only usernames — no purchase amounts, item names, transaction timestamps, or player UUIDs are included in the current response shape. The recent_payments list is fixed at 5 entries; there is no pagination or configurable limit parameter.
The AstralMC API is a managed, monitored endpoint for store.astralmc.cc — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when store.astralmc.cc changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official store.astralmc.cc API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Display the current AstralMC monthly top donator on a server website or community leaderboard using the
top_donatorfield. - Power a Discord bot command that announces the 5 most recent store purchasers from
recent_payments. - Trigger in-game announcements or rewards when a new username appears at the top of the
recent_paymentsarray. - Track month-over-month top donator history by polling
top_donatoron a schedule and storing results. - Build a community recognition widget that highlights recent supporters pulled from
recent_payments. - Monitor store activity levels by polling
get_store_infoand alerting when the recent payments list changes.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does AstralMC have an official developer API for its store?+
What exactly does the `recent_payments` field contain?+
Does the API include purchase amounts or item names?+
top_donator and the 5 entries in recent_payments. Purchase amounts, item names, and transaction timestamps are not included. You can fork this API on Parse and revise it to add those fields if the source exposes them.