scrapeatlas. Get started
Telegram API

Telegram Scraper API for Channels and Posts

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

Try a request API reference

WHAT YOU CAN BUILD / 05 ENDPOINTS

Put Telegram data to work.

Find your use case, then explore the request and response.

Get a Telegram channel

GET/v1/telegram/channel

Build a channel discovery card from public channel identity, description and subscriber information.

Get a Telegram profile via /profile

GET/v1/telegram/profile

Build a channel discovery card from public channel identity, description and subscriber information.

Get Telegram channel posts

GET/v1/telegram/channel/posts

Build a channel research feed from published Telegram messages, text, media and post information.

Get Telegram posts via /profile/posts

GET/v1/telegram/profile/posts

Build a channel research feed from published Telegram messages, text, media and post information.

Get a Telegram post

GET/v1/telegram/post

Build a message preview from a public Telegram post, with its content, media and engagement information.

HOW IT WORKS

From API key to Telegram data in four steps.

Run a sample below without a key.

  1. 01

    Get your API key

    Create a free account and copy your key. You start with 100 free credits; no card needed.

  2. 02

    Choose an endpoint

    Pick one of the 5 Telegram endpoints and add its input, such as a public handle.

  3. 03

    Send one request

    Call it with your key in the x-api-key header. ScrapeAtlas reads the public Telegram data and retries when a read fails.

  4. 04

    Use the JSON

    Get structured JSON with a coverage status. Only successful requests use a credit.

TRY IT HERE / LIVE SAMPLE

Try a sample request.

Try the Telegram API right here. This sample uses the Get a Telegram channel endpoint and returns live JSON. No API key needed.

  1. 01
    Choose a sample value

    Start with telegram, or change the handle field to your own value.

  2. 02
    Select Run sample

    Execute the sample code and see the response in the JSON response tab.

  3. 03
    Build on the result

    Open the full playground to try more parameters and copy code for your app.

Open this endpoint in the playground Request and response fields
LIVE SAMPLE / Get a Telegram channelNo API key needed

Preparing the sample…

// Run this sample here — no API key needed.
const value = "telegram";
const url = new URL("/website/demo/telegram",
  "https://api.scrapeatlas.com");
url.searchParams.set("value", value);

const response = await fetch(url);
const data = await response.json();
console.log(data);
GET/v1/telegram/channel

A live example from our playground. Change the value above, then select Run sample.

CUSTOMER STORIES

What they are saying
about us.

Digging your ScrapeAtlas experience?

Email Viktor with a testimonial & receive 10,000 free credits.

Nigel Yong — Founder, PostOnce

Pay as you go

Start free.
Build at your pace.

One-time credit packs, priced in US dollars. Credits never expire, and there is no monthly commitment.

Free

Try the API with your next idea.

$0No credit card needed

100 free credits

One starter grant per account

Starter

For a new idea or a one-off project.

$19USD / one-time

10,000 credits

$1.90 per 1,000 successful requests

Growth

Save 6.3%

For regular workflows and bigger builds.

$89USD / one-time

50,000 credits

$1.78 per 1,000 successful requests

Enterprise Plan

Want to scrape larger volumes?

Let’s talk about a plan that fits your scale.

Telegram API

Frequently Asked Questions

Explore the API reference

Telegram API and scraping

What public channel data can I retrieve with the Telegram API?

Retrieve public channel and group metadata, audience counts, published posts and individual message details. Channel responses can include photo, video, file and link inventories for content research.

How do I scrape Telegram channel posts into structured JSON?

Use Channel Posts to retrieve a page of messages with text, media, reactions and channel metadata. Pass the returned cursor to continue into older history or provide a query to search within the channel.

Can I search for text within a public Telegram channel?

Use Channel Posts with q to search within the selected channel. The response keeps message text, media and reactions with channel metadata, so your application can collect topic-specific posts in their source context.

Telegram: public channel messages and media

Can I scrape Telegram channel descriptions and audience counts?

Yes. Channel returns public identity, descriptions, avatars and audience counts for a channel or group. Select media inventory information when you want to summarize the photos, videos, files and links published there.

Which Telegram message fields can I retrieve from a permalink?

Post accepts a public message permalink and returns its text, publication time, views, reactions, media and link previews. Use these fields to build a source-linked message preview or content research record.

Can the Telegram API retrieve a channel’s media inventory?

Yes. Channel Details can include photo, video, file and link inventory with the channel metadata. Channel Posts also returns media information alongside messages, letting your application summarize the content a channel publishes.

API access and integration

How do I get a ScrapeAtlas API key and authenticate requests?

Create a ScrapeAtlas account and generate an API key in the dashboard. Send the key in the x-api-key request header when calling https://api.scrapeatlas.com. The API playground lets you enter an endpoint’s parameters and inspect its JSON response.

Can I call the scraping API from Python, JavaScript or the CLI?

Yes. Send authenticated HTTP requests from Python, JavaScript or another language that supports HTTP. The endpoint reference includes request examples and response fields. Use the ScrapeAtlas CLI for terminal workflows and pass the returned pagination values when requesting additional result pages.

Can I connect an AI assistant to the ScrapeAtlas MCP server?

Yes. Connect an MCP-compatible assistant to the ScrapeAtlas MCP server to discover and call the public platform tools with your ScrapeAtlas account. The agent reference also gives coding assistants a readable guide to the endpoints and their request schemas.

Make something with it

Ready to build?

Bring social data into your next project.
Start with 100 free credits and see what you can build.

Start building for free Explore pricing
No credit card needed.Building with an AI agent?