API Documentation

Access your press kit data programmatically with the MyPressKit API.

Authentication

All API requests require a valid API key. Create one from your API settings page. API access requires an active Pro subscription.

Include your API key in the Authorization header:

Authorization: Bearer mpk_your_token_here

Rate Limiting

API requests are limited to 60 requests per minute per IP address. If you exceed this limit, you'll receive a 429 response with a Retry-After header.

Endpoints

GET/api/v1/games

List your published games. Requires read scope.

Query Parameters

limit — Number of results (1-100, default 20)

offset — Pagination offset (default 0)

Example

curl -H "Authorization: Bearer mpk_your_token" \
  https://mypresskit.io/api/v1/games?limit=10

GET/api/v1/games/:id

Get full game details including features, awards, press mentions, and team info. Requires read scope.

Example

curl -H "Authorization: Bearer mpk_your_token" \
  https://mypresskit.io/api/v1/games/GAME_ID

GET/api/v1/games/:id/media

Get media assets with download URLs. Requires read scope.

Query Parameters

type — Filter by type: screenshot, logo, or artwork

Example

curl -H "Authorization: Bearer mpk_your_token" \
  https://mypresskit.io/api/v1/games/GAME_ID/media?type=screenshot

GET/api/v1/games/:id/analytics

Get analytics data for a game. Requires analytics scope.

Query Parameters

days — Number of days to look back (1-365, default 30)

Example

curl -H "Authorization: Bearer mpk_your_token" \
  https://mypresskit.io/api/v1/games/GAME_ID/analytics?days=7

Error Codes

401Missing or invalid API key

403Insufficient scope or no active Pro subscription

404Resource not found or doesn't belong to your account

429Rate limit exceeded

JavaScript Example

const DEV_TOKEN = 'mpk_your_token_here'

const response = await fetch('https://mypresskit.io/api/v1/games', {
  headers: {
    'Authorization': `Bearer ${DEV_TOKEN}`
  }
})

const { data, pagination } = await response.json()
console.log(`Found ${pagination.total} games`)

for (const game of data) {
  console.log(`${game.title} (${game.slug})`)
}