GiveawayWinners#

class pyrogram.types.GiveawayWinners#

This object represents a message about the completion of a giveaway with public winners.

Parameters:

  • chat (Chat) – The chat that created the giveaway

  • giveaway_message_id (int) – Identifier of the message with the giveaway in the chat

  • winners_selection_date (datetime) – Point in time (Unix timestamp) when winners of the giveaway were selected

  • winner_count (int) – Total number of winners in the giveaway

  • winners (User) – List of up to 100 winners of the giveaway

  • additional_chat_count (int, optional) – The number of other chats the user had to join in order to be eligible for the giveaway

  • 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

  • unclaimed_prize_count (int, optional) – Number of undistributed prizes

  • only_new_members (bool, optional) – True, if only users who had joined the chats after the giveaway started were eligible to win

  • was_refunded (bool, optional) – True, if the giveaway was canceled because the payment for it was refunded

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