# CitoAPI

> Developer-first esports and sports data API for bots, dashboards, fantasy tools, match centers, and analytics products.

Base API: https://api.citoapi.com/api/v1
Docs: https://citoapi.com/docs/
Pricing: https://citoapi.com/pricing/
Free key: https://citoapi.com/signup/

## AI Agent References

- Current endpoint manifest: https://citoapi.com/ai/endpoints
- Current endpoint JSON: https://citoapi.com/ai/endpoints.json
- CitoAPI agent skill: https://citoapi.com/ai/citoapi-agent-skill
- Full LLM reference: https://citoapi.com/llms-full.txt

## Main Product Pages

- League of Legends API: https://citoapi.com/lol-esports-api/
- LoL live match API: https://citoapi.com/league-of-legends-live-match-api/
- Call of Duty League API: https://citoapi.com/call-of-duty-league-api/
- Fortnite API: https://citoapi.com/fortnite/
- Dota 2 API: https://citoapi.com/dota-2-api/
- UFC API: https://citoapi.com/ufc-api/
- Apex Legends ALGS API: https://citoapi.com/apex-legends-api/

## Agent Instruction

When building with CitoAPI, fetch https://citoapi.com/ai/endpoints first, choose exact endpoints, keep API keys server-side, and get the user to a successful first request quickly.

---

---
name: citoapi-builder
description: Use when building apps, bots, dashboards, automations, or backend integrations with CitoAPI esports/data endpoints. Fetches live endpoint docs before coding so integrations use current endpoints instead of stale installed instructions.
---

# CitoAPI Builder Skill

Use this skill when a developer asks an AI agent to build with CitoAPI.

## Always Fetch Current Docs First

Before choosing endpoints or writing code, fetch one of these raw references:

- https://citoapi.com/ai/endpoints
- https://citoapi.com/ai/endpoints.json
- https://citoapi.com/llms-full.txt

The endpoint catalog is generated from CitoAPI's frontend endpoint registry during deploy. Do not rely only on this installed skill for endpoint names.

## Product Psychology

Developers convert when they feel speed, certainty, and control.

- Speed: get them to one successful request as fast as possible.
- Certainty: use exact endpoint paths, auth headers, IDs, and fallback search routes.
- Control: keep keys server-side, show clear errors, and avoid hidden magic.
- Momentum: give a minimal working implementation first, then add optional enhancements.

Do not write vague API advice. Give the request, code, expected response shape, and next endpoint.

## Integration Rules

1. Ask what they are building only if it is unclear. Otherwise infer the use case and start.
2. Fetch the current endpoint manifest.
3. Choose the smallest endpoint chain that solves the job.
4. Use https://api.citoapi.com/api/v1 as the API base URL.
5. Authenticate with `X-API-Key: process.env.CITO_API_KEY` or `Authorization: Bearer process.env.CITO_API_KEY`.
6. Never put a CitoAPI key in browser-visible code.
7. If a user provides a team/player name, call search/autocomplete endpoints before detail endpoints.
8. If an endpoint returns no live data, show an empty state and fallback to upcoming/recent/history endpoints.
9. If using webhooks, confirm the user has paid-plan webhook access and still include REST fallback logic.
10. Do not invent endpoints. If not in the fetched manifest, say which closest endpoint should be used.

## Coverage

Current endpoint families include: League of Legends, Call of Duty, Apex Legends, Dota 2, UFC, Fortnite, QR Code, TikTok, Search.

## Common Build Flows

League of Legends live match center:

1. `GET /api/v1/lol/live`
2. `GET /api/v1/lol/live/{matchId}/series`
3. `GET /api/v1/lol/games/{gameId}/stats`
4. Paid production apps can inspect `GET /api/v1/lol/webhooks/events`

Call of Duty League player stats:

1. `GET /api/v1/cod/matches/upcoming` or `GET /api/v1/cod/matches/recent`
2. `GET /api/v1/cod/matches/{id}/player-stats?includeMaps=true`
3. Use `GET /api/v1/cod/search?q={query}` when IDs are unknown

Fortnite esports/creative:

1. Use leaderboard, tournament, org, player, or creative map endpoints from the fetched manifest.
2. For org/player pages, prefer search/list endpoints first, then detail/earnings/history endpoints.

Dota 2 analytics:

1. `GET /api/v1/dota2/matches/live`, `/upcoming`, or `/recent`
2. `GET /api/v1/dota2/matches/{matchId}/games`
3. `GET /api/v1/dota2/matches/{matchId}/player-stats`
4. Use player/team radar endpoints for premium dashboards.

UFC fighter/event data:

