Telegram Number Checker(Analyze)

IRbots provides a Telegram number status-checking service that lets you verify your target numbers on Telegram and determine whether they are banned, fresh, or already have an active session.

This is a clean and minimal Python wrapper for the irbots.com Telegram number status API, supporting both synchronous and asynchronous usage.
Click here to get your API key

Usage/Examples

  pip install Tgchecker --upgrade

Sync Example

from Tgchecker import TgChecker

client = TgChecker(api_key="YOUR_API_KEY")
result = client.check_sync(["+12345678901", "+989121234567"])
print(result)

Async Example

import asyncio
from Tgchecker import TgChecker

async def main():
    client = TgChecker(api_key="YOUR_API_KEY")
    result = await client.check_async(["+12345678901"])
    print(result)

asyncio.run(main())

output/Examples

  {"+12345678901": "session", "+989121234567": "ban"}

API Reference

check numbers

  GET http://checker.irbots.com/?key={your_api_key}&target=checker&numbers=1,2,3,4

Reponse

json	Type	Description
Time taken	string	Time the API took to return response
data	string	Numbers and their statuses
errors	string	The numbers that check was not successful
status	string	Status of the request

Example

  {
  "Time taken": 0.23,
  "data": {
    "+14343540268": "ban",
    "+989175834924": "session"
  },
  "errors": 0,
  "status": "ok"
}

License

MIT