shipapis
StarSubmit an APISubmit API

BotsArchive

Look up Telegram bots by username in a curated catalog

📚 Open DataHEALTHYchecked 1h ago
AUTH NONECORS ✓AGENT ✓HTTPS ✓COMMERCIAL ?

BotsArchive maintains a hand-curated database of Telegram bots and exposes their details through a small PHP API. Query /getBotID.php with a bot's username and it returns the bot's ID, category, tags, star rating and description as JSON. No key is required for the public lookups.

86HOW IT'S SCORED ⓘ
▶ Run liveDocs ↗
Status badge · for your READMEshipapis health badge: 86 · healthy
Uptime history
97.1%90 days
95.0%30 days
790P50 · ms
4448P95 · ms
operationalpartialdownno data
Response time · last 48 checks
Fastest 305 ms, slowest 2862 ms, most recent 305 ms.
Live response samplecaptured by our last successful check
GET https://api.botsarchive.com/getBotID.php?username=@vote

{
  "ok": 1,
  "id": 1,
  "result": {
    "id": 1,
    "name": "Votebot",
    "username": "@vote",
    "category": [
      "poll"
    ],
    "stars": 989,
    "votes": 248
  }
}
Call itcurl · fetch · python
curl "https://api.botsarchive.com/getBotID.php?username=@vote"
const res = await fetch("https://api.botsarchive.com/getBotID.php?username=@vote");
const data = await res.json();
console.log(data);
import requests

res = requests.get("https://api.botsarchive.com/getBotID.php?username=@vote")
print(res.json())
Endpoints · 6HealthyFULL DOCS ↗
Monitored path responding — GET /getBotID.php?username=@vote790 mschecked 1h ago
GET/getBotID.php?username=@votePROBED

Look up Telegram bots by username in a curated catalog

GET/getBotID.php?limit=5

GetBotID Php — documented GET route.

GET/getBotID.php?page=1

GetBotID Php — documented GET route.

GET/getBotID.php

GetBotID Php — documented GET route.

GET/getUserVote.php

GetUserVote Php — documented GET route.

GET/getUserVote.php?bot_id=1&user_id=141691961

GetUserVote Php — documented GET route.

Machine-readable spec

We probe a documented GET and expect 2xx JSON — full uptime and health score. Export includes every documented route below.

Response-shape history

Stable. No schema drift observed since monitoring began — the response shape has not changed under our checks.

BotsArchive: common questions

Is BotsArchive free to use?

Yes — BotsArchive is a free open data API. Free tier: Free — limits not published. Whether the free tier allows commercial use is unclear — check the provider docs.

Does BotsArchive need an API key?

No — BotsArchive needs no API key or signup. You can call it straight away; rate limits still apply (Unpublished).

Can I call BotsArchive from the browser?

Yes — BotsArchive returns CORS headers over HTTPS, so front-end code can fetch it directly with no backend proxy. Use the fetch snippet on this page, or hit "Run live" to try it now.

Is BotsArchive up right now?

As of our last scheduled check, BotsArchive is healthy with 97.1% uptime over 90 days and a 790 ms median response. We re-probe it every sweep — the status badge and uptime chart above always show the latest.