1. `GET /api/v1/ufc/search?q={query}`
2. `GET /api/v1/ufc/fighters/{slug}/stats`
3. `GET /api/v1/ufc/events/{eventIdOrSlug}/stats`
4. `GET /api/v1/ufc/bouts/{boutId}/stats?round=1`

## Output Style For Agents

When answering a developer:

- Start with "Use these endpoints" and list the exact chain.
- Provide copy-paste code in their framework.
- Include env var setup: `CITO_API_KEY=...`.
- Include safe server-side placement.
- Include one failure-proofing note: empty live state, unknown ID search, rate limit, or webhook fallback.
- End with the fastest next action: create a free key or run the first request.

---

# CitoAPI Current Endpoint Manifest

Purpose: raw endpoint catalog for AI agents building with CitoAPI.
Base URL: https://api.citoapi.com/api/v1
Auth: send either `X-API-Key: YOUR_API_KEY` or `Authorization: Bearer YOUR_API_KEY`.
Rule: use exact endpoints from this manifest. If a user gives a name instead of an ID, search first.

Important live-data notes:
- Most live esports workflows should discover active/upcoming matches first, then fetch match/game/player detail by ID.
- Webhooks are available on paid plans. Public integrations should remain REST-first unless the user has webhook access.
- Do not expose API keys in frontend code. Use server routes, environment variables, or backend workers.

