For faucet owners
The standard shortlink API your faucet script already speaks, plus two things most shortlinks don't give you: a completion check by visitor IP and signed callbacks. Credit a claim only when the visitor really went through the link.
| United Kingdom | $2.00 |
| United States | $2.00 |
| Canada | $1.60 |
| All other countries | $0.40 |
Call the API with your claim URL, including a one-time key. You get a short link back to show on your wall.
The destination is only released after the last page, once per visit. It never appears in the page source.
Before crediting, ask the completion check whether the claimer's IP finished this link, or wait for our callback.
Step 1
GET https://new.linknero.com/api?api=YOUR_TOKEN
&url=https%3A%2F%2Fyourfaucet.example%2Fsl%3Fkey%3D9f2c
{"status":"success","message":"",
"shortenedUrl":"https://new.linknero.com/Xk3p9"}
Step 3 · option A
GET https://new.linknero.com/api/check?api=YOUR_TOKEN
&alias=Xk3p9&ip=203.0.113.7&minutes=60
{"status":"success","alias":"Xk3p9",
"completions":1,
"last_completed":"2026-11-17T20:14:03Z",
"ip_completed":true}
Step 3 · option B
POST https://yourfaucet.example/linknero-hook
X-Linknero-Timestamp: 1795465200
X-Linknero-Signature: 5d41402abc4b2a76…
{"event":"link.completed","id":81234,
"alias":"Xk3p9","short_url":"https://new.linknero.com/Xk3p9",
"ip":"203.0.113.7","country":"US","paid":true,
"completed_at":"2026-11-17T20:14:03Z"}
// PHP: check it
$body = file_get_contents('php://input');
$sig = hash_hmac('sha256', $_SERVER['HTTP_X_LINKNERO_TIMESTAMP'].'.'.$body, SECRET);
if (!hash_equals($sig, $_SERVER['HTTP_X_LINKNERO_SIGNATURE'])) exit;
Getting paid