Getting Started
Thanks for being a GDCo API user — or being in the process of evaluating our API!
Authentication
Your company needs GraphQL API access and an issued API token. To request access or credentials, email contact@gamediscover.co.
Send requests to https://api.gamediscover.co/graphql with your token in the
Authorization header:
Authorization: Bearer <YOUR_API_TOKEN>
For example, replace <YOUR_API_TOKEN> with your issued token:
curl 'https://api.gamediscover.co/graphql' \
--header 'Authorization: Bearer <YOUR_API_TOKEN>' \
--header 'Content-Type: application/json' \
--data '{"query":"query { steamApps(first: 1) { edges { node { appid name } } } }"}'
In the GraphQL explorer, enter the token in the API Token field before exploring the schema or running queries.
GraphQL API credentials are separate from the MCP server's browser-based OAuth. Signing in to the GameDiscoverCo website or connecting an MCP client does not replace the API token required for direct GraphQL requests. Keep tokens private; do not publish them or include them in shared examples.
Explore the schema
When you start out, we recommend you go to the GraphQL explorer and then click on Docs and then Query. This describes a number of the key query types. You'll need to build queries or grab from the common examples.
Choose your data
If you're just looking for Steam data, you'll want to be looking in steamApps.
Each Steam game entry (listed by appid) has a lot of attributes attached to it.
If you're looking for multiplatform information, also including Xbox,
PlayStation and Switch, gdcoApps is our starting point for querying per game,
and you can drill down from there. There is extra data at the appPlatforms level.
Demo and DLC data
Demo and DLC data can be queried from the main Steam app or through dedicated fields:
- On each
steamAppsnode:currentDemo,demos, anddlcs. - Dedicated queries:
steamDemos,steamDemo,steamDlcs, andsteamDlc.
See Steam demo data, top Steam demos by CCU, and Steam DLC data for examples.
Before requesting larger datasets, read about Relay pagination and rate limits.
Need help?
If you're having any trouble, please ping us on Discord or via contact@gamediscover.co.