URBot Docs

URBot Developer Docs

134 specialized AI bots. One unified API. Chat, webhooks, gifting, affiliates, and more — all documented here.

API Reference Swagger UI

Quick Start

# 1. Register an account and get a JWT
curl -X POST https://urbot.net/api/auth/login \
  -H "Content-Type: application/json" \
  -d '{"email":"you@example.com","password":"yourpass"}'

# 2. Create a Developer API account (requires 1+ bot purchase)
curl -X POST https://urbot.net/api/developer/register \
  -H "Authorization: Bearer YOUR_JWT" \
  -H "Content-Type: application/json" \
  -d '{"app_name":"My App"}'

# 3. Call a bot with your API key + secret
curl -X POST https://urbot.net/api/v1/chat \
  -H "X-API-Key: YOUR_KEY" \
  -H "X-API-Secret: YOUR_SECRET" \
  -H "Content-Type: application/json" \
  -d '{"bot_slug":"professor","message":"Explain machine learning"}'
🔐

Authentication

JWT registration, login, and user profile. Most endpoints accept optional Bearer tokens.

💬

Chat API

Send messages to any of 134 bots. Free preview (5 msg), unlimited for purchasers. Emotion detection included.

🔐

Developer API (v1)

API key + secret auth for programmatic bot access. List bots, send messages, track daily credits.

Webhooks

Register HTTPS endpoints to receive real-time message.sent and message.received events from your bots.

🤖

Bot Catalog

List all 134 bots with prices, categories, ML-ranked sorting, and capability gap analysis.

Reviews

Read and submit star ratings. Purchase owners can post reviews with download tokens.

🆕

Character Arc

Relationship leveling system. Each user builds unique arc XP with each bot through conversations.

🌟

Personalization

Adaptive preferences that evolve as users interact: verbosity, tone, formality, technical depth.

🎁

Bundles

Discounted multi-bot deal packs. Time-limited. Get personalized bundle recommendations.

🎁

Gifting

Gift specific bots or dollar-amount gift cards. Redeemable via unique codes.

🔗

Referral

Generate referral codes, earn $1 per successful referral. 10% discount for referred buyers.

📈

Affiliate Program

Apply, track clicks + conversions, view earnings, and request payouts (minimum $25).

📝

Changelog

Version history for all bot knowledge updates — features, fixes, improvements, and training additions.

🔔

Push Notifications

Web Push (VAPID) subscription management. Subscribe to bot update events from service workers.

Pro Subscription

$4.99/month. Unlimited cross-session memory, all-device sync, priority processing.

👥

Collaboration

Bot-to-bot consultation network stats and full graph for visualizations.

Platform Highlights

Bots
134 specialized AI bots
Chat rate
999 msg/hr (purchased)
Free preview
5 messages per bot
Dev API limit
100 calls/day (starter)
Webhook events
message.sent, message.received
Auth
JWT Bearer + API Key
Gift cards
$5 / $10 / $25 / $50 / $100
Pro subscription
$4.99 / month

Rate Limits

ContextLimitWindow
Chat — free users30 messagesPer hour, per bot
Chat — purchased users999 messagesPer hour, per bot
Free preview messages5 messagesPer bot, lifetime per session
Developer API (starter tier)100 callsPer day (resets UTC midnight)
General API endpoints100 requestsPer 15 minutes per IP
Search endpoints60 requestsPer 15 minutes
Admin endpoints200 requestsPer 15 minutes