metatft.com APImetatft.com ↗
Access TFT team composition data from MetaTFT: comp names, win rates, pick rates, recommended items, star carries, and traits via 3 structured endpoints.
curl -X GET 'https://api.parse.bot/scraper/fafd290f-21e4-421b-bd4d-0e7a011e8e05/get_comps?days=3&rank=CHALLENGER%2CGRANDMASTER%2CMASTER' \ -H 'X-API-Key: $PARSE_API_KEY'
Get all TFT team compositions with their names, units, items, stars, win rates, pick rates, traits, and builds. Returns comps sorted by win rate (top 4 placement percentage).
| Param | Type | Description |
|---|---|---|
| days | string | Number of days for stats (e.g., '1', '3', '7'). |
| rank | string | Comma-separated rank filter. Accepted values: CHALLENGER, GRANDMASTER, MASTER, DIAMOND, EMERALD, PLATINUM. |
| patch | string | Patch filter (e.g., 'current'). |
| queue | string | Queue ID (1100 for ranked). |
{
"type": "object",
"fields": {
"comps": "array of comp objects with cluster_id, name, units, stars, builds, top_items, traits, win_rate, pick_rate, avg_placement, play_count",
"patch": "string TFT set identifier",
"cluster_id": "integer current cluster version ID",
"total_comps": "integer number of compositions returned",
"total_games": "integer total games analyzed in the period"
},
"sample": {
"data": {
"comps": [
{
"name": "Shield Tank Leona",
"stars": [
"Leona",
"Zoe",
"Nasus",
"Teemo",
"Lissandra",
"Diana"
],
"units": [
"Illaoi",
"Ivern Minion",
"Karma",
"Leblanc",
"Leona",
"Mordekaiser",
"Nunu",
"Summon",
"Zoe"
],
"builds": [
{
"unit": "Leona",
"count": 3713,
"items": [
"Bloodthirster",
"Sterak's Gage",
"Titan's Resolve"
],
"score": 0.4432,
"place_change": -0.133,
"avg_placement": 3.7778
}
],
"traits": [
{
"name": "ADMIN",
"count": 2
},
{
"name": "Shield Tank",
"count": 2
}
],
"stars_4": [],
"win_rate": 64.23,
"levelling": "lvl 5",
"pick_rate": 0.41,
"top_items": [
{
"item": "Bloodthirster",
"count": 7339,
"pick_rate": 88.73,
"avg_placement": 3.9027
}
],
"cluster_id": "405000",
"difficulty": -0.007,
"play_count": 8271,
"avg_placement": 3.911
}
],
"patch": "TFTSet17",
"cluster_id": 405,
"total_comps": 36,
"total_games": 2000000
},
"status": "success"
}
}About the metatft.com API
The MetaTFT API exposes Teamfight Tactics meta data across 3 endpoints, returning comp names, win rates, pick rates, traits, and per-unit item recommendations sourced from MetaTFT. The get_comps endpoint delivers a ranked list of all current meta compositions, while get_comp_details provides build-level breakdowns and daily trend data for any individual comp identified by its comp_id.
Compositions and Meta Overview
The get_comps endpoint returns an array of composition objects, each containing name, units, stars, traits, win_rate, pick_rate, avg_placement, and top_items. Results can be filtered by days (1, 3, or 7), rank (CHALLENGER through PLATINUM as a comma-separated list), patch, and queue (1100 for ranked). The response also includes aggregate fields: total_games (games analyzed in the period), total_comps, and the current patch identifier.
Comp Details and Build Trends
Passing a comp_id from get_comps into get_comp_details unlocks build-level data: an array of builds objects (each with unit, items, avg_placement, score, and place_change), a full all_items map with per-item count, avg_placement, and pick_rate, and a levelling string for recommended level strategy. The trends array provides day-by-day count, avg, and pick data so you can track how a comp's performance shifts across the patch cycle.
Per-Unit Item Recommendations
The get_unit_items endpoint returns up to 10 recommended items per champion, sorted by unit pick rate. Each unit object includes unit, api_name, count, avg_placement, pick_rate, and a top_items array. The optional unit_name parameter accepts a case-insensitive partial match, so querying "ahri" will resolve to the correct champion record without requiring an exact name string.
- Build a TFT tier list dashboard using
win_rateandavg_placementfromget_compsfiltered to Challenger/Grandmaster ranks. - Generate patch-over-patch composition trend charts using the
trendsarray fromget_comp_details. - Recommend an in-game item build for a specific unit by querying
get_unit_itemswith the champion name. - Track which star carries (
starsfield) define the current meta after each patch update. - Identify off-meta compositions by comparing
pick_rateagainstwin_rateacross the fullget_compsresponse. - Surface trait synergies in draft tools using the
traitsarray returned per composition. - Evaluate how a specific comp's
avg_placementshifts over a 7-day window using thedaysfilter.
| 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 MetaTFT have an official developer API?+
What rank tiers can I filter compositions by in `get_comps`?+
rank parameter accepts a comma-separated list from: CHALLENGER, GRANDMASTER, MASTER, DIAMOND, EMERALD, and PLATINUM. Passing multiple values (e.g., MASTER,GRANDMASTER,CHALLENGER) returns stats aggregated across those tiers.Does the API return augment data or augment win rates for compositions?+
How fresh is the data returned by these endpoints?+
days parameter in get_comps controls the lookback window (1, 3, or 7 days). The patch parameter also lets you scope results to the current patch. Data reflects recent ranked games within the selected window; real-time match-by-match freshness is not guaranteed.Can I retrieve historical composition performance from previous TFT sets?+
patch field in responses. Historical set data is not exposed through the current endpoints. You can fork this API on Parse and revise it to target prior-set data if that endpoint surface becomes available.