CheckNumber API - Servicio de verificación de números de teléfono

Bienvenido a CheckNumber API, un servicio de verificación y validación de números de teléfono para desarrolladores y empresas de todo el mundo.

Introducción a la API

CheckNumber ofrece API avanzadas de verificación de números de teléfono que permiten validar y comprobar números de forma masiva en más de 20 plataformas. Ya sea para verificar registros de WhatsApp, detectar cuentas de redes sociales, comprobar usuarios de exchanges de criptomonedas o consultar información del operador, CheckNumber lo cubre.

Casos de uso habituales:

Limpieza de listas de marketing: elimine números inactivos antes de enviar campañas.
Prevención de fraude: verifique los números que proporcionan los usuarios durante el registro.
Enriquecimiento de CRM: identifique qué plataformas usan sus contactos.
KYC de exchanges de criptomonedas: contraste números de usuario con registros de exchanges.

Inicio rápido

1. Obtenga su clave de API

Regístrese en checknumber.ai y obtenga su clave de API desde el panel de control.

2. Envíe una tarea por lotes

Cargue un archivo .txt o .csv con un número de teléfono por línea (formato E.164, por ejemplo, +8613800138000):

curl --location 'https://api.checknumber.ai/v1/tasks' \
--header 'X-API-Key: YOUR_API_KEY' \
--form 'file=@"./numbers.txt"' \
--form 'task_type="ws"'

3. Consulte los resultados

curl --location 'https://api.checknumber.ai/v1/gettasks' \
--header 'X-API-Key: YOUR_API_KEY' \
--form 'task_id="TASK_ID_FROM_STEP_2"'

Cuando status cambie a exported, descargue el archivo de resultados desde result_url.

Resumen de la API

Elemento	Detalles
URL base	`https://api.checknumber.ai`
Autenticación	Cabecera `X-API-Key`
Enviar tarea	`POST /v1/tasks` (multipart/form-data)
Consultar estado	`POST /v1/gettasks` (form-data)
Consultar saldo	`GET /v1/balance`
Formato de archivo	`.txt` o `.csv`, una entrada por línea
Tamaño máximo del lote	1 000 000 entradas por tarea

Autenticación

Todas las solicitudes requieren la clave de API en la cabecera de la solicitud:

X-API-Key: YOUR_API_KEY

Estado de la tarea

Estado	Significado
`pending`	Tarea en cola, a la espera de comenzar
`processing`	La tarea se está procesando
`exported`	Resultados listos; descárguelos desde `result_url`

Referencia de la API

El orden y la agrupación de productos siguen la navegación: plataformas y correo, exchanges de criptomonedas, detección de números y correo y, por último, detección de operador.

Plataformas y correo

Las tareas de número de teléfono y correo se muestran en la misma secuencia que en el sitio comercial (Telegram → WhatsApp → … → correo de Netflix / Spotify).

API	task_type	Descripción
Telegram Checker	`tg`	Telegram account registration check
Telegram Activity Checker	`tg_active`	Telegram last online days
Telegram Age & Gender Checker	`tg_avatar`	Telegram avatar, age, gender analysis

API	task_type	Descripción
Comprobador de WhatsApp	`ws`	Comprobación masiva de registro de WhatsApp
Comprobador de actividad de WhatsApp	`ws_active`	Días desde la última conexión y estado empresarial
Comprobador de edad y género de WhatsApp	`ws_avatar`	Análisis de avatar, edad, género y tono de piel
Validación de números de teléfono	`phoneCheck`	Comprobaciones masivas de formato, validez y numeración

Más plataformas y correo

API	task_type	Descripción
Comprobador de Facebook	`facebook`	Verificación de cuenta de Facebook
Comprobador de correo de Facebook	`facebook_email`	Comprobación de cuenta de Facebook por correo
Comprobador de Apple	`apple`	Comprobación de cuenta de Apple por número
Comprobador de correo de Apple	`apple_email`	Comprobación de cuenta de Apple por correo
Comprobador de iMessage	`imessage`	Comprobación de activación de iMessage (Apple)
Comprobador de RCS	`rcs`	Comprobación de compatibilidad con RCS
Comprobador de Instagram	`instagram`	Verificación de cuenta de Instagram
Comprobador de correo de Instagram	`instagram_email`	Comprobación de cuenta de Instagram por correo
Comprobador de Amazon	`amazon`	Comprobación de cuenta de Amazon por número
Comprobador de correo de Amazon	`amazon_email`	Comprobación de cuenta de Amazon por correo
Comprobador de Twitter	`twitter`	Verificación de cuenta de Twitter
Comprobador de Line	`line`	Comprobación de registro de cuenta de Line
Comprobador de Microsoft	`microsoft`	Comprobación de cuenta de Microsoft por número
Comprobador de Band	`band`	Comprobación de registro de cuenta de Band
Comprobador de MAX	`max`	Comprobación de registro en MAX Messenger
Comprobador de perfil completo de MAX	`max_full`	Perfil completo de MAX Messenger (nombre, género, última conexión y avatar)
Comprobador de Viber	`viber`	Comprobación de registro de cuenta de Viber
Comprobador de actividad de Viber	`viber_active`	Días desde la última conexión en Viber
Comprobador de Airbnb	`airbnb`	Comprobación de cuenta de Airbnb por número
Comprobador de correo de Twitter/X	`twitter_email`	Comprobación de cuenta de Twitter/X por correo
Comprobador de GoTo	`goto`	Comprobación de cuenta de GoTo
Comprobador de Threads	`threads`	Comprobación de cuenta de Threads
Comprobador de Signal	`signal`	Comprobación de cuenta de Signal
Comprobador de Snapchat	`snapchat`	Comprobación de cuenta de Snapchat
Comprobador de Messenger	`messenger`	Comprobación de cuenta de Messenger
Comprobador de correo de Netflix	`netflix_email`	Comprobación de cuenta de Netflix por correo
Comprobador de Zalo	`zalo`	Comprobación de registro de cuenta de Zalo
Comprobador de correo de Netflix	`netflix`	Comprobación de cuenta de Netflix por correo
Comprobador de correo de Spotify	`spotify_email`	Comprobación de cuenta de Spotify por correo

