---
title: "Lookup Publisher"
method: GET
path: "/api/publishers/lookup"
tags: ["catalog"]
---

# Lookup Publisher

`GET /api/publishers/lookup`

## 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/lookup`
- Auth: none declared

ONE publisher by name or any spelling aliased to it, with its logo.

Matched the way the feeds are grouped (`catalog.find_publisher`), and
unlike `/publishers` it does not need a game we can price: the release
cards ask for the logo of a studio we may never have sold anything of.
404 for a name we do not hold; the card kit then adds it with
`python -m gcg.cli publisher-logo`.

Five minutes in a cache, the logo's own lifetime (`publisher_logos`), so a
logo just uploaded shows within the time the file itself would.

## Query parameters

- `name` string, required: A name or alias

## Response `200`

Successful Response

- PublisherLookupOut: One publisher found by name, for tools that want its logo (`/publishers/lookup`). No game count: the lookup finds a studio whether or not we sell a game of it, so a count would be a second query for a number nobody asked for.
  - `slug` string, required
  - `name` string, 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/57333a690301?raw)