Sonjj API

Chào mừng đến với SonjjAPI — dịch vụ API mạnh mẽ cung cấp nhiều tiện ích khác nhau để nâng cao ứng dụng và đơn giản hóa quy trình làm việc của bạn.

Base URL: https://app.sonjj.com

Introduction

Chào mừng đến với SonjjAPI!

Dịch vụ API mạnh mẽ này cung cấp nhiều chức năng để nâng cao ứng dụng và đơn giản hóa quy trình làm việc của bạn:

Xác minh email — kiểm tra khả năng giao nhận và phát hiện địa chỉ disposable
Tạo email tạm thời — Gmail, Outlook và hộp thư tạm thời tổng hợp
Kiểm tra SEO — Moz, Ahrefs, phân tích backlink, trạng thái index Google
Tạo dữ liệu — hồ sơ người dùng, xác thực số điện thoại, chuyển HTML sang Markdown

SonjjAPI đều hỗ trợ.

Bắt Đầu

Đăng ký tại my.sonjj.com để tạo tài khoản
Lấy API key từ mục API trong dashboard của bạn
Mua credits — xem Hướng Dẫn Credits để biết chi tiết giá
Thực hiện request đầu tiên — thêm API key vào header X-Api-Key

Công Cụ & SDK

Bạn có thể dùng SonjjAPI với bất kỳ HTTP client nào:

cURL — kiểm tra nhanh từ command line
Python — requests hoặc httpx
JavaScript / Node.js — fetch hoặc axios
Postman / Insomnia — import trực tiếp schema OpenAPI

Hỗ Trợ

Tài liệu: sonjj.com/vi/docs
Blog & cập nhật: sonjj.com/vi/blog

Authentication

Xác Thực

Tất cả các request API đều yêu cầu xác thực bằng API key được truyền trong header của request.

Lấy API Key

Đăng nhập tại my.sonjj.com
Vào mục API
Sao chép X-Api-Key của bạn

Sử Dụng API Key

Thêm key vào header của mỗi request:

X-Api-Key: api_key_của_bạn

Ví Dụ Request

cURL

curl -X GET "https://app.sonjj.com/v1/check_email/validate?email=test@example.com" \
  -H "X-Api-Key: api_key_của_bạn"

Python

import requests

response = requests.get(
"https://app.sonjj.com/v1/check_email/validate",
params={"email": "test@example.com"},
headers={"X-Api-Key": "api_key_của_bạn"}
)
print(response.json())

JavaScript

const response = await fetch(
  "https://app.sonjj.com/v1/check_email/validate?email=test@example.com",
  { headers: { "X-Api-Key": "api_key_của_bạn" } }
);
const data = await response.json();

Lỗi Xác Thực

Status	Ý nghĩa
`401`	API key bị thiếu hoặc không hợp lệ
`403`	API key hợp lệ nhưng bị từ chối (không đủ credits hoặc plan)

Rate Limits

Giới Hạn Tốc Độ

SonjjAPI áp dụng giới hạn tốc độ (rate limit) để đảm bảo sử dụng công bằng và ổn định dịch vụ cho tất cả người dùng.

Cách Hoạt Động

Rate limit được áp dụng theo từng API key và theo dõi ở hai cấp độ:

Cấp độ	Giới hạn
Mỗi phút	Phụ thuộc vào plan của bạn
Mỗi ngày	Phụ thuộc vào plan của bạn

Khi vượt quá giới hạn, API trả về:

{
  "error": {
"code": 429,
"message": "Rate limit exceeded. Please wait before retrying."
  }
}

Thực Hành Tốt Nhất

Cache response ở phía bạn khi có thể
Áp dụng exponential backoff khi nhận lỗi 429
Sử dụng bulk endpoint khi có thay vì gọi lặp lại nhiều lần
Theo dõi credits và lượng request tại my.sonjj.com

Error Codes

Mã Lỗi

SonjjAPI sử dụng HTTP status code chuẩn và trả lỗi theo định dạng JSON nhất quán.

Định Dạng Lỗi

{
  "error": {
"code": 400,
"message": "Mô tả lỗi dễ đọc"
  }
}

Bảng HTTP Status Code

Code	Tên	Mô tả
`200`	OK	Request thành công
`400`	Bad Request	Tham số không hợp lệ hoặc thiếu trường bắt buộc
`401`	Unauthorized	Thiếu hoặc sai header `X-Api-Key`
`402`	Payment Required	Không đủ credits để thực hiện request
`403`	Forbidden	Từ chối truy cập — plan không bao gồm endpoint này
`404`	Not Found	Tài nguyên yêu cầu không tồn tại
`422`	Unprocessable Entity	JSON hợp lệ nhưng không vượt qua kiểm tra nghiệp vụ
`429`	Too Many Requests	Vượt quá rate limit — chờ và thử lại
`500`	Internal Server Error	Lỗi xảy ra ở phía server
`503`	Service Unavailable	Server tạm thời quá tải hoặc đang bảo trì

Xử Lý Lỗi

Ví dụ Python

import requests

response = requests.get(
"https://app.sonjj.com/v1/check_email/validate",
params={"email": "test@example.com"},
headers={"X-Api-Key": "api_key_của_bạn"}
)

if response.status_code == 200:
data = response.json()
elif response.status_code == 429:
print("Rate limit — cần xử lý backoff")
elif response.status_code == 402:
print("Không đủ credits")
else:
error = response.json().get("error", {})
print(f"Lỗi {error.get('code')}: {error.get('message')}")

Utilities

API chỉ cần một request để tạo ra kết quả!

GET /v1/check_email/ auth

Check email - số điểm yêu cầu: 2.00

