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:

{
  "endpoint": "username",
  "identifier": "pavel",
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}

Response (Auction):

{
  "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):

{
  "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:

{
  "endpoint": "usernames_bulk",
  "filter": "auction",
  "sort": "listed",
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}

Response:

{
  "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:

{
  "endpoint": "usernames_bulk",
  "filter": "sold",
  "sort": "price_asc",
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}

4. Get Numbers for Sale (Ending Soon)

Request:

{
  "endpoint": "numbers_bulk",
  "filter": "sale",
  "sort": "ending",
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}

Response:

{
  "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:

{
  "endpoint": "gifts",
  "identifier": "collections",
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}

Response:

{
  "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:

{
  "endpoint": "gifts",
  "identifier": "collection:astralshard",
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}

Response:

{
  "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:

{
  "endpoint": "gifts",
  "identifier": "nft:bdaycandle-16153",
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}

Response:

{
  "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.