Build on the Gratitude Layer

APIs, SDKs, Gratitude URL Standard. Integration into wallets, apps, fintech platforms.Build the future of appreciation.

Production-Ready APIs

JavaScript SDK & Components

Growing Integration Support

Why Build with Gratitude?

APIs → Gratitude Everywhere

Make appreciation a core feature of your platform. Transform empty engagement into meaningful connections that actually matter to your users.

Meaningful

Replace hollow likes with real appreciation.

Simple

RESTful APIs, clear docs, TypeScript SDK.

Secure

Privacy by default, enterprise-grade security.

What You Can Build

🏢 Business Infrastructure

Team Attribution System

Route gratitude to specific team members with automatic splits

tysm.to/@restaurant/sarah

Location Routing

Multi-location business support with attribution

tysm.to/@chain?location=downtown

Service Attribution

Service-specific gratitude collection

tysm.to/@hotel?service=housekeeping

🎨 Creator Economy

Support Tier Widgets

Coffee, meal, month tiers for sustainable creator income

85% creator revenue share

Fan Engagement

Milestone tracking and supporter recognition

Real-time goal progress

Platform Integration

YouTube, Instagram, TikTok, website embeds

Universal compatibility

🏢 Enterprise Solutions

Org-Wide Handles

Company-wide gratitude address management

@company.employee

Bulk Onboarding

CSV import and automatic handle generation

Department-based routing

White-Label Ready

Custom branding and SSO integration

Enterprise security

Complete API Ecosystem

Base URL

https://tysm.to/api

Core APIs

GET/users/{handle}

Get public profile and gratitude stats

POST/transactions

Send gratitude programmatically

GET/qr

Generate dynamic QR codes

Business APIs

POST/business/qr

Team QR routing & location attribution

POST/business/embed

Team attribution widgets & service cards

GET/business/analytics

Team performance & customer insights

Creator APIs

POST/creators/embed

Support tier widgets & fan engagement

GET/creators/earnings

Revenue tracking & payout management

POST/creators/milestones

Goal tracking & fan milestone systems

Enterprise APIs

POST/enterprise/handles

Org-wide handle management & bulk onboarding

GET/enterprise/analytics

Department insights & culture metrics

POST/enterprise/white-label

Custom branding & SSO integration

Integration APIs

GET/qr

Dynamic QR code generation

GET/embed/stats

Widget performance analytics

POST/analytics/track

Event tracking & attribution

Complete SDK Ecosystem

JavaScript SDK

✅ Available now: Complete widget system with business, creator, and enterprise support

Installation

<script src="https://tysm.to/sdk/tysm.js"></script>

Universal Widgets

// Basic widget
<div data-tysm-handle="daniel"></div>

// Business team widget
<div data-tysm-business="restaurant" 
     data-tysm-team="sarah,mike,jenny"
     data-tysm-split="equal"></div>

// Creator support tiers
<div data-tysm-creator="artist" 
     data-tysm-tiers="Coffee:500,Meal:1500,Month:2500"
     data-tysm-theme="creator"></div>

React Components

🚀 New: Professional React component library with TypeScript support

Installation

npm install @tysm/react

Components

import { 
  TYSMButton, 
  BusinessTeamWidget,
  CreatorSupportTiers,
  EnterpriseRecognitionWidget 
} from '@tysm/react';

// Basic button
<TYSMButton handle="daniel" />

// Business team widget
<BusinessTeamWidget 
  business="restaurant" 
  team={teamMembers} 
  splitMode="equal" />

// Creator support tiers
<CreatorSupportTiers 
  creator="artist" 
  tiers={supportTiers} />

Real Developer Use Cases

🎯 SaaS Dashboard Integration

Let customers appreciate your support team directly in your app.

// When support ticket is resolved
const supportAgent = await tysm.users.get('sarah-support');
showGratitudeButton({
  recipient: supportAgent.handle,
  context: 'Excellent support resolution',
  suggestedAmount: 5.00
});

📝 Content Platform Integration

Add appreciation buttons to articles, posts, and creator content.

// At the end of blog posts
const author = await tysm.users.get(post.authorHandle);
renderAppreciationWidget({
  author: author.handle,
  content: post.title,
  suggestedAmount: 3.00,
  note: 'Supporting quality writing'
});

🛍️ E-commerce Integration

Let customers appreciate sellers and delivery drivers.

// After successful delivery
const driver = await tysm.users.get(order.driverHandle);
showAppreciationPrompt({
  recipient: driver.handle,
  context: 'Fast and careful delivery',
  suggestedAmount: 4.00
});

Available Today

GET/api/v1/users/{handle}

Get public profile data for any TYSM user. Perfect for building user discovery, appreciation analytics, or gratitude network visualizations.

Live Example

fetch('https://tysm.to/api/v1/users/daniel')
  .then(r => r.json())
  .then(user => {
    console.log(`${user.name} has received ${user.stats.tysmsReceived} TYSMs`);
  });

Response Schema

{
  "handle": string,
  "name": string,
  "bio": string | null,
  "image": string | null,
  "isPublic": boolean,
  "stats": {
    "tysmsSent": number,
    "tysmsReceived": number
  },
  "gratitudeAddress": string
}

Developer Resources

Rate Limits

1000 requests/hour for public endpoints

Privacy First

Only public data exposed, user consent required

Open Infrastructure

Open source components; see licenses on GitHub.

Email Notifications

Beautiful emails for gratitude events

Preview Emails

Start Building Today

Join developers building the gratitude layer of the internet. Start with our public APIs, shape the future of digital appreciation— from simple integrations to cross-platform gratitude networks.

Try the API Request Early Access

RFC Specification →•Integration Hub•Read Our Vision