Ngoài tính năng cơ bản là xác minh sự tồn tại của một địa chỉ email, API này còn kiểm tra xem tài khoản Gmail đó có bắt buộc phải xác minh số điện thoại khi đăng nhập hay không? của API này.

Parameters

query

Name	Type	Description
`email`*	`string`

Responses

200

3 giá trị trả về sẽ cho biết loại địa chỉ email, đó có phải là email dùng một lần hay không? và địa chỉ email có tồn tại hay không

Response schema

Property	Type	Description
`type`*	`string`	Type of email provider
`disposable`*	`string`	Is the email disposable?
`status`*	`string`	Status of the email
`avatar`	`string`	Avatar URL only for Gmail

422

Validation Error

Response schema

Property	Type	Description
`detail`	`array[object]`	Detail

GET /v1/check_gmail/ auth

Kiểm tra sự tồn tại, trạng thái tài khoản Gmail và truy xuất hình đại diện nếu có - điểm yêu cầu: 0.50

Mô tả: Kiểm tra sự tồn tại, trạng thái của tài khoản Gmail và truy xuất avatar nếu có. API này đặc biệt kiểm tra các tài khoản Gmail về các yêu cầu xác minh và trạng thái tài khoản của chúng.

Parameters

query

Name	Type	Description
`email`*	`string`	Mô tả: Địa chỉ Gmail cần kiểm tra (e.g. `example@gmail.com`)

Responses

200

Mô tả: Trả về trạng thái tài khoản Gmail, URL avatar (nếu có) và các yêu cầu xác minh

Response schema

Property	Type	Description
`email`*	`string`	Địa chỉ Gmail đã được kiểm tra
`status`*	`string`	Trạng thái tài khoản Gmail Enum: `Ok`, `Verify`, `Disable`, `NotExist`, `Disable\|NotExist`, `Error`
`avatar`	`string`

422

Mô tả: Lỗi xác thực

Response schema

Property	Type	Description
`detail`	`array[object]`	Detail

GET /v1/check_microsoft/ auth

Kiểm tra sự tồn tại và trạng thái tài khoản Microsoft - điểm yêu cầu: 0.50

Mô tả: Kiểm tra sự tồn tại và trạng thái của tài khoản Microsoft cho các địa chỉ email Outlook, Hotmail, Live và MSN. API này xác định xem tài khoản có tồn tại hay không và nó có những yêu cầu xác minh nào.

Parameters

query

Name	Type	Description
`email`*	`string`	Mô tả: Địa chỉ email Microsoft cần kiểm tra (e.g. `example@outlook.com`)

Responses

200

Mô tả: Trả về trạng thái tài khoản Microsoft và các yêu cầu xác minh

Response schema

Property	Type	Description
`email`*	`string`	Địa chỉ email Microsoft đã kiểm tra
`status`*	`string`	Trạng thái tài khoản Microsoft Enum: `Ok`, `Verify(sms\|2fa)`, `NotExist`, `Error`
`details`	`object`

422

Mô tả: Lỗi xác thực

Response schema

Property	Type	Description
`detail`	`array[object]`	Detail

GET /v1/check_disposable_email/ auth

Check Disposable Email Domain with Scoring - số điểm yêu cầu: 0.05

Response bao gồm các header tối ưu hóa cache cho Cloudflare

Parameters

query

Name	Type	Description
`domain`*	`string`	Tên miền để kiểm tra khả năng disposable (e.g. `10minutemail.com`)

Responses

200

Phản hồi thành công với điểm số về tính dùng một lần

Response schema

Property	Type	Description
`domain`*	`string`	Domain name đã được kiểm tra về khả năng sử dụng một lần
`score`*	`integer`	Disposability risk score từ 0-100, trong đó điểm số cao hơn cho thấy rủi ro cao hơn. Các mức độ rủi ro: 0 = Chắc chắn là hợp lệ (Gmail, Outlook, Yahoo, các nhà cung cấp lớn), 1-30 = Rủi ro thấp (các domain của công ty, không xác định nhưng có vẻ hợp lệ), 31-60 = Rủi ro trung bình (các pattern đáng ngờ, các TLD đáng ngờ), 61-85 = Rủi ro cao (các catch-all domains, pattern matches), 86-100 = Rủi ro rất cao (đã biết là dùng một lần, chắc chắn là tạm thời)

422

Validation Error

Response schema

Property	Type	Description
`detail`	`array[object]`	Detail

GET /v1/moz/ auth

Kiểm tra Moz Metrics - số điểm yêu cầu: 5.00

Truy xuất các metrics Domain Authority (DA) và Page Authority (PA) cho một website nhất định từ Moz. Các metrics này được sử dụng để đo lường authority và tiềm năng xếp hạng của một website hoặc web page.

Parameters

query

Name	Type	Description
`url`*	`string`

Responses

200

DA, PA metrics và một số thông tin khác cho site được cung cấp.

422

Validation Error

Response schema

Property	Type	Description
`detail`	`array[object]`	Detail

GET /v1/check_bin/ auth

Kiểm tra thông tin Card Bin - số điểm yêu cầu: 1.00

Truy xuất thông tin chi tiết về thẻ tín dụng hoặc thẻ ghi nợ dựa trên Bin (Bank Identification Number) của thẻ. Bin là 6 chữ số đầu tiên của số thẻ và cung cấp thông tin chi tiết về loại thẻ, ngân hàng phát hành, danh mục thẻ, v.v.

Parameters

query

Name	Type	Description
`bin`*	`string`	Sáu chữ số đầu tiên của số thẻ.

Responses

200

Trả về thông tin chi tiết về thẻ dựa trên Bin được cung cấp.

Response schema

