Skip to main content

Python SDK for Cito API - Call of Duty & Fortnite Esports Data

Project description

Cito API - Python SDK

Official Python SDK for Cito API - the esports data API for Call of Duty and Fortnite.

Installation

pip install cito-api

Quick Start

from cito_api import CitoAPI

# Initialize with your API key
api = CitoAPI("your-api-key")

# Get COD players
players = api.cod.get_players(limit=10)
print(players)

# Get a specific player
player = api.cod.get_player("Shotzzy")
print(player)

# Get CDL standings
standings = api.cod.get_cdl_standings()
print(standings)

Features

Call of Duty Esports

  • Players: Get player profiles, stats, earnings, and career history
  • Teams: CDL franchises, rosters, tournament results
  • Tournaments: CDL Majors, Challengers events, match results
  • Transfers: Roster moves and player transfers
  • CDL Live: Real-time standings, schedules, live matches
  • Leaderboards: Earnings, K/D, hardpoint time, S&D stats

Fortnite Esports

  • Players: Pro player profiles and earnings
  • Organizations: Team rosters and results
  • Tournaments: FNCS, cash cups, and major events
  • Transfers: Roster changes

API Reference

COD Endpoints

# Players
api.cod.get_players(limit=50, nationality="US", team="optic")
api.cod.get_player("player-id")
api.cod.get_player_earnings("player-id")
api.cod.get_player_stats("player-id", season="2024")

# Teams
api.cod.get_teams(limit=50, franchise_only=True)
api.cod.get_team("optic-texas")
api.cod.get_team_roster("optic-texas")
api.cod.get_team_results("optic-texas")

# Tournaments
api.cod.get_tournaments(game="bo6", tier="S")
api.cod.get_tournament("tournament-id")
api.cod.get_tournament_results("tournament-id")
api.cod.get_tournament_matches("tournament-id")

# Transfers
api.cod.get_transfers(type="transfer")

# CDL
api.cod.get_cdl_standings()
api.cod.get_cdl_schedule(upcoming=True)
api.cod.get_cdl_live()

# Leaderboards
api.cod.get_earnings_leaderboard(limit=100)
api.cod.get_leaderboard("hardpoint")
api.cod.get_leaderboard("snd")
api.cod.get_leaderboard("kd")

# Search
api.cod.search("Shotzzy", type="players")

Fortnite Endpoints

api.fortnite.get_players(limit=50)
api.fortnite.get_player("player-id")
api.fortnite.get_teams()
api.fortnite.get_tournaments()
api.fortnite.search("Bugha")

Get Your API Key

Sign up at citoapi.com to get your free API key.

Links

License

MIT License

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

cito_api-1.0.0.tar.gz (5.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

cito_api-1.0.0-py3-none-any.whl (5.4 kB view details)

Uploaded Python 3

File details

Details for the file cito_api-1.0.0.tar.gz.

File metadata

  • Download URL: cito_api-1.0.0.tar.gz
  • Upload date:
  • Size: 5.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.7

File hashes

Hashes for cito_api-1.0.0.tar.gz
Algorithm Hash digest
SHA256 48f2eff26455cbaa58761710658951bfa97a224d8e2cd598a88a290d3200dbce
MD5 9054f6003193f2a2c6ea31f902c7eab2
BLAKE2b-256 783810b6a1660f8820b87506bb9e27802eb28dc9ea673eb786fc972e15ebf302

See more details on using hashes here.

File details

Details for the file cito_api-1.0.0-py3-none-any.whl.

File metadata

  • Download URL: cito_api-1.0.0-py3-none-any.whl
  • Upload date:
  • Size: 5.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.7

File hashes

Hashes for cito_api-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 471643965973e8d0f55374ed23d4d47cb2bb7b3981fc6a3ecb206a9576a5e9f1
MD5 ba92ff3b0f7c00a832ff0cd1a586f025
BLAKE2b-256 71d76180a4fa422bcdeeb6dca7595db09ab2d1f7be680ba0b17ee05f749fd914

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page