All API requests require an API key in the Authorization header.
Authorization: Bearer <YOUR_API_KEY>
Your API key is created automatically when you register and is visible in the dashboard. Keep it secret.
Example base URL: api.proxyscore.xyz
// Example (do NOT expose these internals publicly)
POST https://<ENDPOINT_URL>/v1/test/ips
Headers: Authorization: Bearer <API_KEY>
Content-Type: application/json
Submit up to a configured limit of IPs for scoring. Each tested IP consumes 1 token (free or paid).
Method:POST/v1/test/ips
{
"ips": ["8.8.8.8", "1.1.1.1"],
"options": {
"fast": true,
"risk_threshold": 50
}
}
curl -X POST "https://<ENDPOINT_URL>/v1/test/ips" \
-H "Authorization: Bearer <API_KEY>" \
-H "Content-Type: application/json" \
-d '{"ips":["8.8.8.8","1.1.1.1"]}'
{
"success": true,
"results": [...],
"tokens": {
"remaining_free": 1,
"remaining_api": 42
}
}
Get current balances & account metadata.
Method:GET/v1/account
{
"success": true,
"user": {
"email": "user@example.com",
"userType": "enduser",
"tokens": { "free": 1, "endUser": 5, "api": 0 },
"limits": { "rate_limit_per_minute": 100 }
}
}
| Code | Meaning |
|---|---|
| 400 | Invalid input or missing parameters |
| 401 | Unauthorized — missing/invalid API key |
| 403 | Not enough tokens or blocked |
| 429 | Rate limit exceeded |
| 500 | Server error — retry with backoff |
Default: ~1,000,000 req/week per API key. Distributed batches allowed (approx twice a week if needed). Batch size: 50 → 50k.
const fetch = require('node-fetch');
async function testIps(apiKey, ips){
const res = await fetch('https://<ENDPOINT_URL>/v1/test/ips', {
method:'POST',
headers:{'Authorization':`Bearer ${apiKey}`,'Content-Type':'application/json'},
body:JSON.stringify({ips})
});
if(res.status!==200) throw new Error('API error '+res.status);
return res.json();
}
Internal routing & service hosts are hidden. Use the provided assigned base URL for requests. Do not expose internals publicly.
Credits are purchased from the dashboard and added to your API balance. Webhooks for payment confirmations will be available on request.
Telegram: @theusualkeysersoze