Access the world's most comprehensive gaming events database via our GraphQL API. Track esports tournaments, game releases, updates, and community events.
Get your API key from your dashboard at casthq.co/dashboard/settings/api-keys.
broadcast_sk_xxxxxxxxxxxxxxxxxxxxxxxxcurl https://api.casthq.co/graphql \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"query": "{ events(first: 10) { edges { node { id name slug startTime } } } }"
}'All API requests require authentication via API key in the Authorization header:
Authorization: Bearer broadcast_sk_your_api_key_hereSecurity: Never expose your API key in client-side code. Always make requests from your backend server.
API keys have configurable rate limits. Response headers indicate your current usage:
| Header | Description |
|---|---|
| X-RateLimit-Limit | Total requests allowed per time window |
| X-RateLimit-Remaining | Requests remaining in current window |
| X-RateLimit-Reset | Unix timestamp when limit resets |
Need higher limits? Contact us to upgrade your API tier for production use cases.
Find events by keyword, topic, or date range.
query SearchEvents {
searchEvents(
query: "World Championship"
first: 10
) {
edges {
node {
id
name
slug
startTime
endTime
description
topic {
name
slug
}
}
}
pageInfo {
hasNextPage
endCursor
}
}
}Fetch complete event information by slug or ID.
query GetEvent($slug: String!) {
eventBySlug(slug: $slug) {
id
name
slug
startTime
endTime
precision
description
eventType
topic {
id
name
slug
}
platform {
id
name
slug
}
tags {
tagKey
tagValue
}
}
}Browse all available topics (games, organizations, personalities).
query ListTopics {
topics(
first: 20
orderBy: { direction: DESC, field: FOLLOWERS_COUNT }
) {
edges {
node {
id
name
slug
description
followersCount
eventsCount
}
}
pageInfo {
hasNextPage
endCursor
}
}
}npm install graphql-requestimport { GraphQLClient } from 'graphql-request'
const client = new GraphQLClient(
'https://api.casthq.co/graphql',
{
headers: {
Authorization: 'Bearer YOUR_API_KEY'
}
}
)
const { events } = await client.request(`
query {
events(first: 10) {
edges {
node {
id
name
startTime
}
}
}
}
`)pip install gql[all]from gql import gql, Client
from gql.transport.requests import RequestsHTTPTransport
transport = RequestsHTTPTransport(
url='https://api.casthq.co/graphql',
headers={'Authorization': 'Bearer YOUR_API_KEY'}
)
client = Client(transport=transport)
query = gql('''
query {
events(first: 10) {
edges {
node {
id
name
startTime
}
}
}
}
''')
result = client.execute(query)