Leagueoflegends APIriftbound.leagueoflegends.com ↗
Access all Riftbound TCG cards with stats including energy cost, power, might, effect text, and collector number. Filter by set or card name.
What is the Leagueoflegends API?
The Riftbound card gallery API exposes 8 fields per card — name, set, effect text, energy cost, power, might, collector number, and public code — across the full Riftbound TCG card catalog from the official League of Legends card game. The single get_cards endpoint supports filtering by set name (e.g. Unleashed, Origins, Spiritforged, Proving Grounds) and partial card name matching, making it straightforward to query subsets of the collection.
curl -X GET 'https://api.parse.bot/scraper/54a64552-51ed-4c8d-8e7e-90c48842cfce/get_cards?set=Origins&name=Adaptatron&limit=5' \ -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 riftbound-leagueoflegends-com-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: Riftbound Card Gallery SDK — browse and filter TCG cards."""
from parse_apis.riftbound_card_gallery_api import Riftbound, Set, CardNotFound
client = Riftbound()
# List cards from a specific set, capped at 5 total items.
for card in client.cards.list(set_name=Set.ORIGINS, limit=5):
print(card.name, card.energy_cost, card.collector_number)
# Search by card name substring and take the first match.
card = client.cards.list(card_name="Adaptatron", limit=1).first()
if card:
print(card.name, card.set, card.effect[:60], card.power, card.might)
# Typed error handling around a filtered list call.
try:
result = client.cards.list(set_name=Set.SPIRITFORGED, limit=3).first()
if result:
print(result.name, result.public_code)
except CardNotFound as exc:
print(f"No cards found: {exc}")
print("exercised: cards.list (by set, by name, with limit, first())")
Get all Riftbound TCG cards with their stats. Returns card name, set, effect text, energy cost, power, might, and collector number. Supports filtering by set name and card name with partial matching, and limiting the number of results returned. When no filters are provided, returns all cards in the gallery. Pagination is not supported — the full matching set is returned in one response.
| Param | Type | Description |
|---|---|---|
| set | string | Filter by set name using partial match (case-insensitive). Known sets: 'Unleashed', 'Origins', 'Spiritforged', 'Proving Grounds'. |
| name | string | Filter by card name using partial match (case-insensitive). |
| limit | integer | Maximum number of cards to return. 0 returns all matching cards. |
{
"type": "object",
"fields": {
"cards": "array of card objects with name, set, effect, energy_cost, power, might, collector_number, and public_code",
"total": "integer - number of cards returned in this response"
},
"sample": {
"data": {
"cards": [
{
"set": "Origins",
"name": "Adaptatron",
"might": 3,
"power": null,
"effect": "When I conquer, you may kill a gear. If you do, buff me. (If I don't have a buff, I get a +1 :rb_might: buff.)",
"energy_cost": 4,
"public_code": "OGN-056/298",
"collector_number": 56
}
],
"total": 1
},
"status": "success"
}
}About the Leagueoflegends API
What the API Returns
The get_cards endpoint returns an array of card objects, each containing: name, set, effect (the card's rule or flavor text), energy_cost, power, might, collector_number, and public_code. The total field in the response indicates how many cards matched the query. All four known Riftbound sets — Unleashed, Origins, Spiritforged, and Proving Grounds — are covered.
Filtering and Pagination
The set parameter accepts a partial string match against the set name, so passing "Origin" will match the Origins set. The name parameter performs a case-insensitive partial match against card names, useful for finding all cards sharing a champion name or keyword. The limit parameter controls how many results are returned; passing 0 returns the full matching set with no cap. There is no offset or cursor parameter, so pagination beyond a single capped response requires client-side handling.
Card Stats Explained
Each card object exposes three numeric gameplay stats: energy_cost (the resource required to play the card), power (the card's attack or base strength value), and might (a secondary stat likely tied to toughness or special ability scaling). The collector_number and public_code fields are useful for referencing specific printings or linking to card imagery in external tools.
The Leagueoflegends API is a managed, monitored endpoint for riftbound.leagueoflegends.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when riftbound.leagueoflegends.com 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 riftbound.leagueoflegends.com 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?+
- Build a searchable Riftbound deck-builder app using energy_cost, power, and might to filter playable cards
- Generate set-by-set card checklists using the set and collector_number fields
- Track card effect text to identify keyword synergies across a given set
- Populate a card database for a Riftbound fan site or wiki with complete stats
- Analyze energy cost distribution across sets to study the TCG's power curve
- Cross-reference public_code values to fetch card art or thumbnails from the official gallery
| 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 Riftbound or Riot Games offer an official developer API for the card gallery?+
What does the get_cards endpoint return when I filter by set?+
set parameter, the endpoint returns all card objects whose set name partially matches that string. Each card object includes name, set, effect, energy_cost, power, might, collector_number, and public_code, along with a total count of matched cards.Does the API expose card rarity or card type (unit, spell, etc.)?+
Can I retrieve card image URLs through this API?+
public_code field that may be useful for constructing image references externally, but image URLs are not a returned field. You can fork this API on Parse and revise it to include an image URL field if the data is accessible.