Detección de exchanges de criptomonedas

Primero se muestran las comprobaciones de teléfono de exchanges y después las comprobaciones de correo correspondientes.

API	task_type	Descripción
Comprobador de Binance	`Binance`	Comprobación de cuenta registrada en Binance
Comprobador de correo de Binance	`binance_email`	Comprobación de cuenta de Binance por correo
Comprobador de KuCoin	`Kucoin`	Comprobación de cuenta registrada en KuCoin
Comprobador de CoinW	`coinW`	Comprobación de cuenta registrada en CoinW
Comprobador de HTX	`htx`	Comprobación de cuenta registrada en HTX (Huobi)
Comprobador de correo de KuCoin	`kucoin_email`	Comprobación de cuenta de KuCoin por correo
Comprobador de correo de CoinW	`coinw_email`	Comprobación de cuenta de CoinW por correo
Comprobador de correo de HTX	`htx_email`	Comprobación de cuenta de HTX por correo
Comprobador de correo de Crypto.com	`crypto_email`	Comprobación de cuenta de Crypto.com por correo

Detección de números y correo

API	task_type	Descripción
Comprobación de actividad de número	`active_check`	Detección del nivel de actividad de un número
Comprobador de usuarios de alto valor	`high_value_users`	Detección de señales de usuarios de alto valor
Comprobación de correo	`email_check`	Validación masiva de direcciones de correo

Detección de operador

Identifique operadores telefónicos e información regional.

API	task_type	Descripción
Detección de operador	—	Consulta de operador, región y tipo de número

Gestión de cuenta

Gestione su cuenta de CheckNumber y supervise el uso.

API	Método	Descripción
API de consulta de saldo	`GET /v1/balance`	Consulte el saldo disponible de la cuenta

Catálogo de productos

Product	Task type	Return fields
CheckNumber	`tg`	`number`, `activated`
Activity Checker	`tg_active`	`number`, `activated`, `uid`, `username`, `lastseen`, `activedays`, `member`
Profile Checker	`tg_avatar`	`Phone`, `activated`, `uid`, `username`, `Gender`, `Age`, `Ethnicity`, `Avatar`, `Last Online Time`, `Active Days`, `Is Member`, `first_name`, `last_name`

Product	Task type	Return fields
CheckNumber	`ws`	`number`, `activated`
Activity Checker	`ws_active`	`number`, `activated`, `activetime`, `activedays`, `business`
Profile Checker	`ws_avatar`	`number`, `activated`, `age`, `avatar`, `category`, `gender`, `hair_color`, `number`, `skin_color`

CheckNumber

Product	Task type	Return fields
Validity Checker	`phoneCheck`	`number`, `activated`
Activity Checker	`active_check`	`number`, `activated`
High-Value Checker	`high_value_users`	`Mobile Number`, `Result`

Viber

Product	Task type	Return fields
CheckNumber	`viber`	`number`, `activated`
Activity Checker	`viber_active`	`number`, `activated`, `mid`, `last_online_time`, `active_days`
Profile Checker	`viber_senior`	`number`, `activated`, `last_online_time`, `active_days`, `mid`, `nickname`, `person_count`, `avatar_type`, `age`, `skin_color`, `gender`, `avatar`

iMessage

Product	Task type	Return fields
CheckNumber	`imessage`	`number`, `activated`

RCS

Product	Task type	Return fields
CheckNumber	`rcs`	`number`, `activated`, `system`

Signal

Product	Task type	Return fields
CheckNumber	`signal`	`number`, `activated`

VK

Product	Task type	Return fields
CheckNumber	`vk`	`number`, `activated`

Apple ID

Product	Task type	Return fields
CheckNumber	`apple`	`number`, `activated`
Email Checker	`apple_email`	`email`, `activated`

