Gifts

API ver.: 2.0

Returns current Telegram gifts snapshot

HTTP Request

GET https://api.giftstat.app/current/gifts

Query Parameters

Parameter

Description

limit

UInt
Number of elements in data. Maximum: 100, default: 100

offset

UInt
Data offset for pagination

collection

String (optional)
Filter by collection (comma-separated list: collection1,collection2)

model

String (optional)
Filter by model (comma-separated list: model1,model2,model3)

backdrop

String (optional)
Filter by backdrop (comma-separated list)

symbol

String (optional)
Filter by symbol (comma-separated list)

Response Structure

HTTP code: 200 - OK

{
    "data": [],
    "meta": {
        "limit": 100, 
        "offset": 0,
        "count": 0,
        "api_path": "/current/gifts"
    }
}

Available Fields

Field

Description

_id

String
Collection ID (as string)

id

String
Gift ID (as string)

gift_id

UInt
Numeric gift identifier

gift_name

String
Gift name

collection

String
Collection name

attributes

String
Gift attributes

dttm

DateTime
Snapshot timestamp

total_amount

UInt
Total number of gifts in collection

model

String
Gift model

backdrop

String
Gift backdrop

symbol

String
Gift symbol

API ver.: 2.0