Data Reference¶
Core models¶
| Model | Identity | Key fields |
|---|---|---|
| Game | game_* |
name, slug, release_date, publisher, categories, platforms |
| Store | store_* |
name, supported_regions, affiliate_supported |
| Offer | offer_* |
game_id, store_id, region, availability, purchase_url |
| Price | observation ID | amount, list_amount, currency, observed_at |
| Deal | deal_* |
offer_id, discount_percent, deal_score, valid_until |
| User | user_* |
display_name, created_at, preferences |
| Event | evt_* |
type, occurred_at, data, sequence |
Money.amount is a string with up to four decimal places; applications must use decimal arithmetic. Currency uses ISO 4217 values such as USD, EUR, and GBP. Region uses uppercase ISO 3166-1 alpha-2 values.
Enumerations¶
| Enum | Values |
|---|---|
| Availability | available, preorder, unavailable, unknown |
| Platform | windows, macos, linux |
| Alert status | active, paused, triggered, archived |
| Export status | queued, running, completed, failed, expired |
| Notification channel | email, webhook, in_app |
Relations: one game has many offers; an offer has many historical price observations; an active offer may yield one deal per region; a user owns many wishlist items, alerts, and notifications.