Adresáře

Operátoři

API · Pro2026-10-28

Pokrytí: Oblasti pocházejí z oficiálního číslovacího plánu země každé edice. Španělsko uvádí provincii pro každý rozsah pevných linek; mnoho dalších zemí uvádí své předvolby a města. Mobilní čísla nemají oblast v žádné zemi a několik zemí zatím nezveřejňuje plán, který bychom mohli načíst: tam ukazujeme jen druh linky.

Otevřít nástroj

Na této stránce

Účel

Otevřete adresář své edice, zvolte kategorii a otevřete záznam. Počty popisují dostupná data NoCall, nikoli všechny hovory v zemi. Chybějící data nedokazují, že je číslo bezpečné.

Požadavky

Tyto návody může číst kdokoli, i bez účtu. Některé nástroje vyžadují Pro, jak uvádí příslušný návod.

Jak používat

Vyberte edici země, otevřete kategorii nebo řádek a prohlédněte dostupné podrobnosti.
Filtrovat podle operátora nebo předvolby
Operátoři

Smyšlený příklad

Smyšlený příklad, nikoli skutečný dotaz. Nevolejte ani neotevírejte jeho odkazy.

+44 1632 960123

Jak chápat výsledek

Orientační informace ze zveřejněných číslovacích plánů. Popisuje druh čísla, nikdy osobu ani firmu, která za ním stojí.

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

Omezení

Pouze formáty a podporované předvolby. Nepotvrzují polohu, majitele ani aktivitu čísla. Některé předvolby jsou sdílené.

Řešení potíží

Zkuste jinou značku, právní název nebo třímístnou předvolbu.

Zkuste to znovu za pár minut nebo vyhledejte číslo přímo.

Použít přes API

Vyžaduje API klíč a kredity. Každé dokončené volání stojí 1 kredit, i když nejsou k dispozici žádná data. Aktivní účet Pro zahrnuje 20 kreditů na kalendářní měsíc UTC, sdílených všemi cestami API a čerpaných jako první; nevyčerpané měsíční kredity se nepřevádějí. Kredity zakoupené na stránce vašeho účtu fungují i bez Pro a nikdy nevyprší.

Chyby se nikdy neúčtují: 401 invalid_api_key (chybějící nebo neplatný klíč), 403 pro_required (žádné kredity Pro ani zakoupené kredity), 422 neplatný vstup, 429 quota_exceeded (žádné zbývající kredity), rate_limit_exceeded nebo ai_busy (AI pro sms-check je plně vytížená), 503 tool_warming (data se teprve připravují) nebo tool či poskytovatel nedostupný. Po odpovědi 429 nebo 503 to zkuste znovu, až uplyne počet sekund z hlavičky Retry-After.

Španělští operátoři s jejich předvolbami, typem čísla a počtem spamu, plus speciální předvolby. Pouze ES.

Pošli tělo JSON na vlastní cestu toolu, nebo na POST /v2/tools s přidaným polem tool. Obě cesty vrátí stejný výsledek.

POST https://api.nocall.io/v2/operator-directory
POST https://api.nocall.io/v2/tools  {"tool":"operator-directory","country":"ES","operator":"Movistar"}

Parametry

Název	Typ	Povinný	Popis
country	"ES"	Ne (výchozí: "ES")	Země dat. Podporována je pouze ES.
operator	string (1–60)	Ne	Pouze tento operátor, podle názvu.

REQUEST_ID="$(uuidgen)" && [ -n "$REQUEST_ID" ] &&
curl --request POST 'https://api.nocall.io/v2/operator-directory' \
  --header "Authorization: Bearer $NOCALL_API_KEY" \
  --header 'Content-Type: application/json' \
  --header "Idempotency-Key: $REQUEST_ID" \
  --data '{"country":"ES","operator":"Movistar"}'

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/operator-directory',
    method='POST',
    data=json.dumps({'country': 'ES', 'operator': 'Movistar'}).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/operator-directory', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer ' + apiKey,
    'Content-Type': 'application/json',
    'Idempotency-Key': requestId,
  },
  body: JSON.stringify({ country: 'ES', operator: 'Movistar' }),
});
const result = await response.json();
if (!response.ok) throw new Error(result.error?.code ?? 'request_failed');
console.log(result.data.result, result.meta.unitsCharged);

Ukázková odpověď (200)

Jde o zdokumentovaný příklad z reference API. Vyhledávání používají smyšlené číslo a agregace i odpovědi AI ukazují tvar výsledku, ne živá data.

{
  "data": {
    "tool": "operator-directory",
    "result": {
      "operators": [
        {
          "name": "Movistar",
          "prefixes": [
            "609",
            "619"
          ],
          "numberType": "mobile",
          "spamCount": 0
        }
      ],
      "specialPrefixes": [
        {
          "prefix": "400",
          "name": "Llamadas comerciales",
          "type": "commercial",
          "cost": "no_callback",
          "risk": "medium"
        },
        {
          "prefix": "800",
          "name": "Llamada gratuita",
          "type": "toll_free",
          "cost": "free",
          "risk": "low"
        },
        {
          "prefix": "900",
          "name": "Llamada gratuita",
          "type": "toll_free",
          "cost": "free",
          "risk": "low"
        },
        {
          "prefix": "901",
          "name": "Coste compartido",
          "type": "premium",
          "cost": "shared",
          "risk": "medium"
        },
        {
          "prefix": "902",
          "name": "Coste extra",
          "type": "premium",
          "cost": "expensive",
          "risk": "high"
        },
        {
          "prefix": "903",
          "name": "Teléfono premium",
          "type": "premium",
          "cost": "very_expensive",
          "risk": "critical"
        },
        {
          "prefix": "905",
          "name": "Televoto",
          "type": "premium",
          "cost": "very_expensive",
          "risk": "critical"
        },
        {
          "prefix": "906",
          "name": "Teléfono premium",
          "type": "premium",
          "cost": "very_expensive",
          "risk": "critical"
        },
        {
          "prefix": "907",
          "name": "VoIP España",
          "type": "premium",
          "cost": "expensive",
          "risk": "high"
        },
        {
          "prefix": "908",
          "name": "VoIP España",
          "type": "premium",
          "cost": "expensive",
          "risk": "high"
        },
        {
          "prefix": "909",
          "name": "VoIP España",
          "type": "premium",
          "cost": "expensive",
          "risk": "high"
        },
        {
          "prefix": "803",
          "name": "Servicios para adultos",
          "type": "premium",
          "cost": "very_expensive",
          "risk": "critical"
        },
        {
          "prefix": "806",
          "name": "Entretenimiento",
          "type": "premium",
          "cost": "very_expensive",
          "risk": "high"
        },
        {
          "prefix": "807",
          "name": "Servicios profesionales",
          "type": "premium",
          "cost": "very_expensive",
          "risk": "high"
        },
        {
          "prefix": "704",
          "name": "Número personal",
          "type": "premium",
          "cost": "expensive",
          "risk": "medium"
        }
      ]
    }
  },
  "meta": {
    "requestId": "req_example",
    "unitsCharged": 1,
    "usage": {
      "periodStart": "2026-10-01",
      "unitLimit": 20,
      "unitsUsed": 3,
      "unitsRemaining": 17
    }
  }
}

Pole výsledku (data.result)

Pole	Typ	Popis
operators	array<object>	Operátoři s jejich předvolbami, typem čísla a počtem spamu (null, pokud není k dispozici).
specialPrefixes	array<object>	Speciální předvolby s názvem, typem, cenou a rizikem.

Dokumentace API