---
title: "Get Publishers"
method: GET
path: "/api/publishers"
tags: ["catalog"]
---

# Get Publishers

`GET /api/publishers`

## Request

- Base URL: `https://api.getcheapgames.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.getcheapgames.com/api/publishers`
- Auth: none declared

A page of publishers we can price a game for, ordered 0-9 then A-Z.

Filters narrow both the list and each card's count, so a card that says
nine games opens onto nine games.

Paged for the reason the franchise index was: this returned every row on
every load — 185 of them, each carrying a logo lookup — so the page paid
for the whole list to show two dozen tiles.

`limit` stays optional so the sitemap can still ask for every row in one
call; the paging headers are only meaningful when it is set.

## Query parameters

- `limit` integer, nullable
- `offset` integer: How many rows to skip
- `on_sale` boolean: Only offers marked down by their store
- `stores` string[], nullable: Store codes
- `platforms` string[], nullable: Canonical platforms
- `genres` string[], nullable: Steam genre descriptions
- `regions` string[], nullable: Offer regions
- `types` string[], nullable: game, dlc, pass, soundtrack or free; anything else is ignored
- `country` string, nullable: ISO country code; its currency is used
- `currency` string, nullable: One of EUR, GBP, USD, CAD, CHF, DKK, SEK, NOK, PLN, CZK, HUF, BRL, MXN, CLP, COP, PEN, CRC, UYU, GTQ

## Response `200`

Successful Response

- PublisherOut[]
  - `slug` string, required
  - `name` string, required
  - `games` integer, required
  - `logo` string, nullable
  - `logoDark` boolean

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/getcheapgames/apis/getcheapgames-api.md) · [All operations](https://skmtc.dev/getcheapgames/apis/getcheapgames-api/llms.txt) · [OpenAPI document](https://skmtc.dev/getcheapgames/apis/getcheapgames-api/revisions/962824bb76da?raw)