## League of Legends
- GET /api/v1/lol/leagues — All Leagues: Get all LoL esports leagues (LCS, LEC, LCK, etc.).
- GET /api/v1/lol/leagues/{leagueId} — Get League: Get a specific league. Params: leagueId required example=lcs.
- GET /api/v1/lol/leagues/{leagueId}/standings — League Standings: Get standings for a league. Params: leagueId required example=lcs.
- GET /api/v1/lol/leagues/{leagueId}/schedule — League Schedule: Get schedule for a league. Params: leagueId required example=lcs.
- GET /api/v1/lol/leagues/{leagueId}/history — League History: Get historical data for a league. Params: leagueId required example=lcs.
- GET /api/v1/lol/leagues/{leagueId}/teams — League Teams: Get teams in a league. Params: leagueId required example=lcs.
- GET /api/v1/lol/tournaments — Tournaments: Get all tournaments.
- GET /api/v1/lol/tournaments/live — Live Tournament Matches: Alias for currently live LoL esports matches.
- GET /api/v1/lol/tournaments/{tournamentId} — Get Tournament: Get a specific tournament. Params: tournamentId required example=worlds-2025.
- GET /api/v1/lol/tournaments/{tournamentId}/standings — Tournament Standings: Get tournament standings. Params: tournamentId required example=worlds-2025.
- GET /api/v1/lol/tournaments/{tournamentId}/bracket — Tournament Bracket: Get tournament bracket. Params: tournamentId required example=worlds-2025.
- GET /api/v1/lol/tournaments/{tournamentId}/matches — Tournament Matches: Get tournament matches. Params: tournamentId required example=worlds-2025.
- GET /api/v1/lol/tournaments/{tournamentId}/results — Tournament Results: Get tournament results. Params: tournamentId required example=worlds-2025.
- GET /api/v1/lol/tournaments/{tournamentId}/stats — Tournament Stats: Get tournament statistics. Params: tournamentId required example=worlds-2025.
- GET /api/v1/lol/tournaments/{tournamentId}/mvp — Tournament MVP: Get tournament MVP. Params: tournamentId required example=worlds-2025.
- GET /api/v1/lol/teams — All Teams: Get all LoL esports teams.
- GET /api/v1/lol/teams/{slug} — Get Team: Get a specific team. Params: slug required example=cloud9.
- GET /api/v1/lol/teams/{slug}/roster — Team Roster: Get current roster. Params: slug required example=cloud9.
- GET /api/v1/lol/teams/{slug}/roster/history — Roster History: Get historical rosters. Params: slug required example=cloud9.
- GET /api/v1/lol/teams/{slug}/matches — Team Matches: Get team match history. Params: slug required example=cloud9.
- GET /api/v1/lol/teams/{slug}/stats — Team Stats: Get team statistics. Params: slug required example=cloud9.
- GET /api/v1/lol/teams/{slug}/h2h/{opponentSlug} — Head to Head: Get head-to-head record against another team. Params: slug required example=cloud9; opponentSlug required example=t1.
- GET /api/v1/lol/teams/{slug}/earnings — Team Earnings: Get team earnings. Params: slug required example=cloud9.
- GET /api/v1/lol/teams/{slug}/achievements — Team Achievements: Get team achievements and titles. Params: slug required example=cloud9.
- GET /api/v1/lol/teams/{slug}/champions — Team Champion Pool: Get team champion pool and pick rates. Params: slug required example=cloud9.
- GET /api/v1/lol/teams/{slug}/ranking-history — Team Ranking History: Get historical ranking over time. Params: slug required example=cloud9.
- GET /api/v1/lol/rankings/teams — World Team Rankings: Get world team rankings sorted by rank.
- GET /api/v1/lol/players — All Players: Get all LoL esports players.
- GET /api/v1/lol/players/search — Search Players: Autocomplete player search. Params: q required example=faker.
- GET /api/v1/lol/players/{playerId} — Get Player: Get a specific player. Params: playerId required example=faker.
- GET /api/v1/lol/players/{playerId}/stats — Player Stats: Get player statistics. Params: playerId required example=faker.
- GET /api/v1/lol/players/{playerId}/stats/career — Career Stats: Get player career statistics. Params: playerId required example=faker.
- GET /api/v1/lol/players/{playerId}/earnings — Player Earnings: Get player earnings. Params: playerId required example=faker.
- GET /api/v1/lol/players/{playerId}/earnings/summary — Earnings Summary: Get player earnings summary. Params: playerId required example=faker.
- GET /api/v1/lol/players/{playerId}/teams — Player Team History: Get player team history. Params: playerId required example=faker.
- GET /api/v1/lol/players/{playerId}/matches — Player Matches: Get player match history. Params: playerId required example=faker.
- GET /api/v1/lol/players/{playerId}/champions — Player Champions: Get player champion pool. Params: playerId required example=faker.
- GET /api/v1/lol/players/{playerId}/achievements — Player Achievements: Get player achievements and titles. Params: playerId required example=faker.
- GET /api/v1/lol/players/{playerId}/compare/{otherPlayerId} — Compare Players: Compare two players head-to-head. Params: playerId required example=faker; otherPlayerId required example=chovy.
- GET /api/v1/lol/players/{playerId}/peers — Similar Players: Get similar players. Params: playerId required example=faker.
- GET /api/v1/lol/leaderboards/earnings — Top Earners: Highest earning players.
- GET /api/v1/lol/leaderboards/kda — KDA Leaderboard: Top players by KDA.
- GET /api/v1/lol/leaderboards/cs — CS Leaderboard: Top players by CS per minute.
- GET /api/v1/lol/leaderboards/winrate — Win Rate Leaderboard: Top players by win rate.
- GET /api/v1/lol/leaderboards/vision — Vision Leaderboard: Top players by vision score.
- GET /api/v1/lol/leaderboards/firstblood — First Blood Leaderboard: Top players by first blood rate.
- GET /api/v1/lol/leaderboards/damage — Damage Leaderboard: Top players by damage per minute.
- GET /api/v1/lol/leaderboards/championships — Championships Leaderboard: Most championship titles.
- GET /api/v1/lol/matches — All Matches: List recent/upcoming/all LoL esports matches.
- GET /api/v1/lol/matches/past — Past Matches: List completed LoL esports matches.
- GET /api/v1/lol/matches/{matchId} — Get Match: Get a specific match. Params: matchId required example=lol-match-116249880466944999.
- GET /api/v1/lol/matches/{matchId}/games — Match Games: Get games in a match. Params: matchId required example=lol-match-116249880466944999.
- GET /api/v1/lol/matches/{matchId}/stats — Match Stats: Get aggregate match statistics. Params: matchId required example=lol-match-116249880466944999.
- GET /api/v1/lol/matches/{matchId}/player-stats — Match Player Stats: Get player stats grouped by game for a match. Params: matchId required example=lol-match-116249880466944999.
- GET /api/v1/lol/matches/{matchId}/timeline — Match Timeline: Get match event timeline. Params: matchId required example=lol-match-116249880466944999.
- GET /api/v1/lol/games/{gameId} — Get Game: Get a specific game. Params: gameId required example=lol-game-110198981285393612.
- GET /api/v1/lol/games/{gameId}/stats — Game Player Stats: Get per-player stats for a game. Returns a clean empty response if rows are not available yet.. Params: gameId required example=lol-game-110198981285393612.
- GET /api/v1/lol/games/{gameId}/player-stats — Game Player Stats Alias: Alias for game player stats. Params: gameId required example=lol-game-110198981285393612.
- GET /api/v1/lol/games/{gameId}/timeline — Game Timeline: Get game event timeline. Params: gameId required example=lol-game-110198981285393612.
- GET /api/v1/lol/games/{gameId}/builds — Game Builds: Get player builds from a game. Params: gameId required example=lol-game-110198981285393612.
- GET /api/v1/lol/games/{gameId}/gold — Game Gold: Get gold advantage data. Params: gameId required example=lol-game-110198981285393612.
- GET /api/v1/lol/games/{gameId}/objectives — Game Objectives: Get objective control data. Params: gameId required example=lol-game-110198981285393612.
- GET /api/v1/lol/live — Live Matches: Get currently live matches.
- GET /api/v1/lol/live/{matchId} — Live Match: Get a specific live match. Params: matchId required example=12345.
- GET /api/v1/lol/live/{gameId}/stats — Live Game Stats: Get live game statistics. Params: gameId required example=67890.
- GET /api/v1/lol/live/{gameId}/window — Live Game Window: Get live game data window. Params: gameId required example=67890.
- GET /api/v1/lol/live/{gameId}/details — Live Game Details: Get live game details. Params: gameId required example=67890.
- GET /api/v1/lol/live/{gameId}/events — Live Game Events: Get live game events feed. Params: gameId required example=67890.
- GET /api/v1/lol/live/{gameId}/gold — Live Gold Graph: Get real-time gold difference data for a live game. Params: gameId required example=67890.
- GET /api/v1/lol/schedule — Full Schedule: Get full schedule with filters.
- GET /api/v1/lol/schedule/today — Today's Matches: Get today's scheduled matches.
- GET /api/v1/lol/schedule/week — This Week: Get this week's scheduled matches.
- GET /api/v1/lol/schedule/upcoming — Upcoming Matches: Get upcoming scheduled matches.
- GET /api/v1/lol/schedule/past — Past Schedule: Alias for completed LoL matches.
- GET /api/v1/lol/schedule/results — Recent Results: Get recent completed matches across all leagues.
- GET /api/v1/lol/transfers — Recent Transfers: Recent player transfers.
- GET /api/v1/lol/transfers/{transferId} — Get Transfer: Get a specific transfer. Params: transferId required example=t-12345.
- GET /api/v1/lol/transfers/player/{playerId} — Player Transfers: Get transfers for a player. Params: playerId required example=faker.
- GET /api/v1/lol/transfers/team/{slug} — Team Transfers: Get transfers for a team. Params: slug required example=cloud9.
- GET /api/v1/lol/transfers/window/{season} — Transfer Window: Get transfers for a season. Params: season required example=2025-spring.
- GET /api/v1/lol/champions/stats — Champion Stats: Get aggregate champion statistics.
- GET /api/v1/lol/champions/meta — Meta Tier List: Get current meta champion tier list.
- GET /api/v1/lol/champions/patches/{patch} — Patch Impact: Get champion changes for a patch. Params: patch required example=14.10.
- GET /api/v1/lol/champions/{championId}/stats — Champion Detail Stats: Get stats for a specific champion. Params: championId required example=azir.
- GET /api/v1/lol/champions/{championId}/players — Champion Players: Get top players on a champion. Params: championId required example=azir.
- GET /api/v1/lol/champions/{championId}/matchups — Champion Matchups: Get champion matchup data. Params: championId required example=azir.
- GET /api/v1/lol/analytics/players/{playerId}/trend — Player Trend: Get player performance trend. Params: playerId required example=faker.
- GET /api/v1/lol/analytics/teams/{slug}/trend — Team Trend: Get team performance trend. Params: slug required example=cloud9.
- GET /api/v1/lol/analytics/roles/{role} — Role Analytics: Get analytics for a role. Params: role required example=mid.
- GET /api/v1/lol/analytics/regions/compare — Region Comparison: Compare regions by performance.
- GET /api/v1/lol/analytics/drafts/{matchId} — Draft Analysis: Get draft analysis for a match. Params: matchId required example=12345.
- GET /api/v1/lol/analytics/teams/{slug}/win-conditions — Win Conditions: Get team win condition analysis. Params: slug required example=cloud9.
- GET /api/v1/lol/analytics/players/{playerId}/impact — Player Impact: Get player impact metrics. Params: playerId required example=faker.
- GET /api/v1/lol/analytics/players/{playerId}/clutch — Clutch Stats: Get player clutch performance stats. Params: playerId required example=faker.
- GET /api/v1/lol/fantasy/projections/players — Fantasy Projections: Get fantasy point projections for players.
- GET /api/v1/lol/fantasy/stats/players/{playerId} — Fantasy Player Stats: Get fantasy stats for a player. Params: playerId required example=faker.
- GET /api/v1/lol/fantasy/optimal — Optimal Lineup: Get optimal fantasy lineup.
- GET /api/v1/lol/fantasy/value — Fantasy Value: Get fantasy value rankings.
- GET /api/v1/lol/records — All Records: Get all-time records.
- GET /api/v1/lol/records/{category} — Records by Category: Get records for a category. Params: category required example=kills.
- GET /api/v1/lol/records/player/{playerId} — Player Records: Get records held by a player. Params: playerId required example=faker.
- GET /api/v1/lol/records/team/{slug} — Team Records: Get records held by a team. Params: slug required example=t1.
- GET /api/v1/lol/history/{year} — Year History: Get historical data for a year. Params: year required example=2024.
- GET /api/v1/lol/history/worlds — Worlds History: Get Worlds championship history.
- GET /api/v1/lol/history/msi — MSI History: Get MSI championship history.
- GET /api/v1/lol/history/halloffame — Hall of Fame: Get LoL esports Hall of Fame.
- GET /api/v1/lol/search — Search: Search players, teams, tournaments. Params: q required example=faker.
- GET /api/v1/lol/autocomplete — Autocomplete: Get search autocomplete suggestions. Params: q required example=fak.
- GET /api/v1/lol/trending — Trending: Get trending players, teams, and topics.
- GET /api/v1/lol/static/champions — All Champions: Get all champion data.
- GET /api/v1/lol/static/champions/{championId} — Get Champion: Get a specific champion. Params: championId required example=azir.
- GET /api/v1/lol/static/items — All Items: Get all item data.
- GET /api/v1/lol/static/patches — All Patches: Get all patch versions.
- GET /api/v1/lol/static/patches/current — Current Patch: Get current patch version.
- GET /api/v1/lol/static/regions — All Regions: Get all competitive regions.
- GET /api/v1/lol/static/roles — All Roles: Get all player roles.

