Donatty public API: your own bot for tips and goals
Your channel's tips, goals and tipper leaderboard can now be pulled into your own program: a bot, your website or another service. Here is what you can build and where to start.

Product Manager at Donatty
Published:

We have released the Donatty public API. Now your channel's tips, goals and tipper leaderboard can be pulled into your own program: a bot, your website or another service. The video covers everything in a minute; the details are below.
A bot for tips and goals
Build yourself a bot: it will post about new tips, goals and the tipper leaderboard in Telegram or wherever you like.
The documentation has a ready-made bot in Node.js and Python. Every 5 seconds it fetches new tips and keeps only those that passed moderation or did not need it. Rejected tips will not be shown.
A goal widget on your website
Show on your page how much has already been raised for a goal. The ready-made goal page is a single HTML file: it shows the goal name, the amount raised and a progress bar, and the data refreshes every 30 seconds. You can also add such a page to OBS as a “Browser” source.
Besides the goal, your site can show the tipper leaderboard or the total of tips for a period.
Connecting another service
Tips, goals and the leaderboard can be passed to any service you use. For example, a smart lamp lights up when a tip arrives.
What data the API exposes
tips — all of them, from newest to oldest, with the moderation status;
fundraising goals — the name, the target and the amount raised;
tipper leaderboard for a day, week, month, year or all time;
total tips for a period;
profile — nickname, avatar and a link to your tipping page.
The API is read-only: you cannot withdraw money or change anything through it. A key opens only your own channel's data.
Where to start
Issue a key in your dashboard, in the “For developers” section. For a bot or a server, use a secret key: when you issue it, you choose what it is allowed to read. For a website, use a public key: it opens only the profile, goals and statistics and does not read tips.
Take a ready-made example from the documentation: a bot in Node.js or Python, or a fundraising goal page.
For your own idea, start with the quick start — for a bot or for a website. Request examples are on the documentation home page, and on each method's page the example switches between Shell, Node.js, Python, PHP and Ruby.
We show the secret key value only once — copy it right away.
Coming soon: WebSocket and OAuth
WebSocket API and OAuth for app developers are in development. We plan to release them soon.
Documentation
Keys, methods, errors, limits and the FAQ — at developers.donatty.com.

Donatty ambassador program: free PRO plan
Tell your audience about Donatty — and we give you the PRO plan. Any channel with 100 or more followers qualifies. Here is what PRO includes, what you need to do and how to join.
Read more

November 7 release: fee compensation and two new alerts
Fee compensation is now visible in Finances, and tips with compensation and tips with media can have a separate alert. We show it in a video and explain how to set it up.
Read more

TikTok: an underrated promotion tool for streamers
We explain how TikTok’s algorithms work and why it makes sense for a streamer to promote themselves on the TikTok social network.
Read more

