API
API pro platformy
Ověřte telefon, číslo účtu, e-mail nebo web dřív, než s ním vaši uživatelé obchodují. Jeden dotaz, odpověď do zlomku vteřiny.
Co API vrací
Počet ověřených hlášení v databázi Neklikni, jejich kategorie a období a u webů také shodu se seznamem rizikových e-shopů České obchodní inspekce. Nevrací osobní údaje z hlášení a hodnotu vrací jen maskovanou.
API neoznačuje nikoho za podvodníka. Říká, kolik hlášení k údaji evidujeme. Jak s tím naložíte, třeba upozornění uživateli nebo ruční kontrola, rozhodujete vy.
Přístup
Každý dotaz posílejte s hlavičkou x-api-key. Klíč volejte jen ze svého serveru, nikdy z prohlížeče nebo mobilní aplikace. API nemá CORS. Klíč si vygenerujete ve firemním účtu, zkušební verze je zdarma.
Ověřit jeden údaj
POST /api/v1/lookup. Podporuje telefon, číslo účtu (i IBAN), e-mail, web nebo doménu a Facebook profil. Typ se pozná sám.
curl -X POST https://www.neklikni.cz/api/v1/lookup \
-H "x-api-key: $NEKLIKNI_API_KEY" \
-H "Content-Type: application/json" \
-d '{"value": "+420 777 123 456"}'{
"type": "phone",
"value_masked": "+420 7** *** *56",
"risk": "elevated",
"reports": {
"count": 2,
"categories": [{ "category": "non_delivery", "count": 2 }],
"first_seen": "2026-09-14",
"last_seen": "2026-10-30"
},
"coi": { "listed": false, "reason": null, "reported_date": null, "source_url": null },
"alerts": { "count": 0, "latest": null },
"checked_at": "2026-11-09T15:20:00.000Z"
}Prověřit text zprávy
POST /api/v1/scan najde v textu (do 4 000 znaků) telefony, účty, e-maily a weby, ověří až 10 z nich a vrátí nejvyšší riziko. Hodí se na zprávy mezi uživateli a texty inzerátů. Do limitu se počítá jako jeden dotaz.
curl -X POST https://www.neklikni.cz/api/v1/scan \
-H "x-api-key: $NEKLIKNI_API_KEY" \
-H "Content-Type: application/json" \
-d '{"text": "Zálohu pošlete na 123456789/0800, info na prodej-iphone.top"}'{
"risk": "high",
"items": [ { "type": "account", "risk": "no_reports", ... },
{ "type": "website", "risk": "high", ... } ],
"checked_at": "2026-11-09T15:20:00.000Z"
}Úroveň rizika
- high
- Web je na seznamu ČOI, údaj je ve zveřejněném varování neklikni.cz, nebo k němu evidujeme 3 a více hlášení.
- elevated
- K údaji evidujeme 1–2 hlášení.
- no_reports
- Žádné hlášení. To neznamená, že je údaj bezpečný, jen o něm zatím nevíme.
Chyby a limity
Chyby mají tvar { "error": { "code", "message" } }. 401 znamená chybějící nebo neplatný klíč, 400 nerozpoznaný údaj a 429 vyčerpaný denní limit. Zbývající dotazy vrací hlavička x-ratelimit-remaining.