Pred APIpred.gg ↗
Access Predecessor heroes, items, perks, ranks, and patch versions from Pred.gg. Includes icon URLs, ability details, item stats, and rank tier thresholds.
What is the Pred API?
The Pred.gg API covers 8 endpoints exposing structured game data for the Predecessor MOBA, including heroes, items, perks, rank seasons, and patch versions. The get_heroes endpoint returns full hero objects with ability details, roles, classes, icon URLs, and default skin data. Image assets across all content types are also aggregated into a single deduplicated collection via get_all_images, making it straightforward to inventory every icon in the game at once.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/1cc4a082-aa05-43b4-8fa8-8de16ad3a4e2/get_all_images' \ -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 pred-gg-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.
from parse_apis.pred_gg_game_data_api import PredGG, Hero, Item, Perk, RatingSeason, Version, GameImage
client = PredGG()
# Fetch a specific hero by slug
grux = client.heros.get(slug="grux")
print(grux.display_name, grux.slug, grux.roles, grux.classes)
# List all heroes
for hero in client.heros.list(limit=5):
print(hero.display_name, hero.icon_url)
# Get a specific item
chalice = client.items.get(slug="soul-chalice")
print(chalice.display_name, chalice.price, chalice.total_price, chalice.rarity)
for stat in chalice.stats:
print(stat.stat, stat.value)
# List items
for item in client.items.list(show_hidden=False, limit=3):
print(item.display_name, item.slot_type, item.is_evolved)
# List all perks
for perk in client.perks.list(limit=3):
print(perk.display_name, perk.hero_name, perk.slot)
# List rating seasons and inspect ranks
for season in client.ratingseasons.list(limit=2):
print(season.name, season.start_time, season.end_time)
for rank in season.ranks:
print(rank.tier_name, rank.abbreviation, rank.rating_min)
# List game versions
for version in client.versions.list(limit=3):
print(version.name, version.release_date, version.patch_type)
# List all game images
for image in client.gameimages.list(limit=5):
print(image.url, image.source_type, image.source_name)
Retrieve all deduplicated image URLs across heroes, items, perks, and ranks with metadata about their source category and field type. Makes multiple GraphQL calls internally to collect images from all entity types. Returns a flat list of unique image URLs with provenance metadata.
No input parameters required.
{
"type": "object",
"fields": {
"images": "array of image objects with url, source_type, source_name, and field",
"total_images": "integer total number of unique images"
},
"sample": {
"data": {
"images": [
{
"url": "https://pred.gg/assets/d32d7231c8ba2a06.webp",
"field": "icon",
"source_name": "Dekker",
"source_type": "hero"
}
],
"total_images": 1117
},
"status": "success"
}
}About the Pred API
Heroes and Abilities
The get_heroes and get_hero endpoints return complete hero records. Each hero object includes id, name, slug, display_name, description, icon_url, promo_icon_url, roles, classes, abilities, and default_skin. To fetch a single hero, pass a slug string such as 'feng-mao', 'grux', 'sparrow', or 'narbash'. Ability data is nested within each hero and icon hashes are resolved to full image URLs in the response — no additional resolution step required.
Items and Perks
get_items returns all shop items with fields including price, total_price, rarity, slot_type, is_evolved, build path details, stats, and effects. Hidden or deprecated items are excluded by default; pass show_hidden: true to include them. get_item accepts an item slug (e.g., 'soul-chalice', 'demolisher') and returns the same shape for a single record. The get_perks endpoint exposes perk objects with slot, display_order, description, simple_description, and the associated hero name and icon, which is useful for building per-hero perk reference pages.
Ranks and Patch Versions
get_ranks returns rating seasons, each containing a ranks array that covers tier details and icon URLs from Bronze through Paragon, along with start_time, end_time, and rating thresholds. get_versions lists every patch with release_date, patch_type, and a patch_notes_url linking to the official notes for that version. The total_ratings and total counts are included at the top level of both responses.
Image Asset Index
get_all_images aggregates image URLs from heroes, items, perks, and ranks into a single deduplicated array. Each image object carries url, source_type, source_name, and field, so you can filter by category or content type without calling each individual endpoint. The total_images count reflects unique images only.
The Pred API is a managed, monitored endpoint for pred.gg — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when pred.gg 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 pred.gg 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 hero reference guide displaying ability icons, roles, and class tags sourced from
get_heroes. - Generate item build path visualizations using the
price,total_price, and build path fields fromget_items. - Display per-hero perk loadouts with slot and description data from
get_perks. - Render a ranked season timeline showing tier thresholds and rank icons from
get_ranks. - Publish patch changelogs automatically using
release_dateandpatch_notes_urlfields fromget_versions. - Pre-cache all game artwork in a CDN by iterating the deduplicated URL list from
get_all_images. - Filter deprecated items out of a shop tool by default, then expose a toggle using the
show_hiddenparam onget_items.
| 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 Pred.gg have an official public developer API?+
What does `get_all_images` return and how is it different from the per-resource endpoints?+
get_all_images returns a flat, deduplicated array of every image URL across heroes, items, perks, and ranks in one call. Each object includes source_type, source_name, and field so you can identify where each image originated. The per-resource endpoints (e.g., get_heroes, get_items) embed images within their own structured records. Use get_all_images when you need a complete image inventory without iterating every resource type separately.Does the items endpoint include community build recommendations or win-rate statistics?+
get_items covers static item data: name, slug, price, total_price, rarity, slot_type, is_evolved, stats, effects, and build paths. Player-generated build guides and win-rate aggregations are not part of any endpoint. You can fork this API on Parse and revise it to add an endpoint targeting community build or statistics data if that becomes available.Are player profiles or match history included?+
How fresh is the item and hero data relative to live game patches?+
get_versions include a release_date and patch_type, so you can cross-reference item or hero changes against specific patch entries. There is no built-in change-diff or delta endpoint; callers should poll after a new version appears in get_versions to detect updated records.