CheckNumber API - Serviço de verificação de números de telefone

Bem-vindo a CheckNumber API, uma plataforma de verificação e validação de números de telefone para desenvolvedores e empresas do mundo todo.

Introdução à API

A CheckNumber oferece APIs avançadas de verificação de números de telefone para validar números em mais de 20 plataformas, em grande escala. Use a API para consultar cadastros no WhatsApp, identificar contas em redes sociais, verificar usuarios de corretoras de criptomoedas ou obter dados de operadoras.

Casos de uso comuns:

Higienização de listas de marketing: remova números inativos antes de enviar campanhas.
Prevenção a fraudes: valide números informados por usuarios durante o cadastro.
Enriquecimento de CRM: identifique as plataformas usadas pelos seus contatos.
KYC para corretoras de criptomoedas: compare números de telefone com registros de corretoras.

Início rápido

1. Obtenha sua chave de API

Cadastre-se em checknumber.ai e copie sua chave de API no painel.

2. Envie uma tarefa em lote

Envie um arquivo .txt ou .csv com um número de telefone por linha, no formato E.164, por exemplo +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 os resultados

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

Quando o status for exported, baixe o arquivo de resultados em result_url.

Visao geral da API

Item	Detalhes
URL base	`https://api.checknumber.ai`
Autenticação	Cabeçalho `X-API-Key`
Enviar tarefa	`POST /v1/tasks` (multipart/form-data)
Consultar status	`POST /v1/gettasks` (form-data)
Consultar saldo	`GET /v1/balance`
Formato de arquivo	`.txt` ou `.csv`, uma entrada por linha
Tamanho máximo do lote	1.000.000 de entradas por tarefa

Autenticação

Todas as requisições exigem uma chave de API no cabeçalho:

X-API-Key: YOUR_API_KEY

Status da tarefa

Status	Significado
`pending`	Tarefa na fila, aguardando início
`processing`	Tarefa em processamento
`exported`	Resultados prontos para download em `result_url`

Referencia da API

Os produtos estão organizados nas categorias plataformas e e-mail, corretoras de criptomoedas, detecção de número e e-mail e filtro de operadora.

Plataformas e e-mail

As tarefas de número de telefone e de e-mail aparecem na mesma sequencia do site.

API	task_type	Descrição
Verificador do Telegram	`tg`	Verifica se ha uma conta do Telegram associada ao número
Verificador de atividade do Telegram	`tg_active`	Informa os últimos dias de atividade no Telegram
Verificador de idade e gênero do Telegram	`tg_avatar`	Analisa avatar, idade e gênero do perfil do Telegram

API	task_type	Descrição
Verificador do WhatsApp	`ws`	Verifica em massa se os números estao cadastrados no WhatsApp
Verificador de WhatsApp Business	`ws_business`	Detecta contas do WhatsApp Business
Verificador de atividade do WhatsApp	`ws_active`	Informa os últimos dias online e o status comercial
Verificador de idade e gênero do WhatsApp	`ws_avatar`	Analisa avatar, idade, gênero e tom de pele
Validação de número de telefone	`phoneCheck`	Verifica formato, validade e plano de numeracao em massa

Outras plataformas e e-mail

API	task_type	Descrição
Verificador do Facebook	`facebook`	Verifica contas do Facebook por número de telefone
Verificador de e-mail do Facebook	`facebook_email`	Verifica contas do Facebook por e-mail
Verificador da Apple	`apple`	Verifica contas da Apple por número de telefone
Verificador de e-mail da Apple	`apple_email`	Verifica contas da Apple por e-mail
Verificador do iMessage	`imessage`	Verifica a ativacao do iMessage
Verificador de RCS	`rcs`	Verifica suporte a RCS (Rich Communication Services)
Verificador do Instagram	`instagram`	Verifica contas do Instagram por número de telefone
Verificador de e-mail do Instagram	`instagram_email`	Verifica contas do Instagram por e-mail
Verificador da Amazon	`amazon`	Verifica contas da Amazon por número de telefone
Verificador de e-mail da Amazon	`amazon_email`	Verifica contas da Amazon por e-mail
Verificador do Airbnb	`airbnb`	Verifica contas do Airbnb por número de telefone
Verificador de e-mail do Twitter/X	`twitter_email`	Verifica contas do Twitter/X por e-mail
Verificador do LINE	`line`	Verifica contas cadastradas no LINE
Verificador da Microsoft	`microsoft`	Verifica contas da Microsoft por número de telefone
Verificador do Band	`band`	Verifica contas cadastradas no Band
Verificador do GoTo	`goto`	Verifica contas cadastradas no GoTo
Verificador do Threads	`threads`	Verifica contas cadastradas no Threads
Verificador do Signal	`signal`	Verifica contas cadastradas no Signal
Verificador do Snapchat	`snapchat`	Verifica contas cadastradas no Snapchat
Verificador do Messenger	`messenger`	Verifica contas cadastradas no Messenger
Verificador do MAX	`max`	Verifica contas cadastradas no mensageiro MAX
Verificador de perfil completo do MAX	`max_full`	Retorna nome, gênero, último acesso e avatar do perfil MAX
Verificador do Viber	`viber`	Verifica contas cadastradas no Viber
Verificador de atividade do Viber	`viber_active`	Informa os últimos dias online no Viber
Verificador do Zalo	`zalo`	Verifica contas cadastradas no Zalo
Verificador da Netflix	`netflix`	Verifica contas da Netflix por número de telefone
Verificador de e-mail da Netflix	`netflix_email`	Verifica contas da Netflix por e-mail
Verificador de e-mail do Spotify	`spotify_email`	Verifica contas do Spotify por e-mail

