API ทำนายเพศจากอีเมล

ภาพรวมคำขอ

จากอีเมลสู่การทำนายเพศ

GenderAPI วิเคราะห์ส่วน local ของอีเมลเพื่อแยกชื่อที่เป็นไปได้มากที่สุดและใช้ทำนายเพศ หากทราบภูมิภาคของผู้ใช้ ให้เพิ่มรหัสประเทศ

01อีเมลที่ป้อนaraya.suriya@example.com

02แยกชื่อAraya

03การทำนายmale · 97%

วิธีPOST

ชนิดเนื้อหาapplication/json

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

เครดิตที่ใช้1 การค้นหา

ความเป็นส่วนตัวของข้อมูลอีเมล: GenderAPI ไม่จัดเก็บคำขออีเมล ดูรายละเอียดใน นโยบายความเป็นส่วนตัว

HDR

HTTP header ที่จำเป็น

ยืนยันตัวตนของคำขอ

Content-Typeapplication/json

AuthorizationBearer YOUR_API_KEY

เนื้อหาคำขอ JSON

พารามิเตอร์

พารามิเตอร์	ชนิด	ข้อกำหนด	คำอธิบาย
`email`	string	จำเป็น	อีเมลที่ต้องการวิเคราะห์ GenderAPI จะแยกชื่อที่เป็นไปได้มากที่สุดก่อนทำนาย
`country`	string	ไม่บังคับ	เพิ่มบริบทภูมิภาคด้วยรหัสประเทศ ISO 3166-1 alpha-2 เช่น TH หรือ US
`askToAI`	boolean	ไม่บังคับ	เมื่อเป็น true ระบบจะใช้ AI เสริมหากไม่พบชื่อที่แยกได้ในฐานข้อมูล

AI เสริม

ระบบใช้ askToAI หลังแยกชื่อและเฉพาะเมื่อไม่พบชื่อนั้นในฐานข้อมูล endpoint อีเมล forceToGenderizeไม่รองรับ

ตัวอย่างโค้ด

ส่งคำขออีเมล

cURL

curl -X POST "https://api.genderapi.io/api/email" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"email":"araya.suriya@example.com","country":"TH","askToAI":true}'

JavaScript

const response = await fetch("https://api.genderapi.io/api/email", {
  method: "POST",
  headers: { "Content-Type": "application/json", "Authorization": "Bearer YOUR_API_KEY" },
  body: JSON.stringify({ email: "araya.suriya@example.com", country: "TH", askToAI: true })
});
const data = await response.json();

Python

import requests

response = requests.post(
  "https://api.genderapi.io/api/email",
  headers={"Authorization": "Bearer YOUR_API_KEY"},
  json={"email": "araya.suriya@example.com", "country": "TH", "askToAI": True}
)
print(response.json())

ผลลัพธ์ 200

การแยกชื่อและทำนายเพศ

JSON

{
  "status": true,
  "used_credits": 1,
  "remaining_credits": 4999,
  "expires": 1743659200,
  "q": "araya.suriya@example.com",
  "name": "Araya",
  "gender": "male",
  "country": "TH",
  "total_names": 10345,
  "probability": 97,
  "duration": "5ms"
}

ฟิลด์ผลลัพธ์

ฟิลด์	ชนิด	คำอธิบาย
`status`	boolean	ระบุว่าคำขอประมวลผลโดยไม่มีข้อผิดพลาดหรือไม่
`used_credits`	integer	จำนวนเครดิตที่ใช้กับคำขอ
`remaining_credits`	integer	จำนวนเครดิตที่เหลือหลังคำขอ
`expires`	integer	UNIX timestamp ของเวลาที่แพ็กเกจหมดอายุ
`q`	string	อีเมลเดิมที่ส่ง
`name`	string	ชื่อที่แยกจากอีเมล
`gender`	string \| null	ผลการทำนายเป็น male, female หรือ null
`country`	string	รหัสประเทศที่ใช้ในการทำนาย
`total_names`	integer	จำนวนระเบียนชื่อที่ใช้เป็นพื้นฐานในการทำนาย
`probability`	integer	ค่าความเชื่อมั่นของการทำนายเป็นเปอร์เซ็นต์
`duration`	string	เวลาประมวลผลของเซิร์ฟเวอร์

ใช้อีเมลที่ถูกต้องและครบถ้วน

ผลการแยกชื่อขึ้นอยู่กับโครงสร้างอีเมล กล่องจดหมายส่วนกลาง นามแฝง หรือ local part ที่ไม่มีชื่อซึ่งระบุได้อาจคืนผลว่าง ตรวจสอบ name, gender และ probability ก่อนใช้ผลการทำนาย คำขออีเมลจะไม่ถูกจัดเก็บ

คู่มือถัดไป

วิเคราะห์หลายอีเมล

คำขอหลายอีเมลประมวลผลหลายอีเมลในคำขอเดียว →คำขอชื่อเดียวส่งชื่อที่ทราบโดยตรง →