Démarrage rapide de l’API

Obtenez votre clé API

L’API nécessite un compte Pro actif. Dans votre compte, créez une clé API et copiez-la : elle ne s’affiche qu’une seule fois. Enregistrez-la comme secret NOCALL_API_KEY sur votre serveur, jamais dans du code exécuté par le navigateur.

1. 1

   Créez une API key dans votre compte et copiez la valeur affichée une seule fois. Configurez NOCALL_API_KEY comme secret sur votre serveur. Utilisez HTTPS ; ne mettez jamais la clé dans le code du navigateur, les dépôts, captures ou journaux.

2. 2

   Envoyez la clé complète dans Authorization: Bearer, avec un espace après Bearer. N’utilisez pas X-API-Key et ne placez pas la clé dans l’URL.

• Créer une clé API ↗

Votre première requête

Envoyez POST /v2/tools avec l’en-tête Authorization: Bearer et un corps JSON contenant tool et phone, par exemple pour who-calls. Utilisez une nouvelle Idempotency-Key pour chaque opération afin de pouvoir la réessayer sans second débit.

Les 44 tools sont tous disponibles via l’API : appelez POST /v2/<tool-id>, ou POST /v2/tools avec le champ tool dans le corps. Chaque tool a son propre corps JSON, documenté dans son guide. data.result contient le résultat du tool. Utilisez les identifiants du tableau.

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);

La réponse

data.result contient le résultat et meta inclut requestId, unitsCharged et l’usage de la période. La référence API détaille les champs de toutes les tools.

data contient le résultat ; meta fournit requestId, unitsCharged et l’utilisation si applicable. L’extrait fictif montre le solde après une requête. Un résultat valide sans données coûte aussi 1 crédit ; les erreurs de validation ou de fournisseur et la lecture du solde ne sont pas facturées. L’absence de données ne prouve pas qu’un numéro est sûr. Les schémas complets figurent dans OpenAPI.

Crédits et erreurs

Chaque résultat valide consomme 1 crédit, même sans données ; les erreurs de validation sont gratuites. 401 signifie que la clé est absente ou invalide, 403 qu’aucun Pro n’est actif et 429 que les crédits sont épuisés ou que la limite de requêtes est atteinte.

Guides associés

• Référence APIChaque appel à l'API coûte 1 crédit. Les crédits mensuels sont utilisés en premier.
• Qui m’appelle ?Découvrez qui a appelé depuis un numéro inconnu. Consultez les signalements de la communauté, vérifiez les préfixes et protégez-vous des arnaques téléphoniques.
• Risque téléphoniqueSaisissez un numéro pour consulter des données approuvées et limitées par la confidentialité.

Guides associés

• Référence API
• Qui m’appelle ?
• Risque téléphonique