Detecção em corretoras de criptomoedas

Primeiro, verifique telefones das corretoras; em seguida, verifique os e-mails de cada corretora.

API	task_type	Descrição
Verificador da Binance	`Binance`	Verifica contas cadastradas na Binance
Verificador de e-mail da Binance	`binance_email`	Verifica contas da Binance por e-mail
Verificador da KuCoin	`Kucoin`	Verifica contas cadastradas na KuCoin
Verificador de e-mail da KuCoin	`kucoin_email`	Verifica contas da KuCoin por e-mail
Verificador da CoinW	`coinW`	Verifica contas cadastradas na CoinW
Verificador de e-mail da CoinW	`coinw_email`	Verifica contas da CoinW por e-mail
Verificador da HTX	`htx`	Verifica contas cadastradas na HTX (Huobi)
Verificador de e-mail da HTX	`htx_email`	Verifica contas da HTX por e-mail
Verificador da Crypto.com	`crypto`	Verifica contas cadastradas na Crypto.com
Verificador de e-mail da Crypto.com	`crypto_email`	Verifica contas da Crypto.com por e-mail

Detecção de números e e-mail

Verifique a atividade de números de telefone, sinais de usuarios de alto valor e a validade de enderecos de e-mail.

API	task_type	Descrição
Verificação de número ativo	`active_check`	Detecta o nivel de atividade de um número de telefone
Verificador de usuarios de alto valor	`high_value_users`	Detecta sinais de usuarios de alto valor por número de telefone
Verificador de atividade e-commerce	`ecom_active`	Detecta atividade recente em e-commerce por número
Verificador de entregabilidade de email	`email_check` / `email_avatar`	Verifica se os endereços de email estão ativos e podem receber mensagens. Suporta apenas Gmail, Yandex, Mail.ru, iCloud, Outlook e Yahoo. Verifica se os endereços de email têm um avatar público e retorna a URL. Suporta apenas Gmail, Yandex e Mail.ru.

Detecção de operadora

Identifique a operadora, a região e o tipo de um número de telefone.

API	task_type	Descrição
Detecção de operadora	—	Consulta operadora, região e tipo do número de telefone

Gerenciamento da conta

Gerencie sua conta CheckNumber e acompanhe o uso.

API	Método	Descrição
API de consulta de saldo	`GET /v1/balance`	Consulta o saldo disponível da conta

Catálogo de produtos

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`
Business Checker	`ws_business`	`number`, `whatsapp`, `business`
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`
E-commerce Checker	`ecom_active`	`number`, `activated`

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
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`

Product	Task type	Return fields
CheckNumber	`linkedin_phone`	`number`, `activated`
Email Checker	`linkedin`	`email`, `activated`
Email Profile Checker	`linkedin_profile`	`email`, `activated`, `first_name`, `last_name`, `gender`, `job_title`, `birth_year`, `inferred_salary`, `linkedin_url`, `phone`
Username Profile Checker	`linkedin_username`	`username`, `activated`, `phone`, `email`, `avatar`, `avatar_url`, `name`, `location`, `country`, `company`, `followers`, `about`, `languages`, `current_title`, `education`, `experience`

Zalo

Product	Task type	Return fields
CheckNumber	`zalo`	`number`, `activated`
Days Checker	`zalo_active`	`number`, `activated`, `uid`, `nickname`, `active_time`, `active_days`
Age & Gender Checker	`zalo_gender`	`number`, `activated`, `uid`, `nickname`, `gender`, `age`, `skin_color`, `avatar_type`, `person_count`, `avatar`

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`

Wheely

Product	Task type	Return fields
Registration Checker	`wheely`	`number`, `activated`

BongaCams

Product	Task type	Return fields
Registration Checker	`bongacams`	`email`, `activated`

RusDate

Product	Task type	Return fields
Registration Checker	`rusdate_email`	`email`, `activated`

Rabota.ru

Product	Task type	Return fields
Registration Checker	`rabota_phone`	`number`, `activated`

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
CheckNumber	`crypto`	`number`, `activated`
Email Checker	`crypto_email`	`email`, `activated`

OKX

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

Email And Global Carrier Checkers

Verificador de entregabilidade de email

Product	Task type	Return fields
Verificador de entregabilidade	`email_check`	`email`, `activated`
Verificador de avatar	`email_avatar`	`email`, `activated`, `avatar`, `name`

Global Carrier Checker

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

US Carrier Advanced

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

Utilitários compartilhados

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.