Developer documentation

Telegram Premium, boosts and giveaways

Use current capabilities and configuration for Premium features, boost levels, giveaways and recommendations.

GetTGAPI editorial teamUpdated
Documentation notesReviewed

Based on official sources and independently maintained by GetTGAPI. Documentation and glossary →

On this page
  1. Combine subscription state with configuration
  2. Boosts have slots and cooldowns
  3. Recommendations have a defined source
  4. Implementation recommendations

Combine subscription state with configuration

Premium affects features and limits, while configuration controls availability, presentation and purchase restrictions. A previously observed premium flag is not a permanent entitlement to every operation.

Boosts have slots and cooldowns

Boost allocation depends on available slots and current cooldowns. Feature unlocks depend on configuration. Giveaways have their own payment, eligibility and launch conditions; completing payment does not always mean the activity has already started.

Recommendations have a defined source

Use the official response for similar channels and bots. Result availability may vary by subscription. Do not label a local keyword match as an official Telegram recommendation.

Implementation recommendations

Separate purchase entry, eligibility, payment and entitlement synchronization. Present the destination, cost, cooldown and current state before confirmation. Refresh stale state rather than automatically paying again or reallocating a slot.