pred.gg 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.
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'
Retrieve all deduplicated image URLs across heroes, items, perks, and ranks with metadata about their source category and field type.
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/8367e1f44c31303c.webp",
"field": "icon",
"source_name": "Tidebinder",
"source_type": "hero"
},
{
"url": "https://pred.gg/assets/ee5dd8d20cd9a5fe.webp",
"field": "promoIcon",
"source_name": "Tidebinder",
"source_type": "hero"
}
],
"total_images": 1085
},
"status": "success"
}
}About the pred.gg 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.
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.
- 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 | 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 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.