Skip to main content

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 steamApps node: currentDemo, demos, and dlcs.
  • Dedicated queries: steamDemos, steamDemo, steamDlcs, and steamDlc.

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.