GamesBerry API

https://gamesberry.app/api
Admin
GamesBerry API provides REST access to video game catalog data, revenue estimates, prices, ratings,...
Tokens:1,900
Snippets:17
Trust Score:2.9
Update:1 week ago
Show doc for...
Tokens:
Raw
### GET /api/v1/leaderboards

Source: https://gamesberry.app/api

Get top games by followers or review velocity, with momentum data.

```APIDOC
## GET /api/v1/leaderboards

### Description
Retrieve top games by followers (with 7-day momentum) or by review velocity.

### Method
GET

### Endpoint
/api/v1/leaderboards

### Parameters
#### Query Parameters
- **board** (string) - Optional - Choose between "followers" (default) or "momentum".
- **limit** (integer) - Optional - Maximum number of results (max 100).

### Request Example
(Not provided in source)

### Response
#### Success Response (200)
Returns leaderboard data, including estimated wishlists and related fields.

#### Response Example
(Not provided in source)

```

--------------------------------

### GET /api/v1/stores

Source: https://gamesberry.app/api

Get the list of stores tracked by the API, along with live game counts.

```APIDOC
## GET /api/v1/stores

### Description
Retrieve the list of tracked stores with live game counts.

### Method
GET

### Endpoint
/api/v1/stores

### Parameters
None.

### Request Example
(Not provided in source)

### Response
#### Success Response (200)
Returns a list of stores with live game counts.

#### Response Example
(Not provided in source)

```

--------------------------------

### Example API requests with curl

Source: https://gamesberry.app/api

Two example curl requests: the first fetches the top 5 Steam games by revenue, the second requests full detail for Elden Ring including historical series (requires a Pro key). Both pass the API key in the X-API-Key header.

```bash
curl -H "X-API-Key: gb_..." \
  "https://gamesberry.app/api/v1/games?store=steam&sort=revenue&per_page=5"
```

```bash
curl -H "X-API-Key: gb_..." \
  "https://gamesberry.app/api/v1/games/elden-ring?history=1"
```

--------------------------------

### GET /api/v1/tags

Source: https://gamesberry.app/api

Get genres and tags ranked by total, average, and median revenue.

```APIDOC
## GET /api/v1/tags

### Description
Retrieve genres/tags ranked by total, average, and median revenue.

### Method
GET

### Endpoint
/api/v1/tags

### Parameters
None.

### Request Example
(Not provided in source)

### Response
#### Success Response (200)
Returns a ranked list of genres/tags with revenue statistics.

#### Response Example
(Not provided in source)

```

--------------------------------

### GET /api/v1/search

Source: https://gamesberry.app/api

Perform a cross-store search for games using a query string.

```APIDOC
## GET /api/v1/search

### Description
Perform a cross-store search for games.

### Method
GET

### Endpoint
/api/v1/search

### Parameters
#### Query Parameters
- **q** (string) - Required - Query string, minimum 2 characters.

### Request Example
(Not provided in source)

### Response
#### Success Response (200)
Returns search results across all stores.

#### Response Example
(Not provided in source)

```

--------------------------------

### GET /api/v1/games/{slug}

Source: https://gamesberry.app/api

Get detailed information for a single game by its slug, optionally including historical data.

```APIDOC
## GET /api/v1/games/{slug}

### Description
Retrieve full detail for a single game, including prices, ratings, followers, and estimate range. Optionally include historical time series with a Pro key.

### Method
GET

### Endpoint
/api/v1/games/{slug}

### Path Parameters
- **slug** (string) - Required - The game's unique slug (e.g., "elden-ring").

### Query Parameters
- **history** (integer) - Optional - Set to 1 to include price, follower, and monthly revenue time series (Pro key required).

### Request Example
```
curl -H "X-API-Key: gb_..." \
  "https://gamesberry.app/api/v1/games/elden-ring?history=1"
```

### Response
#### Success Response (200)
Returns full details for the game, including prices, ratings, followers, and estimate range.

#### Response Example
(Not provided in source)

```

--------------------------------

### GET /api/v1/games

Source: https://gamesberry.app/api

Retrieve a paginated list of games with revenue estimates, filterable by store, sorting, and various attributes.

```APIDOC
## GET /api/v1/games

### Description
Retrieve a paginated list of games with revenue estimates.

### Method
GET

### Endpoint
/api/v1/games

### Parameters
#### Query Parameters
- **store** (string) - Optional - Store to filter by: steam (default), gog, epic, apple, xbox, gplay, psn, nintendo.
- **sort** (string) - Optional - Sort by revenue, reviews, or release.
- **order** (string) - Optional - Sort order: asc or desc.
- **page** (integer) - Optional - Page number for pagination.
- **per_page** (integer) - Optional - Number of items per page (max 100).
- **free** (integer) - Optional - Set to 1 to filter free games.
- **paid** (integer) - Optional - Set to 1 to filter paid games.
- **on_sale** (integer) - Optional - Set to 1 to filter games on sale.
- **upcoming** (integer) - Optional - Set to 1 to filter upcoming games.
- **year** (integer) - Optional - Filter by release year, e.g., 2026.
- **min_score** (integer) - Optional - Minimum review score, e.g., 80.

### Request Example
```
curl -H "X-API-Key: gb_..." \
  "https://gamesberry.app/api/v1/games?store=steam&sort=revenue&per_page=5"
```

### Response
#### Success Response (200)
Returns a paginated list of games with revenue estimates.

#### Response Example
(Not provided in source)

```
Tokens:
Raw