API for Telegram data

The same tools as in the Akula Marketing app, over HTTP: chat and channel scraping, username data and similar channels.

How to get an API key

We issue keys manually so we can set limits that fit your use case. Sign up at akula.marketing with Telegram. Message support at @KoteamSupport: which endpoints you need and your expected volume. Get your key. Pass it in every request as the key parameter.

Authentication

Add key=YOUR_KEY to every request. A missing or inactive key returns 401. Responses are JSON. Do not expose the key in client-side code.

Username info

Checks up to 100 usernames per request: whether it exists, user or channel/chat, title, description, avatar, member count. With include_resolve=true it adds Telegram ID, name, premium and online status.

Profile photos

Returns the profile photos of a user, channel or chat by username.

Similar channels

Channels Telegram recommends as similar to the given one. Useful for finding ad placements and growing your chat list.

Scrape a chat or channel

Creates a scraping task: chat members (type=gp) or message authors (type=gm). Runs asynchronously; the result is sent to your webhook, and status plus export links are available by task ID.

Batch scraping

Scrapes message authors across a list of chats in one task. The result is sent to the webhook set in your profile.

Want results without code?

Some endpoints are published as ready-made Apify actors: run from the browser, schedule, integrate with Make and Zapier.

How much does the API cost?

Pricing depends on the endpoints and volume. Message support at @KoteamSupport and we will match a plan to your use case.

Why are keys issued by support, not in the app?

We set limits and a webhook for each client. It gets your integration running faster and without errors.

How do I get scraping results?

Pass webhookUrl when creating a task and the result is sent there. Or poll the task by ID: the response includes export links.

How is the API different from the Apify actors?

The API is direct access for your own systems and scripts. Apify actors are no-code runs billed through Apify.

Telegram parser · Chat monitoring · Similar channels · Lead generation · Telegram outreach · AI outreach · Telegram post generator