Build with Gratitude

Integrate appreciation into any platform. Open APIs that make gratitude a native part of your app, website, or service.

Production-ready APIs

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

🎨 Creator Tools

Creator Growth Tools

Help creators grow their audience and increase gratitude volume

Fan Relationship Tools

Build deeper connections through gratitude history

Monetization Widgets

Embed appreciation buttons in content platforms

🏢 Business Apps

Team Recognition

Build gratitude into Slack, Teams, internal tools

Customer Success

Let customers appreciate support teams directly

Service Platforms

Add tipping and appreciation to marketplaces

API Reference

Base URL

https://tysm.to/api/v1

GET/users/{handle}

Get public profile information for any TYSM user.

Request

curl https://tysm.to/api/v1/users/daniel \
  -H "Accept: application/json"

Response

{
  "handle": "daniel",
  "name": "Daniel Hakim",
  "bio": "Building gratitude infrastructure",
  "stats": {
    "tysmsSent": 42,
    "tysmsReceived": 37
  },
  "gratitudeAddress": "tysm.to/@daniel"
}

Coming Soon

POST/transactions

Send gratitude programmatically

GET/graph/{handle}

Query gratitude network data

POST/webhooks

Real-time gratitude notifications

GET/analytics

Gratitude insights and metrics

TypeScript SDK

Available now: Basic user queries • Coming soon: Full transaction APIs

Installation

npm install @tysm/sdk
# or
yarn add @tysm/sdk

Quick Start

import { TYSM } from '@tysm/sdk';

const tysm = new TYSM();
const profile = await tysm.users.get('daniel');

Full Example

import { TYSM } from '@tysm/sdk';

const tysm = new TYSM();

// Get user profile and stats
const profile = await tysm.users.get('daniel');
console.log(`${profile.name} has received ${profile.stats.tysmsReceived} TYSMs`);

// Coming soon: Send gratitude
// const result = await tysm.send({
//   to: '@daniel',
//   amount: 500, // $5.00 in cents
//   note: 'Thanks for the amazing API!',
//   metadata: { source: 'my-app' }
// });

// Coming soon: Listen for webhooks
// tysm.webhooks.on('gratitude.received', (event) => {
//   console.log('New gratitude received:', event.data);
// });

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,
  "avatarUrl": 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 →•Embeddable Widgets•Read Our Vision