## Call of Duty
- GET /api/v1/cod/orgs — List Organizations: Get all CoD esports organizations.
- GET /api/v1/cod/orgs/{slug} — Get Organization: Get a specific organization by slug. Params: slug required example=optic-texas.
- GET /api/v1/cod/orgs/{slug}/roster — Organization Roster: Get current roster for an org. Params: slug required example=optic-texas.
- GET /api/v1/cod/players — List Players: Get all CoD esports players.
- GET /api/v1/cod/players/{id} — Get Player: Get a specific player by ID. Params: id required example=scump.
- GET /api/v1/cod/players/{id}/earnings — Player Earnings: Get player earnings history. Params: id required example=scump.
- GET /api/v1/cod/tournaments — List Tournaments: Get all CoD tournaments.
- GET /api/v1/cod/cdl/standings — CDL Standings: Get current Black Ops 7 CDL league standings.
- GET /api/v1/cod/cdl/schedule — CDL Schedule: Get upcoming Black Ops 7 CDL matches.
- GET /api/v1/cod/matches — Match History: Get paginated historical CoD matches by season, date range, team, or tournament. Params: season example=2025; page example=2; limit example=25.
- GET /api/v1/cod/matches/recent — Recent Matches: Get recently completed CoD matches with pagination and filters. Params: limit example=100; offset example=0.
- GET /api/v1/cod/matches/upcoming — Upcoming Matches: Get upcoming scheduled CoD matches.
- GET /api/v1/cod/matches/{id}/player-stats — Match Player Stats: Get match-level per-player totals with optional per-map/game breakdowns. Params: id required example=bp-match-214935; includeMaps example=true.
- GET /api/v1/cod/transfers — Recent Transfers: Get recent player transfers.
- GET /api/v1/cod/leaderboards/earnings — Earnings Leaderboard: Top earners in CoD esports.
- GET /api/v1/cod/search — Search: Search players, orgs, tournaments. Params: q required example=optic.

