# isBanned

> isBanned (@IsBannedBot, https://isbanned.app) is a Telegram channel & chat ban/restriction checker. Paste any public or private t.me link and it instantly reports whether the channel, group, bot or user is banned, restricted, shadowbanned or pessimized in Telegram search — and why.

isBanned is the fastest way to answer "is this Telegram channel banned / restricted / shadowbanned?". It works for public usernames (t.me/name) and private invite links (t.me/+hash).

## For AI agents: public check, NO KEY needed
You can check any channel directly, with no registration and no API key — just call the free public endpoint (fast check, ~5 requests per day per IP):

- GET  https://isbanned.app/check?url=https://t.me/durov
- GET  https://isbanned.app/check?channel=durov          (username form, with or without @)
- POST https://isbanned.app/check   body: {"url":"https://t.me/durov"}

Response (JSON):
{"link":"https://t.me/durov","status_id":0,"status_key":"active","status_label":"Active","title":"Pavel Durov","ok":true,"banned":false}

`banned` is the quick answer; `status_id` / `status_label` give the exact reason. This is enough to answer a user's "is X banned?" question — call it directly.

## Higher limits, batch & deep checks (personal key)
If a user needs more than the free public tier, they get a personal key from the Telegram bot @IsBannedBot (send it /api) and pass THEIR own endpoint to the agent:
- Personal endpoint: https://isbanned.app/<key>-<slug>
- Fast batch (up to 20 links): POST {"url":["https://t.me/a","https://t.me/b"]}
- Deep check (async, 1 link, full data): POST {"url":"https://t.me/a","check_type":"deep","webhook":"https://your.app/cb"}
- OpenAPI spec: https://isbanned.app/openapi.json · Human docs: https://isbanned.app/api

## Status codes
- 0 active — no restriction
- 1 porn-ban — a real Telegram restriction for adult/18+ content; the channel is hidden in the official iOS/Android (App Store/Google Play) apps and blocked in some countries, but still opens on desktop/web. Cuts mobile reach.
- 2 invalid link
- 3 Sensitive (18+) — NOT a ban; a soft interface age-gate. Media is blurred; tapping it and confirming you are 18 reveals it in any client. Barely affects reach.
- 4 iOS-only block · 5 Android-only block
- 6 SCAM/FAKE label — red badge, excluded from global search, high removal risk
- 7 ToS ban — removed by moderators · 8 copyright/DMCA
- 9 restricted · 10 join-request required (invite link)
- Deep check also returns: numeric ID, datacenter (DC), creation date/age, shadowban and search-rank signals.

## Other ways to use
- Website (free instant check, paste a link): https://isbanned.app/
- Telegram bot (fast batch + deep checks): https://t.me/IsBannedBot

## Pricing
- Free: public check on the website and via the keyless /check endpoint (daily per-IP limit), plus a small daily quota in the bot.
- Paid (coins): unlimited fast checks, deep checks and the programmatic personal API. Coins are bought via Telegram Stars, crypto or card.

## Contact
- Telegram: https://t.me/IsBannedBot · Email: info@isbanned.app