Telegram Scraper

The Telegram Scraper lets you extract and search in your personal chat history. This powerful unofficial Telegram API will give you Telegram message data at scale to be used in your own data projects, business reports, and as a basis for new applications.

One run of the Telegram Scraper on the Apify platform will use approximately 0.02 compute units to get 1,000 results. This means that, on average, you can extract about 1,000 results for less than USD 0.05 in platform usage credits.

• Backup your own chat history.

• Find messages in your chat history with specific keywords.

• Engage with your customers through personal accounts instead of Bots.

• Collect survey data from respondents quickly and efficiently.

• Analyse trends and patterns.

• Enter your Telegram Phone Number via the Input Fields

• Use the Live View to enter the Telegram Auth Code provided in the Telegram App

• Use the configured Live View to get your Chat IDs

• Abort the current run or the scraper will automatically stop after 10 minutes

• Configure the Chat IDs and Filters via the Input Fields

• Happy Scraping!

The actor stores its results into the default dataset associated with the actor run. The data can be downloaded in machine-readable formats such as JSON, HTML, CSV or Excel.

Each item in the dataset will contain a separate tweet that follows this format:

{
    "_": "message",
    "id": 12345678901,
    "sender_id": {
        "_": "messageSenderUser",
        "user_id": 123456789
    },
    "chat_id": -987654321,
    "is_outgoing": false,
    "is_pinned": false,
    "can_be_edited": false,
    "can_be_forwarded": true,
    "can_be_saved": true,
    "can_be_deleted_only_for_self": true,
    "can_be_deleted_for_all_users": true,
    "can_get_statistics": false,
    "can_get_message_thread": false,
    "can_get_viewers": false,
    "can_get_media_timestamp_links": false,
    "has_timestamped_media": false,
    "is_channel_post": false,
    "contains_unread_mention": false,
    "date": 1651159055,
    "edit_date": 0,
    "reply_in_chat_id": -987654321,
    "reply_to_message_id": 12345678902,
    "message_thread_id": 0,
    "ttl": 0,
    "ttl_expires_in": 0,
    "via_bot_user_id": 0,
    "author_signature": "",
    "media_album_id": "0",
    "restriction_reason": "",
    "content": {
        "_": "messageText",
        "text": {
            "_": "formattedText",
            "text": "It's dangerous to go alone! Take this. 🗡️",
            "entities": []
        }
    },
    "message_text": "It's dangerous to go alone! Take this. 🗡️",
    "sender_user_id": 123456789,
    "chat_name": "Overworld",
    "is_group_chat": true,
    "is_private_chat": false,
    "sender_user_name": "Sahasrahla",
    "language": "english",
    "keywords": [
        "dangerous"
    ]
}

The Telegram Scraper works well with Apify dataset proxies, which are set as default for all our scrapers. However, if you've noticed your run has been stuck for too long, it's recommended to switch to residential proxies for faster, reliable, and more efficient results.

You should be aware that your results might contain personal data. Personal data is protected by GDPR in the European Union and other laws and regulations around the world. You should not scrape personal data unless you have a legitimate reason to do so. If you're unsure whether your reason is legitimate, consult your lawyers. You can read the basics of ethical web scraping in the Apify blog post on the legality of web scraping.

We will be adding more functionality soon, so feel free to contact us for any suggestions or improvements.