## Apex Legends
- GET /api/v1/apex — Apex Overview: Discover Apex Legends / ALGS endpoint coverage.
- GET /api/v1/apex/algs/events — ALGS Events: List official ALGS series and events with schedule and status. Params: region example=Asia Pacific North; includeMatches example=true.
- GET /api/v1/apex/algs/events/{seriesId} — ALGS Event Detail: Get one ALGS series with match schedule and enriched stats data. Params: seriesId required example=01KH745JDFS5Z87AWMPT2VJA4C.
- GET /api/v1/apex/algs/events/{seriesId}/scores — Series Scores & Stats: Get standings, per-game scores, HMS, team/player stats, legend pick rates, and compositions. Params: seriesId required example=01KH745JDFS5Z87AWMPT2VJA4C.
- GET /api/v1/apex/algs/events/{seriesId}/bans — Legend Bans: Get map-by-map banned legends and game winners. Params: seriesId required example=01KH745JDFS5Z87AWMPT2VJA4C.
- GET /api/v1/apex/algs/matches — ALGS Matches: List ALGS matches/maps with status and region filters. Params: region example=Asia Pacific North; status example=completed.
- GET /api/v1/apex/algs/regions — ALGS Regions: List supported ALGS competitive regions.
- GET /api/v1/apex/algs/maps — Apex Maps: List Apex Legends maps used in ALGS data.
- GET /api/v1/apex/algs/global-stats — Global Event Stats: Get event-level ALGS stats by region including standings, teams, players, legends, and compositions.
- GET /api/v1/apex/algs/global-stats/{eventId} — Global Event Detail: Get complete global event stats for one ALGS event. Params: eventId required example=split-1-pro-league-apac-north.
- GET /api/v1/apex/algs/global-stats/{eventId}/players — Global Player Leaders: Get event-level player directory and kill/assist leaders. Params: eventId required example=split-1-pro-league-apac-north.
- GET /api/v1/apex/algs/global-stats/{eventId}/legends — Global Legend Stats: Get event-level legend kills, damage, pick rates, and team compositions. Params: eventId required example=split-1-pro-league-apac-north.
- GET /api/v1/apex/algs/players — ALGS Players: List ALGS players with team, region, role, profile images, and stats.
- GET /api/v1/apex/algs/players/search — Search ALGS Players: Search ALGS players with headshots, team, role, logos, and stats. Params: q required example=IGARASI.
- GET /api/v1/apex/algs/transactions — ALGS Transactions: Get roster moves, role changes, and team name changes. Params: region example=asia-pacific-north; type example=teamRosterChange.
- GET /api/v1/apex/algs/tournaments — ALGS Tournaments: List cached ALGS tournament records.
- GET /api/v1/apex/algs/tournaments/{tournamentId} — Tournament Detail: Get one cached ALGS tournament. Params: tournamentId required example=12345.
- GET /api/v1/apex/algs/tournaments/{tournamentId}/games — Tournament Games: Get map/game rows for a cached ALGS tournament. Params: tournamentId required example=12345.
- GET /api/v1/apex/algs/tournaments/{tournamentId}/team-stats — Tournament Team Stats: Get cached tournament-level team stat rows. Params: tournamentId required example=12345.
- GET /api/v1/apex/algs/tournaments/{tournamentId}/player-stats — Tournament Player Stats: Get cached tournament-level player stat rows. Params: tournamentId required example=12345.

