Documentation

Everything you need to integrate TG Parser V2 into your applications.

Quick Start

Get your first channel parsed in seconds. You'll need an API key from the dashboard.

curl -X POST https://api.tgparser.cc/parse \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"channel": "durov", "limit": 5, "details": true}'

Note: Set "details": true to get views and reactions breakdown (default is false).

API Reference

POST/parse

Extract messages from a public Telegram channel.

Parameters

Name	Type	Description
channel	string	The username of the channel (e.g. "@durov") or t.me link.
limit	integer	Number of messages to retrieve (max 100). Defaults to 100 if both hours and limit are omitted.
hours	integer	Fetch messages from the last X hours.
details	boolean	Include extended metrics like views and reactions. Default: false.

Response Example

[
  {
    "status": "success",
    "count": 1,
    "messages": [
      {
        "id": 474,
        "date": "2026-03-01T21:05:45+00:00",
        "text": "🎆 Unfortunately, I had to leave Dubai...",
        "link": "https://t.me/@durov/474",
        "channel": "@durov",
        "channel_title": "Pavel Durov",
        "views": 800738,
        "reactions": 58375,
        "reactions_details": [
          {
            "emoji": "👍",
            "count": 8261
          },
          {
            "emoji": "custom_5265077361648368841",
            "count": 28241
          }
        ]
      }
    ]
  }
]

Code Examples

import requests

url = "https://api.tgparser.cc/parse"
headers = {
    "X-API-Key": "YOUR_API_KEY",
    "Content-Type": "application/json"
}
data = {
    "channel": "@durov",
    "hours": 24,
    "limit": 10,
    "details": true
}

response = requests.post(url, json=data, headers=headers)
print(response.json())