api.changes.tg/

API and CDN websites might be down for a minute or two. Hosting provider went maintenance due to them patching virtualization nodes for CVE-2026-99999. We will post an update when the maintenance ends.

API and CDN websites might be down for a minute or two. Hosting provider went maintenance due to them patching virtualization nodes for CVE-2026-99999. We will post an update when the maintenance ends.

~ add original rarities to models if we have data on them
GET /models/:gift - list of all gift models. add ?sorted to sort by rarity
GET /backdrops/:gift - list of all gift backdrops. add ?sorted to sort by rarity
GET /symbols/:gift - list of all gift symbols. add ?sorted to sort by rarity
GET /gift/:gift - detailed info about a certain gift
GET /emoji/:gift - get customEmojiId mapping for a specific gift

Due to how Resistance Dog's rarity works, the methods listed above were updated and now contain such fields as originalRarity and originalRarityPermille if our API has data on them.

+ add everything related to crafts
GET /crafts - gifts that are craftable right now or have crafted models, with every crafted model (tier, customEmojiId) and the crafted emoji/sticker set links

+ add everything related to auctions
GET /auctions - every gift auction with recorded rounds: dates, rounds, gifts per round, gifts sold, stars spent, average price paid, finished flag. newest first
GET /auction/:gift/rounds - round-by-round history of a gift auction (gift name, auction slug or id): round times, gifts sold, min bid, clearing price, top bid, winning bids sum, bid levels, gifts left

~ add SVG generation for gift models (including originals)
GET /model/:gift/:model.svg - download the first frame of this gift model as an svg
GET /original/:id.svg - download the first frame of this gift as an svg

~ add rarity and rarityPermille to every model, backdrop and symbol
GET /models/:gift - list of all gift models. add ?sorted to sort by rarity
GET /backdrops/:gift - list of all gift backdrops. add ?sorted to sort by rarity
GET /symbols/:gift - list of all gift symbols. add ?sorted to sort by rarity
GET /gift/:gift - detailed info about a certain gift
GET /emoji/:gift - get customEmojiId mapping for a specific gift
(+ all of the /info routes)

~ add backdropId, customEmojiId fields
GET /backdrops/:gift - list of all gift backdrops. add ?sorted to sort by rarity
GET /backdrop/:gift/:backdrop/info - detailed info about a certain gift backdrop

~ return full models, backdrops and symbols
GET /gift/:gift - detailed info about a certain gift

~ fix model emojis
GET /emoji/:gift - get customEmojiId mapping for a specific gift

~ fix similar symbol names
GET /symbol/:gift/:symbol - download this gift pattern

~ errors are now JSON
GET * - { error, message, statusCode }

Rarity used to come as rarityPermille on some routes and as a percentage in rarity on others. Now every model, backdrop and symbol has both, everywhere. Crafted models are now sorted by tier (legendary → epic → rare → uncommon) and still go first. Models with the same rarity are now ordered by name.

/gift/:gift now returns the same entries as /models, /backdrops and /symbols. Backdrops now always include backdropId and customEmojiId.

/emoji/:gift had outdated rarities for some gifts (Desk Calendar, Jingle Bells, Big Year, etc.). They now match /models. Every model is listed now, even if it has no emoji (customEmojiId: null). Cookie Heart's Strawberry/Strawberry-1 and Santa Hat's Rave-1 had the wrong emoji, which is fixed now.

Symbols like Sea Horse and Seahorse used to resolve to the same symbol. Both work properly now. Some symbol lists also contained leftover raw Telegram document data, which is removed.

Errors used to be plain text and are now JSON. Status codes and messages are the same, but if you read the error body as text, you might want to update your code.

If anything looks off, please tell us in the comments. Thanks!

~ add crafted, rarityTier fields
GET /models/:gift - list of all gift models. add ?sorted to sort by rarity

