🔌 Public API
Free REST API for developers. No authentication required. Use it in your own projects!
Base URL: https://tools.psyqo.org
📊 Tool Usage Stats
GET/api/tool-usage/{tool_id}Get use count
Returns how many times a specific tool has been used.
| Parameter | Type | Description |
|---|---|---|
| tool_id | string | Tool identifier (e.g., password-generator, qr-code) |
Example:
GET /api/tool-usage/password-generator Response: { "ok": true, "count": 12453 }
POST/api/tool-usage/{tool_id}Increment counter
Increments the use counter for a tool. No body required.
POST /api/tool-usage/password-generator Response: {"ok": true}
🏆 Game Leaderboard
GET/api/leaderboard/{game}Top 10 scores
Returns top-10 high scores for a game.
| Parameter | Type | Description |
|---|---|---|
| game | string | Game ID (e.g., snake-game, tetris, typing-speed) |
GET /api/leaderboard/snake-game Response: { "ok": true, "scores": [ {"name": "Alice", "score": 4850, "ts": "2025-01-15 14:22 UTC"}, {"name": "Bob", "score": 3200, "ts": "2025-01-14 09:11 UTC"} ] }
POST/api/leaderboardSubmit a score
| Field | Type | Description |
|---|---|---|
| game | string | Game ID |
| name | string | Player name (max 20 chars) |
| score | integer | Score value (0 – 99,999,999) |
POST /api/leaderboard Content-Type: application/json { "game": "snake-game", "name": "Alice", "score": 4850 } Response: {"ok": true}
🌐 DNS Lookup
POST/api/dnsResolve domain
| Field | Type | Description |
|---|---|---|
| domain | string | Domain name to resolve (e.g., example.com) |
POST /api/dns Content-Type: application/json {"domain": "example.com"} Response: { "ok": true, "domain": "example.com", "records": [ {"type": "A", "value": "93.184.216.34"}, {"type": "AAAA", "value": "2606:2800:220:1:248:1893:25c8:1946"} ] }
💾 Software
GET/api/softwareList all software
Returns all available desktop software with download links and version info.
GET /api/software Response: JSON array of software objects with name, version, download URL, description, and feature list.
🖼️ Tool Embedding
Embed any of our 375+ tools on your own website for free. Just use an iframe:
<iframe src="https://tools.psyqo.org/embed/tools/security/password-generator" width="100%" height="500" frameborder="0" style="border-radius: 12px;" ></iframe>
Replace security/password-generator with any category/tool-id from our tools hub.
⚡ Rate Limits
All limits are per IP address. Exceeded requests receive HTTP 429 Too Many Requests with a Retry-After header.
| Endpoint | Limit | Window | Reason |
|---|---|---|---|
| All /api/* endpoints | 120 requests | Per minute | Global guard |
| GET /api/tool-usage/* | 60 requests | Per minute | Read cache friendly |
| POST /api/tool-usage/* | 30 requests | Per minute per tool | Prevent counter stuffing |
| GET /api/leaderboard/* | 30 requests | Per minute | Prevent bulk scraping |
| POST /api/leaderboard | 10 requests | Per minute | Prevent fake score flooding |
| GET /api/reviews/* | 30 requests | Per minute | Standard read limit |
| POST /api/reviews | 5 requests | Per hour | Prevent spam reviews |
| POST /api/tool-requests | 20 requests | Per hour | Votes + submissions combined |
| GET /api/tool-requests | 30 requests | Per minute | Standard read limit |
| POST /api/dns | 15 requests | Per minute | Server-side network call |
FAIR USE
No authentication or API key required. These limits are generous for legitimate use.
If you need higher limits for a specific project, contact us.
Automated abuse, scraping, or score manipulation will result in IP blocks.
If you need higher limits for a specific project, contact us.
Automated abuse, scraping, or score manipulation will result in IP blocks.