Python SDK

pip install sidekick-ads

# with framework extras:
pip install "sidekick-ads[aiogram]"    # aiogram 3.x
pip install "sidekick-ads[ptb]"        # python-telegram-bot 20+

from sidekick_ads import Sidekick

sk = Sidekick(
    api_key="sk_live_xxxxx",
    platform_id="plt_xxxxx",
)

# in your handler:
result = await sk.inject(
    user_id=message.from_user.id,
    message=llm_reply,
    language_code=message.from_user.language_code or "en",
    is_premium=message.from_user.is_premium,
    keyboard=your_existing_keyboard,  # optional
    parse_mode="HTML",  # Match the parse mode used when sending.
    first_name=message.from_user.first_name,  # optional — better targeting
    user_message=message.text,  # optional — better targeting
)

await message.answer(result.message, reply_markup=result.keyboard, parse_mode="HTML")