Dokumentace API

Ověření totožnosti

V účtu vytvoř API klíč a zkopíruj jednou zobrazenou hodnotu. Nastav NOCALL_API_KEY jako tajný údaj na serveru. Používej HTTPS; nikdy nedávej klíč do kódu prohlížeče, repozitářů, snímků ani logů.

Pošli celý klíč v Authorization: Bearer s jednou mezerou za Bearer. Nepoužívej X-API-Key ani klíč v URL.

Na /v1/data/* + /v2/* platný klíč nahrazuje důkaz ByteGuard prohlížeče. Stále se kontroluje vypršení, odvolání, předplatné, kredity a limity. Nezpřístupní jiné cesty. openapi.json a products jsou veřejné.

Authorization: Bearer <NOCALL_API_KEY>

• Vytvořit klíč API ↗

První dotaz

Všech 44 toolů je dostupných přes API: zavolejte POST /v2/<tool-id>, nebo POST /v2/tools s polem tool v těle. Každý tool má vlastní tělo JSON, popsané v jeho návodu. data.result obsahuje výsledek toolu. Používejte identifikátory z tabulky.

Pro každou novou operaci vygenerujte nový Idempotency-Key. Ponechte jej pouze pro opakování stejné operace se stejnými daty.

REQUEST_ID="$(uuidgen)" && [ -n "$REQUEST_ID" ] &&
curl --request POST 'https://api.nocall.io/v2/tools' \
  --header "Authorization: Bearer $NOCALL_API_KEY" \
  --header 'Content-Type: application/json' \
  --header "Idempotency-Key: $REQUEST_ID" \
  --data '{"tool":"who-calls","phone":"+12025550123","country":"US"}'

import json
import os
import urllib.request
import uuid

api_key = os.environ.get('NOCALL_API_KEY')
if not api_key:
    raise SystemExit('Set NOCALL_API_KEY')

request = urllib.request.Request(
    'https://api.nocall.io/v2/tools',
    method='POST',
    data=json.dumps({'tool': 'who-calls', 'phone': '+12025550123', 'country': 'US'}).encode(),
    headers={
        'Authorization': 'Bearer ' + api_key,
        'Content-Type': 'application/json',
        'Idempotency-Key': str(uuid.uuid4()),
    },
)
with urllib.request.urlopen(request, timeout=30) as response:
    result = json.load(response)
print(result['data']['result'], result['meta']['unitsCharged'])

import { randomUUID } from 'node:crypto';

const requestId = randomUUID();
const apiKey = process.env.NOCALL_API_KEY;
if (!apiKey) throw new Error('Set NOCALL_API_KEY');

const response = await fetch('https://api.nocall.io/v2/tools', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer ' + apiKey,
    'Content-Type': 'application/json',
    'Idempotency-Key': requestId,
  },
  body: JSON.stringify({ tool: 'who-calls', phone: '+12025550123', country: 'US' }),
});
const result = await response.json();
if (!response.ok) throw new Error(result.error?.code ?? 'request_failed');
console.log(result.data.result, result.meta.unitsCharged);

API v2 · tools

Všech 44 toolů je dostupných přes API: zavolejte POST /v2/<tool-id>, nebo POST /v2/tools s polem tool v těle. Každý tool má vlastní tělo JSON, popsané v jeho návodu. data.result obsahuje výsledek toolu. Používejte identifikátory z tabulky.

• OpenAPI v2 ↗

Dostupné endpointy

Zobrazujeme jen ověřená nebo veřejná technická fakta. Soukromé identity a ochranné signály zůstávají skryté.

API v1 · phone je povinný: řetězec do 64 znaků, ideálně E.164. country je podporovaný dvoupísmenný kód země; nepovinný, výchozí ES. Content-Type musí být application/json.

• OpenAPI 3.1 ↗

Odpovědi

data obsahuje výsledek; meta zahrnuje requestId, unitsCharged a případné využití. Fiktivní ukázka zobrazuje zůstatek po dotazu. Platný výsledek bez dat také stojí 1 kredit; chyby validace, poskytovatele a čtení zůstatku jsou zdarma. Chybějící data nedokazují bezpečnost čísla. Úplná schémata jsou v OpenAPI.

{
  "data": {
    "tool": "who-calls",
    "result": {
      "phoneNumber": "+12025550123",
      "found": true,
      "updatedAt": "2026-10-01T09:30:00.000Z",
      "risk": {
        "score": 72,
        "level": "high"
      },
      "reportCount": 14,
      "categories": [
        "TELEMARKETING"
      ],
      "verified": false,
      "carrier": null,
      "verifiedBusiness": null
    }
  },
  "meta": {
    "requestId": "req_example",
    "unitsCharged": 1,
    "usage": {
      "periodStart": "2026-10-01",
      "unitLimit": 20,
      "unitsUsed": 3,
      "unitsRemaining": 17
    }
  }
}

• OpenAPI v2 ↗

Kredity a limity

Každé volání API stojí 1 kredit. Nejprve se čerpají měsíční.

Obnovení deaktivuje předchozí klíče. Zůstatek kreditů se nezmění.

curl 'https://api.nocall.io/v1/data/account' \
  --header "Authorization: Bearer $NOCALL_API_KEY"

• Klíč API a kredity ↗

Opakování a hromadné dotazy

Pro každou novou operaci vygenerujte nový Idempotency-Key. Ponechte jej pouze pro opakování stejné operace se stejnými daty.

Idempotency-Key je pro jednotlivé dotazy volitelný, pro dávky povinný: 8–128 znaků (písmena, číslice, tečky, pomlčky, podtržítka či dvojtečky). Při opakování zachovej stejný identifikátor, cestu, API klíč a tělo. Přehraná odpověď se znovu neúčtuje. Po nejasné odpovědi ověř zůstatek.

Dávka přijme nejvýše 50 vstupů. product vybírá operaci z ukázky. Před spuštěním musí zůstatek stačit na všechny platné vstupy; účtují se jen dokončené platné výsledky. Souběžné požadavky sdílejí zůstatek: dojde-li před konečným odečtem, požadavek vrátí 429 bez účtování.

8–128 ASCII: A–Z a–z 0–9 . _ : -
TTL: 24 h

phone-lookup
phone-risk
carrier-lookup
reverse-phone-lookup
phone-exposure

REQUEST_ID="$(uuidgen)" && [ -n "$REQUEST_ID" ] &&
curl --request POST 'https://api.nocall.io/v1/data/bulk-lookups' \
  --header "Authorization: Bearer $NOCALL_API_KEY" \
  --header 'Content-Type: application/json' \
  --header "Idempotency-Key: $REQUEST_ID" \
  --data '{"product":"phone-risk","inputs":[{"phone":"+12025550123","country":"US"}]}'

Řešení potíží

Související návody

• Telefonní inteligence
• Riziko telefonu
• Vyhledat operátora
• Uniklo moje číslo?
• Reverzní hledání ověřené firmy