riftbound.leagueoflegends.com 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.
curl -X GET 'https://api.parse.bot/scraper/54a64552-51ed-4c8d-8e7e-90c48842cfce/get_cards?set=Origins&name=Ahri&limit=3' \ -H 'X-API-Key: $PARSE_API_KEY'
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.
| Param | Type | Description |
|---|---|---|
| set | string | Filter by set name using partial match. 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": "Acceptable Losses",
"might": null,
"power": null,
"effect": "[Action] (Play on your turn or in showdowns.)Each player kills one of their gear.",
"energy_cost": 1,
"public_code": "OGN-179/298",
"collector_number": 179
},
{
"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
},
{
"set": "Origins",
"name": "Ahri, Alluring",
"might": 4,
"power": 1,
"effect": "When I hold, you score 1 point.",
"energy_cost": 5,
"public_code": "OGN-066a/298",
"collector_number": 66
}
],
"total": 3
},
"status": "success"
}
}About the riftbound.leagueoflegends.com 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.
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.
- 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 | 250 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.