If a gift has some models that are crafted-only (such as Desk Calendar's), those models now show crafted: true and their crafted rarity in rarityTier.

+ add gift models emoji
GET /emoji/:gift - get customEmojiId mapping for a specific gift
~ add emoji field
GET /gift/:gift - detailed info about a certain gift

Since Bot API has recently allowed usage of custom emoji IDs for every bot, we've updated our API to contain custom emoji IDs for both model emojis and original emojis.

If you have any problems with the newly-added custom emoji IDs (for example, missing model emoji, or incorrect custom emoji ID for a model), please tell us about them in the comments. Thanks!

Telegram updated every single UFC Strike model's name ( https://t.me/GiftChangesModels, https://t.me/GiftChangesUpdates), so if you were using the cached models — it's time to update the cache. All files, including PNG and lottie JSON ones were changed correspondingly to their new names.

the current team behind http://peek.tg/ (also called ****) decided that it would be a wise idea to remove any mention of https://t.me/GiftChanges or our API whatsoever and instead replace it with self-proclaimed "Powered by ****". very ugly and mean of them.

previous version of http://peek.tg/ had "Big thanks to https://t.me/GiftChanges for their API" linking to this channel, and now it's just "we made this, we are the best, thank you for using us". the same happened to the https://peek.tg/transfers page, they simply removed any mention of the original developers and API providers and replaced them with their own ****, even though they did nothing to obtain the API or sustain it. as unprofessional and disgusting as possible on their part.

in the nearest few days http://api.changes.tg/ may be under maintenance. expect lower uptime and/or possible errors

some problems with hosting arose, fixing rn

some problems with hosting arose, fixing rn

+ add EMOJI
GET /emoji - get giftId<->customEmojiId mapping

+ add /dates
GET /dates - release and upgrade-enabled dates for every gift, unix seconds (UTC), oldest release first
~ add releasedAt, releasedAtSource, upgradableAt, upgradableAtSource, upgradable fields
GET /gift/:gift - detailed info about a certain gift

Added gift release dates, along with the dates on which upgrades got released for the specified gifts.
NOTE: some gifts (especially the first unlimited ones) have their release dates set to arbitrary Oct 5, 2024, 9:00 AM UTC+0.

These are the 5 models that weren't originally used as models, but are now added to the models pool: 🗽 Justice — 1% 🗽 Jacqueline — 1% 🗽 Pumpkin — 1.5% 🗽 Independence — 1.5% 🗽 Peridot — 3%

Indefinite downtime for both api.changes.tg and cdn.changes.tg; server provider issues, can’t do anything myself.

Indefinite downtime for both api.changes.tg and cdn.changes.tg; server provider issues, can’t do anything myself.

Slight change of api.changes.tg/total:
- gifts -> gifts.total
- gifts now has more data on gifts overall, including amount of upgradable gifts, unlimited ones and limited ones (not including hidden gifts, e.g. time-limited bears)

+ add /backdrops
GET /backdrops - list of all gift backdrops sorted by backdropId

hey

+ add gift models emoji GET /emoji/:gift - get customEmojiId mapping for a specific gift ~ add emoji field GET /gift/:gift - detailed info about a certain gift Since Bot API has recently allowed usage of custom emoji IDs for every bot, we've updated our API…

A little bit of a breaking change: /emoji/:gift and [/gift/:gift].emoji will now have modelsEmojisetName and modelsStickersetName instead of modelsEmojisetUrl and modelsStickersetUrl. Sorry in advance :P

+ add size parameter for PNGs
GET /model/:gift/:model.png?size=128 - download this gift model resized to 128x128 (128, 256, 512 available)
GET /symbol/:gift/:symbol.png?size=128 - download this gift pattern resized to 128x128 (128, 256, 512 available)
GET /original/:giftId.png?size=128 - download this gift resized to 128x128 (128, 256, 512 available)

Consider this feature as a beta since I'm not sure if the server will be able to process thousands of resizes. We'll see.

+ add gift models emoji