Skip to main content
All Qyren APIs are REST over HTTPS, JSON in and out. Authentication is a bearer token on every request.
Base URL: https://api.qyren.ai All endpoints are versioned under /v1/.

​
The endpoints

  • Events — POST /v1/ingest — send player telemetry.
  • Offers — import and manage your offer catalog.
  • Recommendations — POST /v1/recommend — ask what to show a player.
  • Economy — read economy metrics programmatically.
  • Billing — read current-period lift and invoice data.

​
Conventions

  • Timestamps: RFC 3339 / ISO 8601 with timezone, always UTC (e.g. 2026-04-13T10:00:00Z).
  • IDs: event IDs are ULIDs (26 chars, Crockford Base32). Player IDs and game IDs are opaque strings your studio controls.
  • Errors: JSON body with error, message, and (for ingestion) a details array.
  • Rate limits: 1,000 requests per second per API key. Raising the limit: email support.

​
Environments

  • Production: https://api.qyren.ai — keys start with qyr_live_.
  • Test: https://api-test.qyren.ai — keys start with qyr_test_. Data is isolated, does not affect billing, and is wiped every 30 days.
Check your dashboard for the actual endpoint URLs on any page that isn’t explicitly /v1/ingest or /v1/recommend — advanced or newer endpoints may vary.