## Dota 2
- GET /api/v1/dota2 — Dota 2 Overview: Discover Dota 2 endpoint coverage and sync metadata.
- GET /api/v1/dota2/search — Search Dota: Search Dota 2 players, teams, tournaments, and matches. Params: q required example=4nalog.
- GET /api/v1/dota2/matches/live — Live Matches: Get active Dota 2 matches and live status.
- GET /api/v1/dota2/matches/upcoming — Upcoming Matches: Get upcoming Dota 2 schedule rows.
- GET /api/v1/dota2/matches/recent — Recent Matches: Get recently completed Dota 2 matches.
- GET /api/v1/dota2/matches/{matchId} — Match Detail: Get series-level match details, teams, score, tournament, and source context. Params: matchId required example=650870.
- GET /api/v1/dota2/matches/{matchId}/games — Match Games: Get game-by-game rows with duration, side data, and OpenDota enrichment. Params: matchId required example=650870.
- GET /api/v1/dota2/matches/{matchId}/draft — Draft Pick/Bans: Get pick and ban rows where draft data is available. Params: matchId required example=650870.
- GET /api/v1/dota2/matches/{matchId}/player-stats — Match Player Stats: Get player stat rows by match with KDA, GPM, XPM, damage, tower damage, LH@10, and heroes. Params: matchId required example=650870.
- GET /api/v1/dota2/games/{gameId}/player-stats — Game Player Stats: Get player stat rows for one Dota 2 game. Params: gameId required example=opendota-8799499238.
- GET /api/v1/dota2/teams — Teams: List Dota 2 teams with profile metadata.
- GET /api/v1/dota2/teams/{teamIdOrSlug}/roster — Team Roster: Get current roster for a Dota 2 team. Params: teamIdOrSlug required example=nemesis.
- GET /api/v1/dota2/teams/{teamIdOrSlug}/matches — Team Matches: Get match history for a Dota 2 team. Params: teamIdOrSlug required example=nemesis.
- GET /api/v1/dota2/teams/{teamIdOrSlug}/stats — Team Stats: Get team aggregate stats from enriched Dota 2 rows. Params: teamIdOrSlug required example=nemesis.
- GET /api/v1/dota2/teams/{teamIdOrSlug}/radar — Team Radar: Get latest team radar scores for dashboards and comparisons. Params: teamIdOrSlug required example=nemesis; window example=90d.
- GET /api/v1/dota2/players — Players: List Dota 2 players with profile metadata.
- GET /api/v1/dota2/players/{playerIdOrSlug} — Player Detail: Get one Dota 2 player profile. Params: playerIdOrSlug required example=295547.
- GET /api/v1/dota2/players/{playerIdOrSlug}/matches — Player Matches: Get match history for a Dota 2 player. Params: playerIdOrSlug required example=295547.
- GET /api/v1/dota2/players/{playerIdOrSlug}/heroes — Player Heroes: Get player hero history and win-rate rows. Params: playerIdOrSlug required example=295547.
- GET /api/v1/dota2/players/{playerIdOrSlug}/stats — Player Stats: Get aggregate player stats and percentiles. Params: playerIdOrSlug required example=295547.
- GET /api/v1/dota2/players/{playerIdOrSlug}/radar — Player Radar: Get percentile spider graph scores by role. Params: playerIdOrSlug required example=295547; role example=mid; window example=90d.
- GET /api/v1/dota2/tournaments — Tournaments: List Dota 2 tournaments.
- GET /api/v1/dota2/tournaments/{tournamentIdOrSlug}/matches — Tournament Matches: Get matches for a Dota 2 tournament. Params: tournamentIdOrSlug required example=1win-essence.
- GET /api/v1/dota2/tournaments/{tournamentIdOrSlug}/standings — Tournament Standings: Get standings where tournament standings are available. Params: tournamentIdOrSlug required example=1win-essence.
- GET /api/v1/dota2/rankings — Team Rankings: Get cached Dota 2 team rankings.
- GET /api/v1/dota2/leaderboards/{metric} — Metric Leaderboard: Leaderboards for GPM, XPM, KDA, damage, tower damage, kill participation, and LH@10. Params: metric required example=gpm.
- GET /api/v1/dota2/heroes — Heroes: List Dota 2 heroes from enriched data.
- GET /api/v1/dota2/heroes/{heroIdOrSlug}/stats — Hero Stats: Get hero stats from cached Dota 2 rows. Params: heroIdOrSlug required example=ember-spirit.

