Skip to main content
GET
/
v1
/
bots
/
search
curl "https://portal-api.7331.org/v1/bots/search?q=portal&limit=10" \
  -b "psession=YOUR_SESSION"

{
  "bots": [
    {
      "id": 1,
      "name": "Portal Bot",
      "groups": 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
}

Documentation Index

Fetch the complete documentation index at: https://docs.7331.org/llms.txt

Use this file to discover all available pages before exploring further.

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 ID (exact).
​
owner
integer
Filter by owner 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://portal-api.7331.org/v1/bots/search?q=portal&limit=10" \
  -b "psession=YOUR_SESSION"

{
  "bots": [
    {
      "id": 1,
      "name": "Portal Bot",
      "groups": 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
}