mod.io API

Name: mod.io API
Brand: mod.io API
Availability: InStock

✓ Official Vendor SpecMediaContent DeliveryapiKey, oauth227 EndpointsREST

Install Jentic One Beta

Connect the mod.io API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the mod.io API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with mod.io API.

Authenticate players via Steam, Xbox, PSN, Switch, or Oculus through the /external/* endpoints

Browse the catalogue of supported games and their attached mods via /games and /games/{game_id}/mods

Retrieve a specific mod's metadata and downloadable files

GET STARTED

Start building with mod.io API

Explore with Jentic

View OpenAPI Document

For Agents

Browse and manage mods, files, comments, and subscriptions on mod.io across 27 endpoints, with platform-specific auth for Steam, Xbox, PSN, Switch, and Oculus.

Use for: I need to list all mods for a specific mod.io game, Get the details of a single mod by ID, Authenticate a Steam player against mod.io, Authenticate an Xbox player against mod.io

Not supported: Does not handle game distribution, payment processing, or matchmaking — use for mod hosting, moderation, and platform-bound mod authentication only.

mod.io is a cross-platform user-generated-content service for game developers, providing mod hosting, security scanning, content moderation, and SDK integration so player-made mods can be discovered and installed inside games on PC and consoles. The API exposes 27 endpoints under https://api.mod.io/v1 covering authentication, games, mods, files, comments, users, and subscriptions, plus platform-specific external auth flows for Steam, Xbox, PSN, Switch, and Oculus. Authentication supports an api_key query parameter for read-only access and OAuth 2.0 for user-context operations.

Use Cases

Patterns agents use mod.io API for, with concrete tasks.

★ In-game mod browser

Game studios call /games/{game_id}/mods to render an in-game mod browser tailored to the title, then drill into /games/{game_id}/mods/{mod_id} for the detail view and file downloads. The catalogue is filtered server-side by game ID so each title sees only its own mods, and pagination keeps the in-game UI responsive.

GET /games/{game_id}/mods with sort='-popular' and pagesize=20, render the results in the in-game UI, then GET /games/{game_id}/mods/{mod_id} when the user opens a mod detail page.

Cross-platform player authentication

When a player launches a game, the title exchanges the platform identity token for a mod.io session via the relevant /external endpoint — /external/steamauth on Steam, /external/xboxauth on Xbox, /external/psnauth on PSN, /external/switchauth on Switch, or /external/oculusauth on Meta Quest. The pattern lets the studio offer a single mod experience across consoles without managing platform credentials directly.

Submit the Steam ticket to /external/steamauth, capture the returned mod.io OAuth token, and use it to call /authenticate/terms for the player.

Mod subscription and content moderation

Players subscribe to mods so the game client keeps installs current, while community moderators read and act on /comments to keep a mod's discussion healthy. Together the subscription and comment endpoints let a studio offer the full UGC loop — discover, install, discuss, moderate — without building it from scratch.

POST a subscription on the user's behalf for mod_id 99 in game_id 7, then GET /games/7/mods/99/comments for moderation review.

Agent integration via Jentic

An AI assistant for a studio's community team can search Jentic for 'list mods for a mod.io game', load the /games/{game_id}/mods schema, and execute the call without exposing the api_key or OAuth token. The agent can then chain into mod detail and comments endpoints to summarise top community feedback.

Search Jentic for 'list mods for a mod.io game', load the /games/{game_id}/mods schema, execute it for game_id 7, and summarise the top 10 mods by recent activity.

Key Endpoints

27 endpoints — mod.

METHOD

PATH

DESCRIPTION

POST

/authenticate/terms

Accept the mod.io terms of service

POST

/external/steamauth

Authenticate a Steam player

POST

/external/xboxauth

Authenticate an Xbox player

POST

/external/psnauth

Authenticate a PSN player

GET

/games

List games on mod.io

GET

/games/{game_id}

Get a specific game

GET

/games/{game_id}/mods

List mods for a game

GET

/games/{game_id}/mods/{mod_id}

Get a specific mod

POST

/authenticate/terms

Accept the mod.io terms of service

POST

/external/steamauth

Authenticate a Steam player

POST

/external/xboxauth

Authenticate an Xbox player

POST

/external/psnauth

Authenticate a PSN player

GET

/games

List games on mod.io

Why Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

mod.io api_key values and per-player OAuth tokens are stored in the Jentic MAXsystem vault. The agent never sees the raw key or token; Jentic injects them at execution time, scoped to the operation being called.

Intent-based discovery

Agents search Jentic for intents like 'list mods for a mod.io game' or 'authenticate a Steam player on mod.io' and Jentic returns the matching /v1 operation with its input schema, including platform-specific auth payloads.

Time to first call

Direct mod.io integration: 2-4 days to wire api_key plus per-platform OAuth flows and the 27 endpoints. Through Jentic: under 1 hour for the first call once credentials are vaulted.

FAQs

Specific to using mod.io API through Jentic.

What authentication does the mod.io API use?

Read-only calls accept an api_key query parameter, while user-context calls use OAuth 2.0 obtained from the /external/* platform auth endpoints (Steam, Xbox, PSN, Switch, Oculus). Through Jentic the api_key and OAuth tokens are stored in the MAXsystem vault and injected automatically.

Can I authenticate a Steam player against mod.io?

Yes. POST the Steam ticket to /external/steamauth and mod.io returns an OAuth token tied to the player's mod.io identity. Equivalent endpoints exist at /external/xboxauth, /external/psnauth, /external/switchauth, and /external/oculusauth for the other platforms.

What are the rate limits for the mod.io API?

mod.io publishes a per-API-key rate limit on its developer documentation rather than in the OpenAPI specification. Treat HTTP 429 as the back-off signal and consult docs.mod.io for the current limit by tier.

How do I list mods for a game through Jentic?

Run pip install jentic, search Jentic for 'list mods for a mod.io game', load the /games/{game_id}/mods schema, and execute it with the game_id. Jentic injects the api_key automatically and returns the paginated mod list.

Can I subscribe a user to a mod via the API?

Yes. With a valid OAuth token from one of the /external auth flows you can call the subscription endpoints to subscribe and unsubscribe the user from specific mods, which keeps installs synchronised across the player's devices.

Is the mod.io API free to use?

mod.io offers a free tier for indie developers with paid plans for higher-volume titles and console support. Confirm current pricing on mod.io. Get started with Jentic at https://app.jentic.com/sign-up.

mod.io API

Connect the mod.io API to your agent

Capabilities

Start building with mod.io API

Use Cases

Key Endpoints

Why Jentic?

Related APIs

FAQs