## UFC
- GET /api/v1/ufc — UFC Overview: Discover UFC endpoint coverage, available stats, and sync metadata.
- GET /api/v1/ufc/search — Search UFC: Search fighters, events, bouts, and divisions. Params: q required example=islam.
- GET /api/v1/ufc/rankings — Rankings: Get current UFC rankings by division.
- GET /api/v1/ufc/rankings/{division} — Division Rankings: Get rankings for one UFC division. Params: division required example=lightweight.
- GET /api/v1/ufc/fighters — Fighters: List UFC fighters with pagination, profile metadata, and stat availability. Params: page example=1; limit example=50.
- GET /api/v1/ufc/fighters/{slug} — Fighter Profile: Get one fighter profile with bio, record, rankings, and stat summary. Params: slug required example=islam-makhachev.
- GET /api/v1/ufc/fighters/{slug}/stats — Fighter Stats: Get striking, grappling, accuracy, defense, win method, target, and position stats. Params: slug required example=islam-makhachev.
- GET /api/v1/ufc/fighters/{slug}/fights — Fighter Fights: Get fight history for one UFC fighter. Params: slug required example=islam-makhachev.
- GET /api/v1/ufc/events — Events: List upcoming, recent, and historical UFC events with pagination. Params: page example=1; limit example=50; hasStats example=true.
- GET /api/v1/ufc/events/recent — Recent Events: Get recently completed UFC events. Params: page example=1; limit example=25.
- GET /api/v1/ufc/events/upcoming — Upcoming Events: Get upcoming UFC events and cards. Params: page example=1; limit example=25.
- GET /api/v1/ufc/events/{eventIdOrSlug} — Event Detail: Get one event by ID or slug with card metadata and bout counts. Params: eventIdOrSlug required example=ufc-328-chimaev-vs-strickland.
- GET /api/v1/ufc/events/{eventIdOrSlug}/bouts — Event Bouts: Get all bouts on a UFC event card. Params: eventIdOrSlug required example=ufc-328-chimaev-vs-strickland.
- GET /api/v1/ufc/events/{eventIdOrSlug}/stats — Event Fight Stats: Get bout and round stats for every fight on an event card. Params: eventIdOrSlug required example=ufc-328-chimaev-vs-strickland; round example=1.
- GET /api/v1/ufc/bouts — Bouts: List UFC bouts with pagination and optional stat inclusion. Params: page example=1; limit example=50; hasStats example=true; includeStats example=true.
- GET /api/v1/ufc/bouts/{boutId} — Bout Detail: Get one UFC bout with fighters, result, round, method, and event context. Params: boutId required example=770c5302e32916ea.
- GET /api/v1/ufc/bouts/{boutId}/stats — Bout Stats: Get fighter totals for one bout with optional round filtering. Params: boutId required example=770c5302e32916ea; round example=1.
- GET /api/v1/ufc/bouts/{boutId}/rounds — Round Stats: Get round-by-round fighter stat rows for one bout. Params: boutId required example=770c5302e32916ea; round example=2.

