🔌 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/leaderboard
Submit 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/dns
Resolve 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/software
List 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.