API · store partner integration

List your prices.
Reach every buyer.

Pikorafy’s Store Partner API lets authorized retailers submit real-time game prices directly. Your offers appear in our comparison engine next to Steam, GOG, and every major store — sorted by trust score, never by who paid the most.

REST
Protocol
Free
For partners
500
Prices / request
60s
Cache TTL
Base URL
https://pikorafy.com/api/v1
Authentication

Authenticated endpoints require your store’s API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

API keys are issued after we audit your store. Apply below →

Endpoints

GET/api/v1/prices

Retrieve all current store offers for a game. Returns prices sorted cheapest first, from active partner stores only. Expired listings are automatically excluded.

Query parameters

steamIdstringrequiredSteam App ID of the game (e.g. 730 for CS2)
regionstringoptionalFilter by region: Global, EU, US, RoW
editionstringoptionalFilter by edition: Standard, Deluxe, Premium
currencystringoptionalCurrency code (default: USD)

Response

{
  "steamId": "730",
  "count": 3,
  "currency": "USD",
  "prices": [
    {
      "store": {
        "id":    "uuid",
        "name":  "Fanatical",
        "short": "FNT",
        "url":   "https://www.fanatical.com",
        "trust": 94
      },
      "salePrice":   11.99,
      "normalPrice": 19.99,
      "savings":     40,
      "currency":    "USD",
      "dealUrl":     "https://www.fanatical.com/game/cs2",
      "edition":     "Standard",
      "region":      "Global",
      "drm":         "Steam Key",
      "updatedAt":   "2026-05-13T10:00:00Z",
      "expiresAt":   null
    }
  ]
}
POST/api/v1/prices🔑 Auth required

Submit or update your store's price listings. Accepts up to 500 prices per request. Existing listings for the same (steamAppId + edition + region) combination are automatically updated (upsert).

Request body

{
  "prices": [
    {
      "steamAppId":   "730",           // required — Steam App ID
      "gameTitle":    "Counter-Strike 2",  // required
      "salePrice":    11.99,           // required — current sale price
      "normalPrice":  19.99,           // required — full MSRP
      "dealUrl":      "https://yourstore.com/cs2",  // required
      "edition":      "Standard",      // optional, default "Standard"
      "region":       "Global",        // optional, default "Global"
      "drm":          "Steam Key",     // optional, default "Steam Key"
      "currency":     "USD",           // optional, default "USD"
      "expiresAt":    "2026-06-01"     // optional — ISO 8601 date
    }
  ]
}

Response

{
  "accepted": 1,
  "rejected": 0,
  "errors":   []
}
DELETE/api/v1/prices🔑 Auth required

Remove your store's listings. Pass steamId to remove a single game, or omit it to remove all of your listings (full wipe).

Query parameters

steamIdstringoptionalSteam App ID to remove. Omit to remove all your listings.

Response

// Single game
{ "deleted": 2, "steamId": "730" }

// Full wipe (no steamId param)
{ "deleted": 847, "steamId": "all" }

Error codes

400Bad RequestMissing or invalid parameters
401UnauthorizedMissing or invalid API key
422UnprocessableAll submitted prices failed validation
429Rate limitedToo many requests — back off and retry
500Server errorDatabase or internal error; try again

Rate limits

Partner API keys have generous limits suitable for bulk price updates:

500

Prices per POST

Submit up to 500 game prices in a single request. Batch your updates for efficiency.

60s

Cache TTL

GET responses are cached for 60 seconds. Prices are effectively live for end users.

Upsert

No duplicates

Re-posting the same (steamId + edition + region) updates rather than creating duplicates.

Free

For partners

The API is completely free for authorized store partners. No tiers, no billing.

Quick start

Submit a price with curl:

curl -X POST https://pikorafy.com/api/v1/prices \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prices": [{
      "steamAppId":  "730",
      "gameTitle":   "Counter-Strike 2",
      "salePrice":   11.99,
      "normalPrice": 19.99,
      "dealUrl":     "https://yourstore.com/cs2",
      "edition":     "Standard",
      "region":      "Global"
    }]
  }'

Read prices for a game (no auth needed):

curl "https://pikorafy.com/api/v1/prices?steamId=730&region=Global"
Get access

Apply for a partner API key.

We audit every store before issuing a key — chargeback rate, refund policy, licensing. The process takes about three weeks and ends with a public trust score. Once approved, your prices appear in Pikorafy’s comparison engine immediately on submission.

✓ Free for authorized retailers✓ No revenue share✓ Trust score published
Apply by email →