API Documentation

Access TgFindr data programmatically through our REST API.

Base URL: https://tgfindr.vercel.app

Endpoints

GET/api/channels

Get all verified channels

Example Request

https://tgfindr.vercel.app/api/channels

Example Response

{
  "success": true,
  "data": [...],
  "count": 10
}
GET/api/channels/:id

Get a specific channel by ID

Example Request

https://tgfindr.vercel.app/api/channels/abc-123

Example Response

{
  "success": true,
  "data": { ... }
}
GET/api/categories

Get all categories

Example Request

https://tgfindr.vercel.app/api/categories

Example Response

{
  "success": true,
  "data": [...],
  "count": 6
}
GET/api/categories/:slug

Get channels by category slug

Example Request

https://tgfindr.vercel.app/api/categories/crypto

Example Response

{
  "success": true,
  "data": [...],
  "count": 5,
  "category": "crypto"
}
GET/api/search?q=query

Search channels by name, username, or description

Example Request

https://tgfindr.vercel.app/api/search?q=telegram

Example Response

{
  "success": true,
  "data": [...],
  "count": 3,
  "query": "telegram"
}

📘 Rate Limiting & Caching

  • All endpoints are cached for optimal performance
  • Channel and category data is cached for 1 hour
  • Search results are cached for 1 minute
  • No API key required for public endpoints