Giveaway

class pyrogram.types.Giveaway

This object represents a message about a scheduled giveaway.

Parameters:
  • chats (:obj:`~pyrogram.types.Chat`) – The list of chats which the user must join to participate in the giveaway

  • winners_selection_date (:py:obj:`~datetime.datetime`) – Point in time (Unix timestamp) when winners of the giveaway will be selected

  • winner_count (``int``) – The number of users which are supposed to be selected as winners of the giveaway

  • only_new_members (``bool``, *optional*) – True, if only users who join the chats after the giveaway started should be eligible to win

  • has_public_winners (``bool``, *optional*) – True, if the list of giveaway winners will be visible to everyone

  • prize_description (``str``, *optional*) – Description of additional giveaway prize

  • country_codes (``str``, *optional*) – A list of two-letter ISO 3166-1 alpha-2 country codes indicating the countries from which eligible users for the giveaway must come. If empty, then all users can participate in the giveaway. Users with a phone number that was bought on Fragment can always participate in giveaways.

  • prize_star_count (``int``, *optional*) – The number of Telegram Stars to be split between giveaway winners; for Telegram Star giveaways only

  • premium_subscription_month_count (``int``, *optional*) – The number of months the Telegram Premium subscription won from the giveaway will be active for