TON Fragment Scraper A comprehensive Apify actor for scraping auction data from Fragment.com - the platform for trading Telegram usernames, phone numbers, and collectibles. ## Features 🔥 Multi-endpoint Support: Scrape usernames, numbers, and gift collections 📊 Detailed Data: Get complete auction info, bid history, ownership history 🌐 Proxy Support: Built-in Apify proxy support for reliable scraping ⚡ Robust: Retry logic, error handling, and rate limiting 📈 Real-time: Get current auction status, prices, and bid information 📋 Bulk Operations: Get lists of usernames/numbers with filtering and sorting 🧹 Smart Data Processing: Automatic price cleaning and full wallet address extraction ## Supported Endpoints ### 1. Single Username Auction (username) Scrape individual username auction data including: - Auction status (On auction, For sale, Sold, Available) - Current highest bid, bid step, minimum bid - Complete bid history with full wallet addresses - Ownership history for sold/for-sale usernames - Auction end time and countdown - USD price conversion (cleaned format) ### 2. Bulk Usernames (usernames_bulk) Get lists of usernames with filtering and sorting: - Filters: auction, sold, sale - Sorting: listed (recently listed), ending (ending soon), price_asc (price low to high) - Returns paginated results with auction details ### 3. Single Number Auction (number) Scrape phone number auction data including: - Auction details and pricing - Bid history and participants - Number availability status ### 4. Bulk Numbers (numbers_bulk) Get lists of phone numbers with filtering and sorting: - Filters: auction, sold, sale - Sorting: listed (recently listed), ending (ending soon), price_asc (price low to high) - Returns paginated results with auction details ### 5. Gift Collections & NFTs (gifts) Scrape Telegram collectibles data including: - All Collections: Get complete list of gift collections with counts and metadata - Collection Details: Detailed attributes/traits, floor prices, total counts, and rarity distribution - Individual NFTs: Detailed NFT information, pricing, ownership history, and attributes ## Usage Examples ### 1. Scrape Single Username Auction Request: json { "endpoint": "username", "identifier": "pavel", "proxyConfiguration": { "useApifyProxy": true } } Response (Auction): json { "username": "pavel", "exists": true, "status": "On auction", "ends_in": "2025-06-13T05:52:05+00:00", "highest_bid": "150", "bid_step": "8", "minimum_bid": "158", "bid_history": [ { "price": "150", "date": "6 Jun 2025 at 07:52", "from": "UQA61WOyTvcBRTdOQ6kfXkNuX5O89bGyyt8ruoE_fP3y3bqy" } ], "bid_count": 1 } Response (For Sale): json { "username": "premium", "exists": true, "status": "For sale", "sell_price": "5000", "sell_price_usd": "16,850", "end_time": "2025-06-20T12:00:00+00:00", "ownership_history": [ { "price": "4500", "date": "1 May 2025 at 14:30", "buyer": "UQAzGJdP3MEafBV7pGl86rDRy_DeWJeXrR1AevM6rk5nMcE" } ], "ownership_count": 1 } ### 2. Get Bulk Usernames on Auction (Recently Listed) Request: json { "endpoint": "usernames_bulk", "filter": "auction", "sort": "listed", "proxyConfiguration": { "useApifyProxy": true } } Response: json { "filter": "auction", "sort": "listed", "total_items": 25, "usernames": [ { "title": "pavel", "price_in_usd": "520.15", "price_in_ton": "155", "end_time_human_readable": "2 days", "end_time": "2025-06-13T05:52:05+00:00" } ] } ### 3. Get Sold Usernames (Price Low to High) Request: json { "endpoint": "usernames_bulk", "filter": "sold", "sort": "price_asc", "proxyConfiguration": { "useApifyProxy": true } } ### 4. Get Numbers for Sale (Ending Soon) Request: json { "endpoint": "numbers_bulk", "filter": "sale", "sort": "ending", "proxyConfiguration": { "useApifyProxy": true } } Response: json { "filter": "sale", "sort": "ending", "total_items": 15, "numbers": [ { "title": "+888123456", "status": "For sale", "price_in_ton": "2500", "end_time": "2025-06-15T10:30:00+00:00" } ] } ### 5. Get All Gift Collections Request: json { "endpoint": "gifts", "identifier": "collections", "proxyConfiguration": { "useApifyProxy": true } } Response: json { "total_collections": 71, "collections": [ { "name": "Astral Shards", "count": "1,550", "slug": "astralshard", "image": "/file/gifts/astralshard/thumb.webp", "url": "https://fragment.com/gifts/astralshard" }, { "name": "Homemade Cakes", "count": "19,775", "slug": "homemadecake", "image": "/file/gifts/homemadecake/thumb.webp", "url": "https://fragment.com/gifts/homemadecake" } ] } ### 6. Get Collection Details with Traits and Floor Price Request: json { "endpoint": "gifts", "identifier": "collection:astralshard", "proxyConfiguration": { "useApifyProxy": true } } Response: json { "slug": "astralshard", "url": "https://fragment.com/gifts/astralshard?sort=price_asc&filter=sale", "total_count": "1,550", "collection_name": "Astral Shards", "floor_price": "245", "attributes": { "model": [ { "name": "Sapphire", "count": "44", "image": "/file/gifts/astralshard/model.abTzJI-lm3rbbEyyHRSapMPSc3a-MivfKp57LsgHoI55dJe3ICmaFbnCdp72d653.webp" }, { "name": "Emerald", "count": "40", "image": "/file/gifts/astralshard/model.wulumh1oBOkIR8k9IeAIOD76t4mRqiliMN6WDr6xfl7tz_PkOa8JBbxj3ZQ1hwti.webp" } ], "symbol": [ { "name": "Trophy", "count": "23", "image": "/file/gifts/astralshard/symbol.v9p9koF3S4r6tYwiesN9kS1p-SqKOnUMgNa3FI8BAr-Yo7qUSZYfnt3IfswQGlC_.webp" }, { "name": "Eagle", "count": "19", "image": "/file/gifts/astralshard/symbol.S9Hku6F5_j80J3F_HXrp7O6IJIYhMQrDXmGoeGbMyOcQH4BEEbkUAg_xTS22YcBs.webp" } ], "backdrop": [ { "name": "Midnight Blue", "count": "155", "image": "/file/gifts/astralshard/backdrop.2jFP_qe5LUmJR_TDvabCXYmKMUDCXHCMqq-WpLByZjMs6hGt-JFfEVNM4wdFP-LF.webp" }, { "name": "Forest Green", "count": "142", "image": "/file/gifts/astralshard/backdrop.5T2YGpQf9QKjU_XDGtdKF-sKz4b_FznNiOEyxR86YcqKz8JMFqEA7n5pNt8jG4Xp.webp" } ] } } ### 7. Get Individual NFT Details Request: json { "endpoint": "gifts", "identifier": "nft:bdaycandle-16153", "proxyConfiguration": { "useApifyProxy": true } } Response: json { "collection": "bdaycandle", "nft_number": "16153", "nft_id": "bdaycandle-16153", "url": "https://fragment.com/gift/bdaycandle-16153", "name": "B-Day Candle #16153", "status": "Sold", "owner": "EQAVgTYjmtsV3VnfkMZB-e_TEs_rhmTyGPTD5fzp2V5sBwm6", "attributes": { "model": "Firecracker", "backdrop": "Cappuccino", "symbol": "Chest", "issued": "239225 of 307632" }, "pricing": { "type": "sale_price", "amount": "50", "usd_amount": null }, "ownership_history": [ { "price": "Transferred", "date": "8 May 2025 at 14:50", "buyer": "EQAVgTYjmtsV3VnfkMZB-e_TEs_rhmTyGPTD5fzp2V5sBwm6" }, { "price": "50", "date": "31 Mar 2025 at 22:50", "buyer": "EQDEtUqodJxHsSI0gqo7K1--JQrW-0eV0PW4_wzbVHPY5kxj" }, { "price": "Minted", "date": "24 Mar 2025 at 22:46", "buyer": "EQDEtUqodJxHsSI0gqo7K1--JQrW-0eV0PW4_wzbVHPY5kxj" } ] } ## Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | endpoint | string | ✅ | Type of data to scrape: username, usernames_bulk, number, numbers_bulk, or gifts | | identifier | string | ❌ | Specific item identifier (required for single items and gifts) | | filter | string | ❌ | Filter for bulk endpoints: auction, sold, sale (default: auction) | | sort | string | ❌ | Sort order for bulk endpoints: listed, ending, price_asc (default: listed) | | proxyConfiguration | object | ❌ | Proxy settings for requests | Required for single item endpoints (username, number) and gifts endpoint ### Bulk Endpoint Options #### Filters - auction: Items currently being auctioned - sold: Items that have been sold - sale: Items available for immediate purchase #### Sort Options - listed: Recently listed items (default) - ending: Items ending soon - price_asc: Price from low to high ### Identifier Formats (for single items and gifts) - Single Username: Just the username (e.g., "pavel") - Single Number: Phone number (e.g., "888123456") - All Gifts: "collections" - Specific Collection: "collection:slug" (e.g., "collection:astralshard") - Specific NFT: "nft:collection-number" (e.g., "nft:astralshard-2358") ## Data Fields Reference ### Single Username/Number Auctions - status: Current auction status - ends_in: ISO timestamp when auction ends - highest_bid: Current highest bid amount - bid_step: Minimum increment for next bid - minimum_bid: Minimum amount for next bid - bid_history: Array of all bids with prices, dates, and full wallet addresses - ownership_history: Complete ownership transfer history - sell_price: Current sale price (for sale items) - sell_price_usd: USD equivalent of sale price (cleaned format) - owner: Current owner wallet address (full format) - exists: Whether the username/number exists (not redirected) ### Bulk Username/Number Results - filter: Applied filter type - sort: Applied sort order - total_items: Number of items returned - usernames/numbers: Array of auction items with: - title: Username or number - price_in_ton: Current price in TON - price_in_usd: USD equivalent (cleaned format, no ~ or $) - status: Item status (for sold/sale items) - end_time: ISO timestamp - end_time_human_readable: Human readable time remaining ### Gift Collections - total_collections: Number of available collections - collections: Array of collection objects with name, count, slug, image, URL - floor_price: Cheapest available item price - attributes: Object containing model, symbol, and backdrop attribute lists ### Individual NFTs - nft_id: Unique NFT identifier - name: NFT display name - status: Current status (For sale, On auction, Available, Sold) - owner: Current owner wallet address (full format) - attributes: NFT attributes (model, backdrop, symbol, issued) - pricing: Current pricing information with type and amounts (USD cleaned) - ownership_history: Complete ownership transfer history ## All Available Endpoints 1. username - Single username auction details 2. usernames_bulk - Lists of usernames with filtering/sorting 3. number - Single number auction details 4. numbers_bulk - Lists of numbers with filtering/sorting 5. gifts - Gift collections and individual NFT details ## API Reference ### Core Classes #### Username(username: str, proxy_config=None) Scrapes individual username auction data. #### Usernames(filter: str, sort: str = None, proxy_config=None) Scrapes lists of usernames with filtering and sorting. Parameters: - filter: 'auction', 'sold', or 'sale' - sort: 'listed', 'ending', or 'price_asc' #### Number(number: str, proxy_config=None) Scrapes individual phone number auction data. #### Numbers(filter: str, sort: str = None, proxy_config=None) Scrapes lists of numbers with filtering and sorting. #### Gifts(proxy_config=None) Scrapes gift collections and NFT data. Methods: - get_collections(): Get all collections - get_collection_details(slug): Get specific collection info - get_nft_details(collection, nft_number): Get individual NFT data ## Support For issues or questions: 1. Check the error messages in the actor logs 2. Verify your input parameters match the expected format 3. Ensure proper proxy configuration if needed For any questions, contact me on Telegram: @RickTheOwner ## License This project is licensed under the MIT License - see the LICENSE file for details.