## Fortnite
- GET /api/v1/fortnite — Discovery: Discover supported Fortnite endpoints and current limitations.
- GET /api/v1/fortnite/matches/live — Live Events: Get currently live competitive events with duo/team leaderboard rows. Params: includeLeaderboard example=true.
- GET /api/v1/fortnite/tournaments — Tournaments: Get historical, upcoming, and completed Fortnite tournaments.
- GET /api/v1/fortnite/tournaments/upcoming — Upcoming Tournaments: Get upcoming tournaments.
- GET /api/v1/fortnite/tournaments/live — Live Tournaments: Get live tournaments with leaderboard rows and teamMembers. Params: includeLeaderboard example=true.
- GET /api/v1/fortnite/tournaments/live/{eventId}/{windowId} — Live Window Leaderboard: Get one live event window leaderboard. Params: eventId required example=epicgames_S37_FNCS; windowId required example=S37_FNCS_Event1.
- GET /api/v1/fortnite/tournaments/{id}/matches — Tournament Matches: Get match/session rows for a tournament. Params: id required example=fncs-major.
- GET /api/v1/fortnite/tournaments/{id}/results — Tournament Results: Get tournament result rows. Params: id required example=fncs-major.
- GET /api/v1/fortnite/tournaments/player/{identifier}/history — Player Tournament History: Get tournament history for a player. Params: identifier required example=bugha.
- GET /api/v1/fortnite/tournaments/org/{slug}/history — Org Tournament History: Get tournament history for an organization. Params: slug required example=xset.
- GET /api/v1/fortnite/players — List Players: Get all Fortnite competitive players.
- GET /api/v1/fortnite/players/top-earners — Top Earners: Get highest earning players.
- GET /api/v1/fortnite/players/lookup/{username} — Live Player Lookup: Look up an Epic account when available. Params: username required example=bugha.
- GET /api/v1/fortnite/players/{identifier} — Get Player: Get a specific player. Params: identifier required example=bugha.
- GET /api/v1/fortnite/players/{identifier}/earnings — Player Earnings: Get player earnings. Params: identifier required example=bugha.
- GET /api/v1/fortnite/orgs — Organizations: List Fortnite esports organizations.
- GET /api/v1/fortnite/orgs/{slug} — Organization Detail: Get an organization profile. Params: slug required example=xset.
- GET /api/v1/fortnite/orgs/{slug}/roster — Organization Roster: Get current pro/content creator roster with optional former members. Params: slug required example=xset; includeFormer example=true.
- GET /api/v1/fortnite/orgs/{slug}/former — Former Roster: Get former roster members for an organization. Params: slug required example=xset.
- GET /api/v1/fortnite/orgs/{slug}/earnings — Organization Earnings: Get organization earnings summary. Params: slug required example=xset.
- GET /api/v1/fortnite/orgs/{slug}/earnings/history — Org Earnings History: Get organization earnings history. Params: slug required example=xset.
- GET /api/v1/fortnite/creative/maps — Creative Maps: Search Fortnite Creative maps with media fields when indexed. Params: search example=zone wars.
- GET /api/v1/fortnite/creative/maps/trending — Trending Creative Maps: Get trending Creative maps with current metrics, thumbnails, creator metadata, and official Fortnite links. Params: limit example=10.
- GET /api/v1/fortnite/creative/maps/{code} — Creative Map Detail: Get one Creative map by island code with thumbnailUrl, imageUrl, fortniteUrl, and latest metrics. Params: code required example=1234-5678-9012.
- GET /api/v1/fortnite/creative/maps/{code}/history — Creative Map History: Get historical metric snapshots for a Creative map. Params: code required example=1234-5678-9012.
- GET /api/v1/fortnite/shop — Item Shop: Get the current Fortnite item shop.
- GET /api/v1/fortnite/cosmetics — Cosmetics: Search cosmetics. Params: search example=renegade.
- GET /api/v1/fortnite/news — News: Get Fortnite news. Params: mode example=br.

## QR Code
- GET /api/v1/qr/generate — Generate QR Code: Generate a QR code from a URL or text. Returns PNG binary, SVG string, or base64 JSON.. Params: data required example=https://citoapi.com; size example=400; format example=png; fg example=%23000000; bg example=%23ffffff; margin example=4; ec example=M.
- POST /api/v1/qr/generate — Generate QR Code with Logo: Generate a QR code with an embedded logo. Pass a base64 data URL in the logo.image field..

## TikTok
- POST /api/v1/transcript/tiktok — TikTok Transcript: Extract a transcript from any public TikTok video. Supports text, verbose (with timestamps), SRT, and VTT formats..

## Search
- GET /api/v1/search — Global Search: Search across all games. Params: q required example=optic.
- GET /api/v1/search/autocomplete — Autocomplete: Get search suggestions. Params: q required example=bug.
- GET /api/v1/search/stats — Database Stats: Get database statistics.
- GET /api/v1/health — Health Check: Check API status.