Getting started/Quick Start Guide

Quick Start Guide

Test the API in 30 seconds with our demo key, or sign up for free to get your own account API key.

30-Second Demo (No Signup Required)

Test the API instantly with our demo key. Copy-paste this into your terminal:

Upcoming UFC events:

Bash
curl -X GET "https://api.citoapi.com/api/v1/ufc/events/upcoming" \
  -H "x-api-key: pk_demo_cito_live_a06c129e0a9ce1c39c3035bd187541c4"

Expected Response:

json
{
  "success": true,
  "isLive": false,
  "count": 0,
  "data": []
}

Demo key limits: 50 calls/day, read-only, on a handful of list endpoints (UFC, CS2, League of Legends, tennis, Dota 2). If no CDL match is live, the request still succeeds and returns an empty data array. For all other products, get your own key (free tier: 500 calls/month).

Common Use Cases

"I'm building a Discord bot..."

Copy-paste for Discord.js:

javascript
// Get today's League of Legends schedule
const apiKey = process.env.CITO_API_KEY;
const stats = await fetch(
  'https://api.citoapi.com/api/v1/lol/schedule/today',
  { headers: { 'x-api-key': apiKey } }
);
const data = await stats.json();
message.channel.send(`Schedule loaded: ${data.success ? 'yes' : 'check response'}`);

"I need live tournament data..."

python
import os
import requests

data = requests.get(
    'https://api.citoapi.com/api/v1/lol/matches/live',
    headers={'x-api-key': os.environ['CITO_API_KEY']}
).json()

matches = data.get('data') or data.get('matches') or []
print(f"Live matches: {len(matches)}")

"I'm building a React/Next.js app..."

javascript
// app/api/live-matches/route.ts
export async function GET() {
  const response = await fetch('https://api.citoapi.com/api/v1/ufc/events/upcoming', {
    headers: { 'x-api-key': process.env.CITO_API_KEY }
  });

  return Response.json(await response.json());
}

Get Your Account API Key (Free)

Sign Up Free

Ready to go beyond the demo? Sign up for a free account to get 500 API calls per month for testing supported endpoints.

1

Create Account

Sign up for free at citoapi.com/signup. No credit card required.

2

Get API Key

After signup, copy your API key from the dashboard. It looks like: cito_abc123...

3

Start Building

Replace the demo key with your account API key. You now have 500 calls/month!

Environment Variable Setup:

bash
# Add to .env file
CITO_API_KEY="cito_your_key_here"

# Access in your code
const apiKey = process.env.CITO_API_KEY;

Use Any HTTP Client

Cito uses standard REST JSON, so you can start with the HTTP client you already use.

JavaScript/TypeScript

fetch / axios

Works in Node, Next.js routes, and workers

Python

requests / httpx

Use environment variables for API keys

Go

net/http

No generated client required

Want to try the API interactively?

Use our API Playground to test endpoints in your browser without writing any code.

Open Playground