Facebook

Product	Task type	Return fields
CheckNumber	`facebook`	`number`, `activated`
Email Checker	`facebook_email`	`email`, `activated`

Amazon

Product	Task type	Return fields
CheckNumber	`amazon`	`number`, `activated`
Email Checker	`amazon_email`	`email`, `activated`

Instagram

Product	Task type	Return fields
CheckNumber	`instagram`	`number`, `activated`
Email Checker	`instagram_email`	`email`, `activated`

MAX

Product	Task type	Return fields
CheckNumber	`max`	`number`, `activated`
Profile Checker	`max_full`	`number`, `activated`

Netflix

Product	Task type	Return fields
CheckNumber	`netflix`	`number`, `activated`
Email Checker	`netflix_email`	`email`, `activated`

Line

Product	Task type	Return fields
CheckNumber	`line`	`number`, `activated`
Profile Checker	`line_senior`	`number`, `activated`

X (Twitter)

Product	Task type	Return fields
CheckNumber	`twitter`	`number`, `activated`
Email Checker	`twitter_email`	`email`, `activated`

Telegram (username)

Product	Task type	Return fields
Registration Checker	`tg_username`	`username`, `activated`, `avatar_url`
Activity Checker	`tg_username_activity`	`username`, `activated`, `uid`, `lastseen`, `activedays`, `member`, `avatar_url`
Profile Checker	`tg_username_profile`	`username`, `activated`, `avatar_url`, `uid`, `lastseen`, `activedays`, `member`, `category`, `gender`, `hair_color`, `skin_color`, `age`

Product	Task type	Return fields
CheckNumber	`linkedin_phone`	`number`, `activated`
Email Checker	`linkedin`	`email`, `activated`
Email Profile Checker	`linkedin_profile`	`email`, `activated`, `country`, `gender`, `industry`, `job_title`, `inferred_salary`

Zalo

Product	Task type	Return fields
CheckNumber	`zalo`	`number`, `activated`

TikTok

Product	Task type	Return fields
CheckNumber	`tiktok`	`number`, `activated`, `username`, `uid`

Microsoft

Product	Task type	Return fields
CheckNumber	`microsoft`	`number`, `activated`

Snapchat

Product	Task type	Return fields
CheckNumber	`snapchat`	`number`, `activated`

Messenger

Product	Task type	Return fields
CheckNumber	`messenger`	`number`, `activated`

GoTo

Product	Task type	Return fields
CheckNumber	`goto`	`number`, `activated`

Threads

Product	Task type	Return fields
CheckNumber	`threads`	`number`, `activated`

Spotify

Product	Task type	Return fields
Email Checker	`spotify_email`	`email`, `activated`

Band

Product	Task type	Return fields
CheckNumber	`band`	`number`, `activated`

DHL

Product	Task type	Return fields
CheckNumber	`dhl`	`number`, `activated`

Sideline

Product	Task type	Return fields
CheckNumber	`sideline`	`Number`, `activated`

Airbnb

Product	Task type	Return fields
CheckNumber	`airbnb`	`number`, `activated`

Pornhub

Product	Task type	Return fields
Email Checker	`pornhub`	`email`, `activated`

Temu

Product	Task type	Return fields
CheckNumber	`temu`	`number`, `activated`

Botim

Product	Task type	Return fields
CheckNumber	`botim`	`number`, `activated`
Age & Gender Checker	`botim_gender`	`number`, `activated`, `gender`, `age`

Exchange Registration Checkers

Binance

Product	Task type	Return fields
CheckNumber	`Binance`	`number`, `activated`
Email Checker	`binance_email`	`email`, `activated`

KuCoin

Product	Task type	Return fields
CheckNumber	`Kucoin`	`number`, `activated`
Email Checker	`kucoin_email`	`email`, `activated`

Htx

Product	Task type	Return fields
CheckNumber	`htx`	`number`, `activated`
Email Checker	`htx_email`	`email`, `activated`

CoinW

Product	Task type	Return fields
CheckNumber	`coinW`	`number`, `activated`
Email Checker	`coinw_email`	`email`, `activated`

Crypto.com

Product	Task type	Return fields
Email Checker	`crypto_email`	`email`, `activated`

OKX

Product	Task type	Return fields
CheckNumber	`okx`	`number`, `activated`

Email And Global Carrier Checkers

Email Validation

Product	Task type	Return fields
Upload Task	`email_check`	`email`, `activated`

Global Carrier Checker

Product	Task type	Return fields
Global Carrier Checker	`usaCarrier`	`number`, `number_type`, `country_code`, `carrier`, `underlying_carrier`, `region`, `city`

Advanced US Carrier Checker

Product	Task type	Return fields
Advanced US Carrier Checker	`us_carrier_premium`	`Number`, `number_type`, `carrier`, `city`

Utilidades compartidas

API	Description
Global Phone Carrier Inquiry	Legacy synchronous single-number carrier lookup; not part of the 74-product catalog.
Balance Query API	Query available account balance.