เอกสารอ้างอิง API

การยืนยันตัวตน

สร้างคีย์ API ในบัญชีแล้วคัดลอกค่าที่แสดงครั้งเดียว ตั้ง NOCALL_API_KEY เป็นความลับบนเซิร์ฟเวอร์ ใช้ HTTPS และอย่าใส่คีย์ในโค้ดเบราว์เซอร์ คลังโค้ด ภาพหน้าจอ หรือบันทึก

ส่งคีย์เต็มใน Authorization: Bearer โดยเว้นวรรคหลัง Bearer หนึ่งช่อง ไม่ใช้ X-API-Key และไม่ใส่คีย์ใน URL

บน /v1/data/* + /v2/* คีย์ที่ถูกต้องใช้แทนหลักฐาน ByteGuard ของเบราว์เซอร์ ยังตรวจวันหมดอายุ การเพิกถอน สมาชิก เครดิต และข้อจำกัด คีย์ไม่อนุญาตเส้นทางอื่น openapi.json และ products เป็นข้อมูลสาธารณะ

Authorization: Bearer <NOCALL_API_KEY>

• สร้างคีย์ API ↗

การค้นหาครั้งแรก

tools ทั้ง 44 รายการใช้งานได้ผ่าน API: เรียก POST /v2/<tool-id> หรือ POST /v2/tools โดยใส่ฟิลด์ tool ใน body แต่ละ tool มี JSON body ของตัวเองตามที่อธิบายไว้ในคู่มือ data.result มีผลลัพธ์ของ tool ใช้ตัวระบุตามตาราง

สร้าง Idempotency-Key ใหม่สำหรับแต่ละงานใหม่ เก็บคีย์เดิมไว้เฉพาะเมื่อลองงานเดิมด้วยข้อมูลเดิมอีกครั้ง

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

tools ทั้ง 44 รายการใช้งานได้ผ่าน API: เรียก POST /v2/<tool-id> หรือ POST /v2/tools โดยใส่ฟิลด์ tool ใน body แต่ละ tool มี JSON body ของตัวเองตามที่อธิบายไว้ในคู่มือ data.result มีผลลัพธ์ของ tool ใช้ตัวระบุตามตาราง

• OpenAPI v2 ↗

เอนด์พอยต์ที่ใช้ได้

แสดงเฉพาะข้อมูลทางเทคนิคที่ตรวจสอบแล้วหรือเป็นสาธารณะ ตัวตนส่วนตัวและสัญญาณการป้องกันจะถูกซ่อนไว้

API v1 · ต้องมี phone ไม่เกิน64ตัวอักษร แนะนำ E.164 ส่วน country เป็นรหัสประเทศสองตัวที่รองรับ ไม่บังคับและค่าเริ่มต้นคือ ES โดย Content-Type ต้องเป็น application/json

• OpenAPI 3.1 ↗

ผลตอบกลับ

data คือผลลัพธ์ ส่วน meta มี requestId, unitsCharged และการใช้งาน ตัวอย่างสมมติแสดงยอดหลังค้นหา ผลลัพธ์ที่ถูกต้องแม้ไม่พบข้อมูลก็ใช้1เครดิต ข้อผิดพลาดในการตรวจสอบหรือจากผู้ให้บริการและการดูยอดไม่คิดเครดิต การไม่มีข้อมูลไม่ได้ยืนยันว่าเบอร์ปลอดภัย ดู 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 ↗

เครดิตและข้อจำกัด

การเรียก API แต่ละครั้งใช้ 1 เครดิต โดยใช้เครดิตรายเดือนก่อน

การสร้างใหม่จะปิดใช้งานคีย์เดิม ยอดเครดิตของคุณจะไม่เปลี่ยนแปลง

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

• คีย์ API และเครดิต ↗

ลองใหม่และค้นหาเป็นชุด

สร้าง Idempotency-Key ใหม่สำหรับแต่ละงานใหม่ เก็บคีย์เดิมไว้เฉพาะเมื่อลองงานเดิมด้วยข้อมูลเดิมอีกครั้ง

Idempotency-Key ไม่บังคับสำหรับคำขอเดี่ยว แต่บังคับสำหรับชุด ใช้8–128ตัวอักษร ตัวเลข จุด ขีดกลาง ขีดล่าง หรือโคลอน เมื่อลองใหม่ให้ใช้รหัส เส้นทาง คีย์ API และเนื้อหาเดิม การตอบซ้ำไม่คิดเครดิตซ้ำ หากผลไม่ชัดเจนให้ตรวจยอดก่อน

หนึ่งชุดรับได้50รายการ product เลือกการทำงาน ก่อนเริ่มต้องมีเครดิตพอสำหรับทุกรายการที่ถูกต้อง คิดเฉพาะผลที่ถูกต้องและเสร็จสมบูรณ์ คำขอพร้อมกันใช้ยอดร่วมกัน หากหมดก่อนหักขั้นสุดท้ายจะคืน429โดยไม่คิดเครดิตคำขอนั้น

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"}]}'

การแก้ไขปัญหา

คู่มือที่เกี่ยวข้อง

• ข่าวกรองโทรศัพท์
• ความเสี่ยงโทรศัพท์
• ค้นหาผู้ให้บริการ
• หมายเลขของฉันรั่วไหลหรือไม่?
• ค้นหาบริษัทยืนยันแบบย้อนกลับ