← Developers
Start here
QuickstartSDKAuthentication
Identity
Sign in with Shin ID
Access
EntitlementsUsage & Qualified Active Days
Money
Purchases & refundsWebhooksVerifying signatures
Selling
Importing a productGitHub importSelling without the SDKCurrencies and pricingBuy with Guiru from your own site
Operating
Integration diagnosticsErrors & rate limitsTestingMobile API
Reference
ReferenceVersioning & changesFor agents
Machine-readable
llms.txt
Access

Usage & Qualified Active Days

Three generic signals. No feature events, no payloads about what happened inside.

POST/api/v1/usage
auth · gat_… or gk_live_…

{ "kind": "session" | "heartbeat" | "activity" } with the person's access token, or { "user_id": "<uuid>", "kind": … } with your API key

Careful

Only usage sent with the person's own access token — from your app, not your server — counts toward Qualified Active Days. Sent with your API key it is kept for your analytics and answered qualifying: false: a user id is not a secret, so a server naming one is not evidence that the person was there. People on your own team never count on your own product.

kind
sessionthe app opened
Cheap to send, and on its own it never qualifies a day. Opening something is not using it.
heartbeatstill in use
Send while the person is actually working, not on a timer that runs against an idle window.
activitythey did the thing
Whatever counts as real use in your product: a render, a save, a message sent. You decide what the bar is; we never ask what it was.

Deduplicated per person × product × day downstream. Calling every thirty seconds is safe; it is also worth nothing more than calling once.

What it feeds

Qualified Active Days are the unit behind two things that pay or promote: the Creator Pool split, which divides Member revenue by verified use rather than by negotiation, and the GSP seal, which a product cannot earn without them. A product that never reports usage can still be listed, sold and included — it just cannot be shown to have succeeded.

Careful

We do not accept custom event names or properties, and there is no endpoint that would take them. If you want product analytics, use a product analytics tool — this is evidence, not telemetry.

PreviousEntitlementsNextPurchases & refunds
Guiru
AboutStoreHow Guiru worksQuality BarGSPGuiru MemberStatus
Buying
Buy with GuiruYour libraryRefundsBuyer termsTrust & safety
Builders
For buildersSubmit a productGuiru ProPricing & feesPromoteDeveloper docs
Help
Help centreYour libraryBuying & refundsHow a product gets listedHow ranking worksReport a problem
Legal
All policiesTermsPrivacyCookiesCreator PoolAffiliate disclosure
Your account
Account settingsSign in
Shin AI
Shin WebsiteKatsuiTrouble? Message Mario
Find your next favourite. Software, games and digital products on Guiru.Guiru Beta · Feedback© 2026 Shinai Tecnologias I.S.
Beta
StoreLibraryBuildersMember
Sign in
StoreSearchLibraryMemberSign in