Property	Type	Description
`type`*	`string`	Loại thẻ (CREDIT/DEBIT)
`country`*	`string`	Quốc gia của tổ chức phát hành thẻ
`brand`*	`string`	Thương hiệu của thẻ (ví dụ: VISA, MASTERCARD)
`level`*	`string`	Cấp độ của thẻ (ví dụ: BUSINESS, CLASSIC)
`bin`*	`integer`	Bank Identification Number (BIN)
`bank`*	`string`	Tên của ngân hàng phát hành thẻ

422

Lỗi xác thực

Response schema

Property	Type	Description
`detail`	`array[object]`	Detail

GET /v1/check_index/ auth

Kiểm tra index trên Google - số điểm yêu cầu: 14.00

API này cho phép bạn kiểm tra xem một URL đã được lập chỉ mục bởi công cụ tìm kiếm của Google hay chưa. Indexing là quá trình Google thu thập dữ liệu và thêm các trang web vào chỉ mục tìm kiếm của mình, giúp chúng có thể truy cập được thông qua kết quả tìm kiếm.

Parameters

query

Name	Type	Description
`url`*	`string`

Responses

200

URL này được Google lập chỉ mục nếu response trả về true

Response schema

Property	Type	Description
`isIndex`*	`boolean`	True nếu trang đã được lập chỉ mục, False nếu chưa
`server`*	`integer`	Phản hồi từ server

422

Lỗi xác thực

Response schema

Property	Type	Description
`detail`	`array[object]`	Detail

GET /v1/check_ahrefs/ auth

Kiểm tra thông tin Ahrefs - số điểm yêu cầu: 2.00

API này cho phép bạn truy xuất thông tin chi tiết về một website dựa trên URL của website đó. The URL là địa chỉ của một website và có thể cung cấp thông tin chi tiết về domain rating, backlinks, organic traffic, và nhiều hơn nữa của website.

Parameters

query

Name	Type	Description
`url`*	`string`	The URL của website cần kiểm tra

Responses

200

Kết quả trả về là thông tin chi tiết khác nhau của website dựa trên 'URL' được cung cấp.

Response schema

Property	Type	Description
`page`*	`object`	PageSchema
`domain`*	`object`	DomainSchema

422

Lỗi xác thực

Response schema

Property	Type	Description
`detail`	`array[object]`	Detail

GET /v1/user_generator/ auth

Trình tạo người dùng - số điểm yêu cầu: 2.00

'Endpoint' này tạo một người dùng dựa trên các tham số truy vấn được cung cấp như độ dài mật khẩu, độ tuổi, giới tính và miền.

Parameters

query

Name	Type	Description
`password_length`	`integer`
`age`	`string`
`gender`	`string`
`domain`	`string`

Responses

200

Một đối tượng JSON chứa thông tin chi tiết của người dùng được tạo bao gồm 'username', 'password', 'age', 'gender' và 'domain'.

Response schema

Property	Type	Description
`name`*	`string`	Name
`gender`*	`string`	Gender
`dob`*	`object`	DateOfBirth
`address_fake`*	`string`	Address Fake
`address_real`*	`object`	Địa chỉ
`phone_number_fake`*	`string`	Phone Number Fake
`phone_number_real`*	`string`	Phone Number Real
`email_for_verification`*	`object`	EmailForVerification
`email`*	`object`	Email
`username`*	`string`	Username
`username_short`*	`string`	Username Short
`password`*	`string`	Password
`payment`*	`object`	Payment

422

Lỗi xác thực

Response schema

Property	Type	Description
`detail`	`array[object]`	Detail

GET /v1/backlink_checker/ auth

Trình kiểm tra Backlink - số điểm yêu cầu: 6.00

Phân tích một trang backlink để kiểm tra xem nó có chứa các liên kết đến trang web mục tiêu hay không, đánh giá trạng thái lập chỉ mục và kiểm tra có điều kiện trạng thái chỉ mục của Google. Việc kiểm tra chỉ mục của Google chỉ được thực hiện nếu trang trả về HTTP 200 và chứa các liên kết mục tiêu.

Parameters

query

Name	Type	Description
`backlink_url`*	`string`	URL của trang chứa backlink tiềm năng (e.g. `https://example.com/article`)
`target_website`*	`string`	Website mục tiêu để kiểm tra backlink (e.g. `https://target.com`)

Responses

200

Phân tích backlink hoàn chỉnh bao gồm metadata, sự hiện diện của liên kết và trạng thái index

422

Lỗi Validation

Response schema

Property	Type	Description
`detail`	`array[object]`	Detail

POST /v1/html_to_markdown auth

Chuyển đổi HTML sang Markdown - điểm yêu cầu: 0.50

Chuyển đổi nội dung HTML sang định dạng Markdown với các biện pháp an toàn cấp độ sản xuất. Được cung cấp bởi thư viện html-to-markdown hiệu suất cao dựa trên Rust.

Tính năng:

Core Rust hiệu suất cao (thông lượng 144-208 MB/s)
Hỗ trợ tất cả các phần tử HTML tiêu chuẩn (headings, lists, tables, links, images, code, etc.)
Định dạng đầu ra Markdown tiêu chuẩn (tiêu đề kiểu ATX với cú pháp #)
Tùy chọn làm sạch HTML nâng cao (custom deep cleaning)
Bộ nhớ đệm tự động cho các chuyển đổi lặp lại nhanh hơn
Bảo vệ khỏi hết thời gian (tối đa 10 giây)

Tùy chọn chuyển đổi:

sanitize: Làm sạch HTML nâng cao (phát hiện nguồn, trích xuất nội dung chính, loại bỏ nhiễu)

Bảo mật & Giới hạn:

Kích thước HTML tối đa: 500KB (512,000 bytes)
Nội dung tối thiểu: 3 ký tự
Chặn nội dung nguy hiểm (scripts, iframes, event handlers)
Thời gian chờ chuyển đổi: 10 giây
Giới hạn tốc độ áp dụng dựa trên gói API của bạn

Định dạng yêu cầu:

{
  "html": "<h1>Your HTML here</h1>",
  "sanitize": false
}

Request Body required

Property	Type	Description
`html`*	`string`	Nội dung HTML để chuyển đổi sang Markdown (tối đa 500KB) Example: `<h1>Hello World</h1><p>This is a <strong>test</strong></p>`
`sanitize`	`boolean`

Responses

200

Chuyển đổi HTML sang Markdown thành công với metadata

Response schema

Property	Type	Description
`success`*	`boolean`	Trạng thái thành công của yêu cầu
`markdown`*	`string`	Nội dung Markdown đã chuyển đổi
`tokens_saved`*	`integer`	Số lượng tokens đã tiết kiệm được khi sử dụng Markdown thay vì HTML (ước tính GPT-4)

422

Lỗi xác thực

Response schema

Property	Type	Description
`detail`	`array[object]`	Detail

GET /v2/validate_phone/ auth

Xác thực số điện thoại - điểm yêu cầu: 0.03

Xác thực số điện thoại và truy xuất metadata chi tiết bao gồm validity, định dạng quốc gia/quốc tế, country, location, timezones, và định dạng E.164. Hoạt động hoàn toàn ngoại tuyến bằng cách sử dụng thư viện Google libphonenumber. Truyền number theo định dạng E.164 (ví dụ: +12025551234) hoặc định dạng local cùng với country (ví dụ: 2025551234 + US).

Parameters

query

Name	Type	Description
`number`*	`string`
`country`	`string`

Responses

200

Kết quả xác thực số điện thoại với 9 trường

Response schema

Property	Type	Description
`is_valid`*	`boolean`	Liệu số điện thoại có hợp lệ hay không
`is_formatted_properly`*	`boolean`	Liệu đầu vào đã ở định dạng E.164 hay chưa
`country`*	`string`	Tên quốc gia đầy đủ (ví dụ Vietnam)
`location`*	`string`	Tỉnh/khu vực liên kết với tiền tố số
`timezones`*	`array[string]`	Danh sách các múi giờ cho khu vực
`format_national`*	`string`	Định dạng hiển thị quốc gia (e.g. 0206 5550 100)
`format_international`*	`string`	Định dạng hiển thị quốc tế (e.g. +84 206 5550 100)
`format_e164`*	`string`	Định dạng chuẩn E.164 (e.g. +842065550100)
`country_code`*	`integer`	Mã quốc gia quay số quốc tế (e.g. 84, 1, 44)

422

Lỗi xác thực

Response schema

Property	Type	Description
`detail`	`array[object]`	Detail

GET /v1/iplookup/ auth

Tra cứu IP - điểm yêu cầu: 0.05

Tra cứu dữ liệu định vị địa lý cho địa chỉ IPv4 hoặc IPv6. Trả về quốc gia, khu vực, thành phố, ZIP, tọa độ, múi giờ và ISP. Hoàn toàn ngoại tuyến — không có lệnh gọi API bên thứ ba, không có phụ thuộc bên ngoài.

Parameters

query

Name	Type	Description
`address`*	`string`	Địa chỉ IPv4 (ví dụ: 8.8.8.8) hoặc IPv6 để tra cứu

Responses

200

Kết quả định vị địa lý IP với 12 trường

Response schema

Property	Type	Description
`is_valid`*	`boolean`	Liệu IP có được tìm thấy trong cơ sở dữ liệu hay không
`country`*	`string`	Tên quốc gia đầy đủ (ví dụ: United States)
`country_code`*	`string`	Mã quốc gia ISO 2 chữ cái (ví dụ: US)
`region`*	`string`	Tên khu vực/tiểu bang (ví dụ: Illinois)
`region_code`*	`string`	Mã vùng/bang (ví dụ: IL)
`city`*	`string`	Tên thành phố (ví dụ: Chicago)
`zip`*	`string`	Mã bưu chính/ZIP (ví dụ: 60620)
`lat`	`number`
`lon`	`number`
`timezone`*	`string`	Múi giờ IANA (ví dụ: America/Chicago)
`isp`*	`string`	Tên ISP hoặc tổ chức
`address`*	`string`	Bản sao của địa chỉ IP đầu vào

422

Lỗi xác thực

Response schema

Property	Type	Description
`detail`	`array[object]`	Detail

GET /v1/lunar_date/ auth

Ngày âm lịch & Giai đoạn mặt trăng - điểm yêu cầu: 0.01

Chuyển đổi ngày dương lịch (Gregorian) sang ngày âm lịch (Trung Quốc) bao gồm Thiên Can & Địa Chi (Can Chi), và thông tin giai đoạn mặt trăng (name, emoji, illumination). Hỗ trợ 3 ngôn ngữ: en, vi, zh. Hoàn toàn ngoại tuyến, không có cuộc gọi API bên ngoài.

Parameters

query

Name	Type	Description
`date`	`string`	Ngày dương lịch theo định dạng YYYY-MM-DD (mặc định: hôm nay dựa trên timezone)
`timezone`	`string`	Múi giờ IANA để xác định 'hôm nay', ví dụ: Asia/Ho_Chi_Minh (mặc định: UTC)
`lang`	`string`	Ngôn ngữ đầu ra: en / vi / zh (mặc định: en)

Responses

200

Chuyển đổi ngày âm lịch với Can Chi và dữ liệu giai đoạn mặt trăng

Response schema

Property	Type	Description
`solar_date`*	`string`	Ngày dương lịch được sử dụng (YYYY-MM-DD)
`lunar_day`*	`integer`	Ngày âm lịch (1-30)
`lunar_month`*	`integer`	Tháng âm lịch (1-12)
`lunar_year`*	`integer`	Năm âm lịch
`is_leap_month`*	`boolean`	Có phải là tháng nhuận hay không
`can_chi_year`*	`string`	Năm Thiên Can & Địa Chi (phụ thuộc ngôn ngữ)
`can_chi_month`*	`string`	Tháng Thiên Can & Địa Chi (phụ thuộc ngôn ngữ)
`can_chi_day`*	`string`	Ngày Thiên Can & Địa Chi (phụ thuộc ngôn ngữ)
`moon_phase_value`*	`number`	Ngày trong chu kỳ mặt trăng 0.0-27.99 (0=trăng non, 14=trăng tròn)
`moon_phase_name`*	`string`	Tên pha mặt trăng (phụ thuộc ngôn ngữ)
`moon_phase_emoji`*	`string`	Biểu tượng cảm xúc pha mặt trăng
`moon_illumination`*	`number`	Tỷ lệ chiếu sáng mặt trăng 0.0-1.0

422

Lỗi xác thực

Response schema

Property	Type	Description
`detail`	`array[object]`	Detail

Disposable Mail

Temporary Email API là dịch vụ API cho phép người dùng tạo và quản lý email tạm thời một cách dễ dàng và tự động.

GET /v1/temp_email/domains

Lấy các miền được phép - số điểm yêu cầu: 1.00

Lấy danh sách các miền được phép cho dịch vụ email tạm thời.

Responses

200

Phản hồi thành công

Response schema

Property	Type	Description
`domains`*	`array[string]`	Domains

GET /v1/temp_email/create

Tạo email tạm thời - số điểm yêu cầu: 1.00

Tạo một địa chỉ email tạm thời với thời gian hết hạn được chỉ định.

Parameters

query

Name	Type	Description
`email`*	`string`	Địa chỉ email sẽ được tạo.
`expiry_minutes`	`integer`	Thời gian hết hạn tính bằng phút (tối đa 20160)

Responses

200

Phản hồi thành công

422

Lỗi xác thực

Response schema

Property	Type	Description
`detail`	`array[object]`	Detail

GET /v1/temp_email/inbox

Lấy hộp thư đến - yêu cầu điểm: 0.05

Truy xuất hộp thư đến cho một địa chỉ email tạm thời được chỉ định. Thao tác này sẽ trả về tất cả các tin nhắn mà email tạm thời đã nhận được.

Parameters

query

Name	Type	Description
`email`*	`string`	Địa chỉ email tạm thời có tin nhắn sẽ được truy xuất.

Responses

200

Phản hồi thành công

Response schema

Property	Type	Description
`messages`*	`array[object]`	Messages

422

Lỗi xác thực

Response schema

Property	Type	Description
`detail`	`array[object]`	Detail

GET /v1/temp_email/message

Lấy tin nhắn - số điểm yêu cầu: 1.00

Truy xuất một tin nhắn cụ thể từ hộp thư đến của một địa chỉ email tạm thời.

Parameters

query

Name	Type	Description
`email`*	`string`	Địa chỉ email tạm thời có tin nhắn sẽ được truy xuất.
`mid`*	`string`	ID của tin nhắn sẽ được truy xuất.

Responses

200

Phản hồi thành công

Response schema

Property	Type	Description
`body`*	`string`	Body

422

Lỗi xác thực

Response schema

Property	Type	Description
`detail`	`array[object]`	Detail

Gmail Inbox

Temporary Gmail API là dịch vụ API cho phép người dùng sử dụng địa chỉ Gmail do hệ thống tạo ra để nhận tin nhắn OTP, đăng ký tài khoản, đăng ký bản tin và nhiều hơn nữa.

GET /v1/temp_gmail/list auth

Liệt kê gmail tạm thời - số điểm yêu cầu: 2.00

Parameters

query

Name	Type	Description
`page`	`integer`	Số trang
`limit`	`integer`	Giới hạn số lượng
`type`	`string`	Loại email (real hoặc alias)
`password`	`string`	Thêm mật khẩu để bảo vệ người khác khỏi việc kiểm tra danh sách tin nhắn của bạn

Responses

200

Phản hồi thành công

Response schema

Property	Type	Description
`data`*	`array[object]`	Danh sách dữ liệu Gmail
`pagination`*	`object`	Pagination

422

Lỗi xác thực

Response schema

Property	Type	Description
`detail`	`array[object]`	Detail

GET /v1/temp_gmail/inbox auth

Gmail tạm thời hộp thư đến - số điểm yêu cầu: 0.05

Parameters

query

Name	Type	Description
`email`*	`string`
`timestamp`*	`integer`	API sẽ truy xuất các tin nhắn sau thời điểm này

Responses

200

Phản hồi thành công

Response schema

Property	Type	Description
`messages`*	`array[object]`	Danh sách các tin nhắn trong hộp thư đến Gmail

422

Lỗi xác thực

Response schema

Property	Type	Description
`detail`	`array[object]`	Detail

GET /v1/temp_gmail/message auth

Tin nhắn gmail tạm thời - số điểm yêu cầu: 1.50

Parameters

query

Name	Type	Description
`email`*	`string`
`mid`*	`string`

Responses

200

Phản hồi thành công

Response schema

Property	Type	Description
`body`*	`string`	Nội dung phần thân của tin nhắn Gmail

422

Lỗi xác thực

Response schema

Property	Type	Description
`detail`	`array[object]`	Detail

GET /v1/temp_gmail/random auth

Lấy gmail tạm thời ngẫu nhiên - số điểm yêu cầu: 0.50

Parameters

query

Name	Type	Description
`type`	`string`	Loại email (real hoặc alias)
`password`	`string`	Thêm mật khẩu để bảo vệ người khác khỏi việc kiểm tra danh sách tin nhắn của bạn

Responses

200

Phản hồi thành công

Response schema

Property	Type	Description
`email`*	`string`	Địa chỉ Random Gmail
`timestamp`*	`integer`	Timestamp khi email được tạo
`type`*	`string`	Type of email ('real' hoặc 'alias') Enum: `real`, `alias`

422

Lỗi xác thực

Response schema

Property	Type	Description
`detail`	`array[object]`	Detail

GET /v1/temp_gmail/remove_message auth

Xóa tin nhắn gmail tạm thời - beta

Parameters

query

Name	Type	Description
`email`*	`string`
`mid`*	`string`

Responses

200

Phản hồi thành công

422

Lỗi xác thực

Response schema

Property	Type	Description
`detail`	`array[object]`	Detail

Outlook Inbox

Temporary Outlook API là dịch vụ API cho phép người dùng sử dụng địa chỉ Outlook do hệ thống tạo ra để nhận tin nhắn OTP, đăng ký tài khoản và nhiều hơn nữa.

GET /v1/temp_outlook/list auth

Liệt kê outlook tạm thời - số điểm yêu cầu: 2.00

Parameters

query

Name	Type	Description
`page`	`integer`
`limit`	`integer`
`type`	`string`

Responses

200

Phản hồi thành công

Response schema

Property	Type	Description
`data`*	`array[object]`	Danh sách các mục Outlook tạm thời
`pagination`*	`object`	Represents pagination information for list responses.

422

Lỗi xác thực

Response schema

Property	Type	Description
`detail`	`array[object]`	Detail

GET /v1/temp_outlook/inbox auth

Hộp thư đến outlook tạm thời - số điểm yêu cầu: 0.05

Parameters

query

Name	Type	Description
`email`*	`string`
`timestamp`*	`integer`

Responses

200

Phản hồi thành công

Response schema

Property	Type	Description
`messages`*	`array[object]`	Danh sách các tin nhắn trong hộp thư đến

422

Lỗi xác thực

Response schema

Property	Type	Description
`detail`	`array[object]`	Detail

GET /v1/temp_outlook/random auth

Lấy random temporary outlook - số điểm yêu cầu: 0.50

Parameters

query

Name	Type	Description
`type`	`string`	Loại email (real or alias)

Responses

200

Phản hồi thành công

Response schema

Property	Type	Description
`email`*	`string`	Địa chỉ email random Outlook
`timestamp`*	`integer`	Dấu thời gian khi email được tạo
`type`*	`string`	Loại email (real or alias) Enum: `real`, `alias`

422

Lỗi xác thực

Response schema

Property	Type	Description
`detail`	`array[object]`	Detail

GET /v1/temp_outlook/message auth

Tin nhắn outlook tạm thời - số điểm yêu cầu: 2.00

Parameters

query

Name	Type	Description
`email`*	`string`
`mid`*	`string`

Responses

200

Phản hồi thành công

Response schema

Property	Type	Description
`body`*	`string`	Nội dung phần thân của tin nhắn

422

Lỗi xác thực

Response schema

Property	Type	Description
`detail`	`array[object]`	Detail

Schemas

Address

Property	Type	Description
`address1`*	`string`	Dòng địa chỉ chính.
`address2`	`string`	Dòng địa chỉ phụ.
`city`	`string`	Thành phố của địa chỉ.
`state`	`string`	Tiểu bang của địa chỉ.
`postalCode`*	`string`	Mã bưu điện của địa chỉ.
`coordinates`*	`object`	Coordinates

AhrefsDataSchema

Property	Type	Description
`page`*	`object`	PageSchema
`domain`*	`object`	DomainSchema

CheckBINOut

Property	Type	Description
`type`*	`string`	Loại thẻ (CREDIT/DEBIT)
`country`*	`string`	Quốc gia của tổ chức phát hành thẻ
`brand`*	`string`	Thương hiệu của thẻ (ví dụ: VISA, MASTERCARD)
`level`*	`string`	Cấp độ của thẻ (ví dụ: BUSINESS, CLASSIC)
`bin`*	`integer`	Bank Identification Number (BIN)
`bank`*	`string`	Tên của ngân hàng phát hành thẻ

CheckIndexOut

Property	Type	Description
`isIndex`*	`boolean`	True nếu trang đã được lập chỉ mục, False nếu chưa
`server`*	`integer`	Phản hồi từ server

Coordinates

Property	Type	Description
`lat`*	`number`	Vĩ độ của địa chỉ.
`lng`*	`number`	Kinh độ của địa chỉ.

DateOfBirth

Property	Type	Description
`day`*	`integer`	Ngày sinh.
`month`*	`integer`	Tháng sinh.
`year`*	`integer`	Năm sinh.

DisposableEmailResponse

Trả về risk score từ 0-100 cho biết khả năng domain được sử dụng cho các dịch vụ email dùng một lần/tạm thời.

Property	Type	Description
`domain`*	`string`	Domain name đã được kiểm tra về khả năng sử dụng một lần
`score`*	`integer`	Disposability risk score từ 0-100, trong đó điểm số cao hơn cho thấy rủi ro cao hơn. Các mức độ rủi ro: 0 = Chắc chắn là hợp lệ (Gmail, Outlook, Yahoo, các nhà cung cấp lớn), 1-30 = Rủi ro thấp (các domain của công ty, không xác định nhưng có vẻ hợp lệ), 31-60 = Rủi ro trung bình (các pattern đáng ngờ, các TLD đáng ngờ), 61-85 = Rủi ro cao (các catch-all domains, pattern matches), 86-100 = Rủi ro rất cao (đã biết là dùng một lần, chắc chắn là tạm thời)

DomainSchema

Property	Type	Description
`backlinks`*	`integer`	Số lượng backlink đến domain
`refdomains`*	`integer`	Số lượng referring domain đến domain
`traffic`*	`number`	Traffic ước tính đến domain
`value`*	`integer`	Giá trị tiền tệ của domain
`keywords`*	`integer`	Số lượng keyword mà domain xếp hạng
`domain_rating`*	`number`	Domain rating
`ahrefs_rank`*	`integer`	Ahrefs rank của domain

DomainsOut

Schema đại diện cho một danh sách các domain.

Property	Type	Description
`domains`*	`array[string]`	Domains

Email

Property	Type	Description
`gmail`*	`string`	Địa chỉ Gmail.
`outlook`*	`string`	Địa chỉ Outlook.

EmailForVerification

Property	Type	Description
`email`*	`string`	Địa chỉ email để xác minh.
`gmail`*	`string`	Địa chỉ Gmail để xác minh.
`outlook`*	`string`	Địa chỉ Outlook để xác minh.

GmailCheckResponse

Property	Type	Description
`email`*	`string`	Địa chỉ Gmail đã được kiểm tra
`status`*	`string`	Trạng thái tài khoản Gmail Enum: `Ok`, `Verify`, `Disable`, `NotExist`, `Disable\|NotExist`, `Error`
`avatar`	`string`

GmailData

Property	Type	Description
`email`*	`string`	Địa chỉ email của người dùng Gmail
`timestamp`*	`integer`	Dấu thời gian của dữ liệu Gmail

HTTPValidationError

Property	Type	Description
`detail`	`array[object]`	Detail

HtmlToMarkdownRequest

Property	Type	Description
`html`*	`string`	Nội dung HTML để chuyển đổi sang Markdown (tối đa 500KB) Example: `<h1>Hello World</h1><p>This is a <strong>test</strong></p>`
`sanitize`	`boolean`

HtmlToMarkdownResponse

Property	Type	Description
`success`*	`boolean`	Trạng thái thành công của yêu cầu
`markdown`*	`string`	Nội dung Markdown đã chuyển đổi
`tokens_saved`*	`integer`	Số lượng tokens đã tiết kiệm được khi sử dụng Markdown thay vì HTML (ước tính GPT-4)

IPLookupResponse

Property	Type	Description
`is_valid`*	`boolean`	Liệu IP có được tìm thấy trong cơ sở dữ liệu hay không
`country`*	`string`	Tên quốc gia đầy đủ (ví dụ: United States)
`country_code`*	`string`	Mã quốc gia ISO 2 chữ cái (ví dụ: US)
`region`*	`string`	Tên khu vực/tiểu bang (ví dụ: Illinois)
`region_code`*	`string`	Mã vùng/bang (ví dụ: IL)
`city`*	`string`	Tên thành phố (ví dụ: Chicago)
`zip`*	`string`	Mã bưu chính/ZIP (ví dụ: 60620)
`lat`	`number`
`lon`	`number`
`timezone`*	`string`	Múi giờ IANA (ví dụ: America/Chicago)
`isp`*	`string`	Tên ISP hoặc tổ chức
`address`*	`string`	Bản sao của địa chỉ IP đầu vào

InboxGmailItem

Property	Type	Description
`mid`*	`string`	ID của tin nhắn
`textTo`*	`string`	Địa chỉ email của người nhận
`textFrom`*	`string`	Địa chỉ email của người gửi
`textSubject`*	`string`	Chủ đề của email
`textDate`*	`string`	Ngày email được gửi

InboxGmailOut

Property	Type	Description
`messages`*	`array[object]`	Danh sách các tin nhắn trong hộp thư đến Gmail

InboxItem

Lược đồ đại diện cho một mục trong hộp thư đến.

Property	Type	Description
`mid`*	`string`	Mid
`textTo`*	`string`	Textto
`textFrom`*	`string`	Textfrom
`textSubject`*	`string`	Textsubject
`textDate`*	`string`	Textdate

InboxMessage

Đại diện cho một tin nhắn trong hộp thư đến.

Property	Type	Description
`mid`*	`string`	Định danh duy nhất cho tin nhắn
`textDate`*	`string`	Ngày và giờ của tin nhắn
`textTo`*	`string`	Người nhận tin nhắn
`textFrom`*	`string`	Người gửi tin nhắn
`textSubject`*	`string`	Chủ đề của tin nhắn

InboxOut

Lược đồ đại diện cho đầu ra của hộp thư đến, chứa nhiều tin nhắn.

Property	Type	Description
`messages`*	`array[object]`	Messages

InboxResponse

Mô hình phản hồi cho các tin nhắn trong hộp thư đến.

Property	Type	Description
`messages`*	`array[object]`	Danh sách các tin nhắn trong hộp thư đến

ListGmailOut

Property	Type	Description
`data`*	`array[object]`	Danh sách dữ liệu Gmail
`pagination`*	`object`	Pagination

ListTempOutlookResponse

Mô hình phản hồi cho việc liệt kê các mục Outlook tạm thời.

Property	Type	Description
`data`*	`array[object]`	Danh sách các mục Outlook tạm thời
`pagination`*	`object`	Represents pagination information for list responses.

LunarDateResponse

Property	Type	Description
`solar_date`*	`string`	Ngày dương lịch được sử dụng (YYYY-MM-DD)
`lunar_day`*	`integer`	Ngày âm lịch (1-30)
`lunar_month`*	`integer`	Tháng âm lịch (1-12)
`lunar_year`*	`integer`	Năm âm lịch
`is_leap_month`*	`boolean`	Có phải là tháng nhuận hay không
`can_chi_year`*	`string`	Năm Thiên Can & Địa Chi (phụ thuộc ngôn ngữ)
`can_chi_month`*	`string`	Tháng Thiên Can & Địa Chi (phụ thuộc ngôn ngữ)
`can_chi_day`*	`string`	Ngày Thiên Can & Địa Chi (phụ thuộc ngôn ngữ)
`moon_phase_value`*	`number`	Ngày trong chu kỳ mặt trăng 0.0-27.99 (0=trăng non, 14=trăng tròn)
`moon_phase_name`*	`string`	Tên pha mặt trăng (phụ thuộc ngôn ngữ)
`moon_phase_emoji`*	`string`	Biểu tượng cảm xúc pha mặt trăng
`moon_illumination`*	`number`	Tỷ lệ chiếu sáng mặt trăng 0.0-1.0

MessageGmailOut

Property	Type	Description
`body`*	`string`	Nội dung phần thân của tin nhắn Gmail

MessageOut

Lược đồ đại diện cho đầu ra của một tin nhắn.

Property	Type	Description
`body`*	`string`	Body

MessageResponse

Mô hình phản hồi cho nội dung một tin nhắn.

Property	Type	Description
`body`*	`string`	Nội dung phần thân của tin nhắn

MicrosoftCheckResponse

Property	Type	Description
`email`*	`string`	Địa chỉ email Microsoft đã kiểm tra
`status`*	`string`	Trạng thái tài khoản Microsoft Enum: `Ok`, `Verify(sms\|2fa)`, `NotExist`, `Error`
`details`	`object`

PageSchema

Property	Type	Description
`backlinks`*	`integer`	Số lượng liên kết ngược đến trang
`refdomains`*	`integer`	Số lượng referring domains đến trang
`traffic`*	`number`	Ước tính traffic đến trang
`value`*	`integer`	Giá trị tiền tệ của trang
`keywords`*	`integer`	Số lượng keywords mà trang xếp hạng
`url_rating`*	`integer`	URL rating của trang
`nr_words`*	`integer`	Số lượng words trên trang

Payment

Property	Type	Description
`bin`	`integer`	Bank Identification Number (BIN).

PhoneValidateResponse

Property	Type	Description
`is_valid`*	`boolean`	Liệu số điện thoại có hợp lệ hay không
`is_formatted_properly`*	`boolean`	Liệu đầu vào đã ở định dạng E.164 hay chưa
`country`*	`string`	Tên quốc gia đầy đủ (ví dụ Vietnam)
`location`*	`string`	Tỉnh/khu vực liên kết với tiền tố số
`timezones`*	`array[string]`	Danh sách các múi giờ cho khu vực
`format_national`*	`string`	Định dạng hiển thị quốc gia (e.g. 0206 5550 100)
`format_international`*	`string`	Định dạng hiển thị quốc tế (e.g. +84 206 5550 100)
`format_e164`*	`string`	Định dạng chuẩn E.164 (e.g. +842065550100)
`country_code`*	`integer`	Mã quốc gia quay số quốc tế (e.g. 84, 1, 44)

RandomGmailOut

Property	Type	Description
`email`*	`string`	Địa chỉ Random Gmail
`timestamp`*	`integer`	Timestamp khi email được tạo
`type`*	`string`	Type of email ('real' hoặc 'alias') Enum: `real`, `alias`

RandomOutlookResponse

Mô hình phản hồi cho một random temporary Outlook email.

Property	Type	Description
`email`*	`string`	Địa chỉ email random Outlook
`timestamp`*	`integer`	Dấu thời gian khi email được tạo
`type`*	`string`	Loại email (real or alias) Enum: `real`, `alias`

TempOutlookItem

Đại diện cho một item tạm thời trong hộp thư đến Outlook.

Property	Type	Description
`emails`*	`array[string]`	List of temporary email addresses
`timestamp`*	`integer`	Unix timestamp của thời điểm item được tạo

UserGeneratorResponse

Property	Type	Description
`name`*	`string`	Name
`gender`*	`string`	Gender
`dob`*	`object`	DateOfBirth
`address_fake`*	`string`	Address Fake
`address_real`*	`object`	Địa chỉ
`phone_number_fake`*	`string`	Phone Number Fake
`phone_number_real`*	`string`	Phone Number Real
`email_for_verification`*	`object`	EmailForVerification
`email`*	`object`	Email
`username`*	`string`	Username
`username_short`*	`string`	Username Short
`password`*	`string`	Password
`payment`*	`object`	Payment

ValidationError

Property	Type	Description
`loc`*	`array[object]`	Location
`msg`*	`string`	Message
`type`*	`string`	Error Type

YcheckerOut

Property	Type	Description
`type`*	`string`	Type of email provider
`disposable`*	`string`	Is the email disposable?
`status`*	`string`	Status of the email
`avatar`	`string`	Avatar URL only for Gmail

Pagination

Property	Type	Description
`page`*	`integer`	The current page number
`limit`*	`integer`	The number of items per page
`total_count`*	`integer`	The total number of items
`total_pages`*	`integer`	The total number of pages

Pagination

Represents pagination information for list responses.

Property	Type	Description
`page`*	`integer`	Số trang hiện tại
`limit`*	`integer`	Số lượng mục trên mỗi trang
`total_count`*	`integer`	Tổng số mục
`total_pages`*	`integer`	Tổng số trang