Official open-source packages for npm, PyPI and GitHub. Add rewarded, interstitial and task ads to your Telegram Mini App, or sponsored messages to your bot, and earn USDT.
Adsun npm i adsun-sdkpip install adsunReact · Vue · Next.js · TypeScript · Python · aiogram · python-telegram-bot
JavaScript & TypeScript for Telegram Mini Apps. React hook, Vue composable, SSR-safe.
Python for Telegram bots. aiogram & python-telegram-bot helpers, Reward URL verification.
Full source code, examples, issues and changelog. MIT licensed.
No build step: load https://api.adsun.io/sdk.js and call Adsun.init().
Replace 50001 with the block id from your Adsun publisher panel. Use debug: true while testing — test ads are never billed.
Any Mini App, no bundler.
<script src="https://telegram.org/js/telegram-web-app.js"></script>
<script src="https://api.adsun.io/sdk.js"></script>
<script>
// Reward block (Interstitial: "int-50001")
const ad = window.Adsun.init({ blockId: "50001" });
document.querySelector("#watch").onclick = () =>
ad.show().then(() => giveReward()).catch(console.log);
</script>
<adsun-task data-block-id="task-50003">
<span slot="reward">+100 coins</span>
</adsun-task>
Vite, Next.js, Svelte, Angular.
// npm i adsun-sdk
import { initAdsun } from "adsun-sdk";
const ad = await initAdsun({ blockId: "50001", debug: false });
ad.addEventListener("onStart", () => pauseGame());
ad.show()
.then((r) => r.done && giveReward())
.catch((r) => console.log(r.description));
Rewarded button and Task card.
// npm i adsun-sdk
import { useAdsun, AdsunTask } from "adsun-sdk/react";
export function Earn() {
const showAd = useAdsun({ blockId: "50001", onReward: () => addCoins(100) });
return (
<>
<button onClick={showAd}>Watch ad · +100</button>
<AdsunTask blockId="task-50003" reward="+100" onReward={() => addCoins(100)} />
</>
);
}
Composable for any component.
<script setup>
// npm i adsun-sdk
import { useAdsun } from "adsun-sdk/vue";
const showAd = useAdsun({ blockId: "50001", onReward: () => coins.value += 100 });
</script>
<template>
<button @click="showAd">Watch ad · +100</button>
</template>
Sponsored message on /bonus.
# pip install "adsun[aiogram]"
from aiogram.filters import Command
from adsun import AsyncAdsunBot
from adsun.integrations.aiogram import send_ad
ads = AsyncAdsunBot(token="YOUR_ACCOUNT_TOKEN", block_id="50001")
@dp.message(Command("bonus"))
async def bonus(message):
u = message.from_user
await send_ad(message.bot, message.chat.id, ads, u.id, u.language_code or "en")
Grant coins only after a verified view.
# Panel → Reward URL:
# https://your-app.com/adsun/reward?userid=[userId]&block=[blockId]&secret=SECRET
from adsun import parse_reward_callback
@app.get("/adsun/reward")
def reward(request):
cb = parse_reward_callback(request.query_params, secret=SECRET)
if cb is None:
return Response(status_code=403)
add_coins(cb.user_id) # idempotent: Adsun retries on 5xx
return {"ok": True}
Fullscreen video or image the user chooses to watch for an in-app reward.
Block id: 50001
Fullscreen ad between screens, closable after a few seconds.
Block id: int-50001
Native <adsun-task> card: open a channel, bot or app, come back and claim.
Block id: task-50001
Sponsored message with buttons sent by your Telegram bot.
Block id: 50001 · Bot
# Telegram Mini App
npm i adsun-sdk
# Telegram bot
pip install adsun
# No build step
<script src="https://api.adsun.io/sdk.js"></script>
No fees to use the SDK. Read, fork and audit the code on GitHub.
Full typings for AdController, events and init options.
Import anywhere; the script loads only in the browser.
Core uses the standard library; async extras are optional.
Reward URL is called only after Adsun verifies a full view.
Same init({ blockId }).show() flow — migrate in minutes.
For Telegram Mini Apps run npm i adsun-sdk (or add <script src="https://api.adsun.io/sdk.js">). For Telegram bots run pip install adsun.
Yes. The packages are open source under the MIT license. You earn money from the ads shown; there is no SDK fee.
Yes. Use adsun-sdk/react for the useAdsun hook and AdsunTask component, adsun-sdk/vue for Vue 3. It is SSR-safe, so it works in Next.js and Nuxt.
Install adsun, create AdsunBot(token, block_id) and call get_ad(user_id, language), or use the ready aiogram / python-telegram-bot helper send_ad().
Set a Reward URL on your block. Adsun calls it only after a server-verified full view; verify it with parse_reward_callback() and grant the reward there.
Yes. The API follows the same init({ blockId }).show() pattern and the same events, so most integrations only change the script and block id.
Create a block, install the package and see your first impressions today.
npm i adsun-sdkpip install adsun