Telegram API

Telegram data.
Put a public channel in context.

Retrieve Telegram profiles, audience and media counts, channel posts and individual messages. Search within a channel and follow its post history.

PUT IT TO WORK

What will you build?

Three ways to use Telegram data.

Build a channel directory

Turn public channel URLs into searchable entries with names and descriptions.

Follow a channel’s posts

Read posts with media and reactions, search by text and continue through older pages.

Create useful link previews

Attach message text, media and engagement to Telegram post links shared in your app.

YOUR FIRST REQUEST

Get a Telegram channel.

Turn public channel URLs into searchable entries with names and descriptions.

  1. 01
    Add your API key

    Set SCRAPEATLAS_API_KEY in your environment.

  2. 02
    Choose your input

    Use the sample request as a starting point.

  3. 03
    Work with the JSON

    Send the result to your app, sheet or research tool.

Request and response fields
QUICKSTART / API EXAMPLES
# ScrapeAtlas · use your customer API key
export BASE_URL="https://api.scrapeatlas.com"

curl --get "$BASE_URL/v1/telegram/channel" \
  -H "x-api-key: $SCRAPEATLAS_API_KEY" \
  --data-urlencode "handle=example"
GET/v1/telegram/channelJSON response

Use your ScrapeAtlas API key. Replace the sample input with your own.

GETTING STARTED

A few practical details.

API key setup
How do I make a request?

Create a ScrapeAtlas API key, send it in the x-api-key header, and pass the endpoint’s request fields. The example above is ready to adapt to your own input.

What does the response contain?

Retrieve Telegram profiles, audience and media counts, channel posts and individual messages. Search within a channel and follow its post history. Each endpoint’s reference shows its response fields and a JSON example.

Can I use this from an AI assistant?

Yes. Connect ScrapeAtlas through MCP to use Telegram tools from your assistant. You can also call the same API from your own scripts or the CLI.