Embed Skillprint
Launch the marketplace in an iframe or mobile webview using a signed authentication URL.
Developer platform · API · SDK · Embed
Build human performance into your product.
Integrate Skillprint's game intelligence, cognitive insights, mood signals and player analytics with a focused API and an embeddable experience. This page gives you the shape of the system; the documentation gives you every detail.
Partner approval and an API key are required before you can call the platform.
Integration paths
Choose the level of control you need.
Start with the embeddable experience for speed, use the REST API for full product control, or combine both.
Use the REST API
Build native discovery, recommendations, profiles, dashboards and session reporting.
Connect the SDK
Install the package, create a session and render your first evaluated experience.
Integration flow
Four steps from first request to usable intelligence.
Skillprint connects discovery, gameplay, telemetry, analysis and product feedback in a repeatable loop.
Read the quickstart01
Connect Skillprint
Authenticate with a partner API key or a user token, then retrieve the game catalog.
Api-Key · X-Auth-Token02
Collect gameplay signals
Render the catalog natively or load the marketplace in an authenticated iframe or webview, and capture the session.
catalog · sessions03
Process and analyse the session
Submit telemetry for processing. Skillprint maps behaviour to mood, cognition and personality.
POST telemetry04
Use the resulting intelligence
Read profiles, progression and recommendations, then adapt the experience around the person.
profiles · analyticsYour first request
Store the key, then ask for the catalog.
Keep the credential server-side and expose it only through secure environment variables. Send it in the Authorization header using the Api-Key prefix.
GET /games/api/catalog/
import requests
response = requests.get(
"https://qa-marketplace.skillprint.co/games/api/catalog/",
headers={"Authorization": "Api-Key your_partner_api_key"},
)
print(response.json())GET /games/api/catalog/
curl -H 'Authorization: Api-Key YOUR_KEY' \
https://qa-marketplace.skillprint.co/games/api/catalog/GET /games/api/catalog/
const response = await fetch("https://qa-marketplace.skillprint.co/games/api/catalog/", {
headers: { "Authorization": "Api-Key YOUR_KEY" },
});
console.log(await response.json());Install the SDK
Install the package, create a session and render your first evaluated experience.
terminal
npm install @skillprint/sdkEmbed the experience
Create the authenticated discover URL server-side, then accept postMessage events only from the exact Skillprint origin your environment uses.
skillprint-embed.js
const url = new URL("https://qa-marketplace.skillprint.co/discover");
url.searchParams.set("auth_token", userToken);
frame.src = url;Authentication
Use the credential that matches the actor.
Partner API keys cover organisation-level access. User tokens cover personalised player data. Never place a partner key in a public client bundle.
Partner API key
OrganisationUse forOrganisation sessions, catalog access and partner-scoped reporting
Header
AuthorizationFormat
Api-Key <key>ScopeApproved partner data
User token
PlayerUse forFavourites, recommendations, profiles and user-specific progression
Header
X-Auth-TokenFormat
Token <token>ScopeAuthenticated user
API reference
Representative endpoints.
Base URL qa-marketplace.skillprint.co, JSON responses, API version v1. The full reference, error codes and executable samples live in the documentation.
| Endpoint | What it returns | Credential |
|---|---|---|
GET /games/api/catalog/ | Available games and their mapped dimensions | API key or approved origin |
GET /games/api/sessions/ | Sessions visible to the current user or partner | User token or partner API key |
GET /scoring/api/profiles/ | The authenticated user's Skillprint profile | User token |
POST /games/api/telemetry | Accepts session telemetry for processing and analysis | Partner API key |
GET /partners/api/partner-sessions/ | Partner-scoped session reporting | Partner API key |
Data model
The objects you will work with.
Skillprint links games, psychological dimensions, sessions, player profiles and progression analytics into one measurable system.
Games
Catalog items with mechanics, categories, skills, target moods, difficulty and launch metadata.
Sessions
Time-bounded player activity with game details, duration, telemetry, media and measured outputs.
Profiles
Aggregated player-level skill, mood, flow, confidence, history and recommendation context.
M
MoodDesired and achieved states such as focus, relaxation, energy and emotional balance.
C
CognitionPattern matching, attention, memory, reasoning, planning, reaction and related abilities.
P
PersonalityStable traits and preferences that help interpret engagement and individual differences.
Before you ship
Security baseline.
Four things the documentation asks every partner integration to get right.
01
Origin validationAccept
postMessage events only from the exact Skillprint origin used by your environment.02
Credential handlingCreate short-lived user access server-side. Do not expose partner API keys through query parameters.
03
Transport and errorsUse HTTPS, handle 401 and 403 responses explicitly, and rotate compromised keys immediately.
04
Responsive containerTest the embedded experience across mobile safe areas, keyboard states and desktop breakpoints.
Partner access
Register your application to get a key.
Partner approval, an API key and the origin or application that will host the Skillprint experience are required before you can go live. Contact the team to confirm access and register your allowed CORS origins.
Enterprise and AI-lab enquiries go through the contact page.
