Skip to main content
GET
/
v1
/
bots
/
search
curl "https://hapi.7331.org/v1/bots/search?q=hansel&limit=10" \
  -b cookies.txt

{
  "bots": [
    {
      "discord_id": "111222333444555666",
      "name": "Hansel Bot",
      "guilds": 250,
      "users": 50000,
      "is_verified": true,
      "created_at": "2025-01-01T00:00:00Z",
      "updated_at": "2025-01-15T12:00:00Z"
    }
  ],
  "total": 1,
  "limit": 10,
  "offset": 0
}
Requires an active session cookie. The response varies based on the caller’s permission level:
  • Regular users: Public bot profiles (BotPublicResponse) with basic stats.
  • Admins+: Full bot details (BotPrivateResponse) including owner, rate limits, and type.
​
q
string
Search query (max 50 characters). Matches bot name (partial) or Discord ID (exact).
​
owner
integer
Filter by owner Discord ID.
​
bot_type
integer
Filter by bot type. 1 = Official, 2 = Verified, 3 = Community.
​
offset
integer
default:"0"
Pagination offset. Range: 0-10000.
​
limit
integer
default:"25"
Page size. Range: 1-100.

​
Response

​
bots
object[]
required
Page of bot objects. Fields vary by caller’s permission level.
​
total
integer
required
Total matching bots.
​
limit
integer
required
Page size used.
​
offset
integer
required
Offset used.
curl "https://hapi.7331.org/v1/bots/search?q=hansel&limit=10" \
  -b cookies.txt

{
  "bots": [
    {
      "discord_id": "111222333444555666",
      "name": "Hansel Bot",
      "guilds": 250,
      "users": 50000,
      "is_verified": true,
      "created_at": "2025-01-01T00:00:00Z",
      "updated_at": "2025-01-15T12:00:00Z"
    }
  ],
  "total": 1,
  "limit": 10,
  "offset": 0
}