canonical: https://jentic.com/apis/cheapshark.com/cheapshark

# CheapShark API

The CheapShark API aggregates PC game deals and prices across digital storefronts. It lists current deals, the stores it tracks, game lookups with price history, and price alerts, so a shopping tool can compare where a game is cheapest. The public endpoints require no key.

## For AI agents

Find PC game deals, compare prices across stores, look up games with price history, and manage price alerts.

## Scope

Does not handle purchasing, payment, or game downloads - use for finding and comparing PC game deals and prices only.

## Capabilities

- List current PC game deals filtered by store, price, and rating
- Compare a game's price across the tracked digital storefronts
- Look up a game and its price history by title or id
- List the stores CheapShark tracks
- Manage price alerts for a game

## Use cases

### Game deal comparison

A shopping tool needs to show where a PC game is cheapest right now. The CheapShark API lists current deals across storefronts so the tool can rank them by price and highlight the best offer.

Example prompt: Call GET /deals filtered by title and return the lowest-priced offer across stores

### Price history lookup

A wishlist feature needs a game's price history to judge whether a deal is good. The games operation returns a game with its historical low so a backend can flag genuine discounts.

Example prompt: Call GET /games for a title and compare the current deal against the historical low

### AI agent deal finder

An AI agent helping a shopper can find and compare game deals with no key to configure. Through Jentic the agent discovers the deals operation by intent and calls it directly.

Example prompt: Search Jentic for 'find current PC game deals', load the schema, and return the cheapest offer for a title

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| GET | `/deals` | List current game deals |
| GET | `/stores` | List tracked digital storefronts |
| GET | `/games` | Look up games and price history |
| GET | `/alerts` | Manage price alerts for a game |

## Key resources

- **Deals** — List current game deals filtered by store, price, and rating
- **Stores** — List the digital storefronts CheapShark tracks
- **Games** — Look up games and their price history
- **Alerts** — Manage price alerts for a game

## AI readiness

This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use.

- **Score:** 63 / 100
- **Maturity:** AI-Aware
- **Dimensions:**
  - Foundational Compliance: 93 / 100
  - Developer Experience & Jentic Compatibility: 56 / 100
  - AI-Readiness & Agent Experience: 44 / 100
  - Agent Usability: 94 / 100
  - Security: 100 / 100
  - AI Discoverability: 47 / 100
- **View full report:** https://jentic.com/apis/cheapshark.com/cheapshark/scorecard
- **How the score is calculated:** https://docs.jentic.com/reference/api-readiness-framework/overview/
- **More about the dimensions:** https://docs.jentic.com/reference/api-readiness-framework/specification/#dimensional-model-overview

### Score it yourself

Every API in the directory is allowlisted, so you can re-score it with no key required.

- **Score your own API:** https://jentic.com/scorecard.md
- **Scoring CLI agent skill:** https://github.com/jentic/jentic-api-scorecard/blob/main/skills/jentic-api-scorecard/SKILL.md

```sh
npx @jentic/api-scorecard-cli score <openapi-url>
```

## Why Jentic

- **Setup:** Wiring the CheapShark API by hand means shaping the deals, stores, and games query parameters and paging through results yourself. Through Jentic you install once, import the API from the API Directory, and your agent calls it.
- **Permission scoping:** The CheapShark API takes its inputs as query parameters rather than a resource id in the URL path, so you limit the agent to the operations it needs, such as listing deals or looking up a game. You credit the agent only with the operations you allow, so anything you have not granted stays out unless you add it.
- **Credential handling:** The CheapShark API needs no key, so there is no secret to manage. Jentic runs the calls from your own self-hosted instance, and no credential enters the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'find current PC game deals', and Jentic returns the matching operation with its input schema so the agent calls the right endpoint without browsing docs.

## Related APIs

- **Steam Web API** — Store and player data direct from Steam
- **FreeToGame API** — Catalog of free-to-play games to pair with deal data
- **RAWG Video Games API** — Game metadata, ratings, and artwork

## FAQ

### Does the CheapShark API require an API key?

No. The CheapShark public endpoints need no key, so there is no secret to manage. Through Jentic the calls run from your own self-hosted instance and no credential enters the agent's prompt, logs, or context.

### Is there a CheapShark MCP server?

You don't need an MCP server to give your agent the CheapShark API. Jentic connects it directly from the API Directory: import it and your agent calls it, with no key required. That keeps another server's tool definitions out of your agent's context while still giving it the operation set from the spec.

### Can the CheapShark API show a game's price history?

Yes. The GET /games operation returns a game with its historical low price, so a tool can judge whether a current deal is genuinely a discount.

### Can I limit what my agent is allowed to do with the CheapShark API?

Yes. Because you run Jentic One yourself, your own rules decide which CheapShark operations the agent may use. You grant only the operations it needs, such as listing deals, so anything you have not granted stays off limits unless you add it. The choice of what the agent may call is yours.

### How do I connect my agent to the CheapShark API through Jentic?

Search Jentic by intent such as 'find current PC game deals' to discover the operation, load its input schema, and your agent calls it with your stored credential injected at run time. To run it on your own infrastructure, install Jentic One from its GitHub repo.
