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

Bem-vindo a NumberChecker 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 NumberChecker 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 numberchecker.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.numberchecker.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.numberchecker.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.numberchecker.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 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 do Twitter	`twitter`	Verifica contas do Twitter 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 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
Verificação de e-mail	`email_check`	Verifica em massa a validade de enderecos de e-mail

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	`usaCarrier`	Consulta operadora, região e tipo do número de telefone

Gerenciamento da conta

Gerencie sua conta NumberChecker 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
NumberChecker	`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
NumberChecker	`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`

NumberChecker

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
NumberChecker	`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
NumberChecker	`imessage`	`number`, `activated`

RCS

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

Signal

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

VK

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

Apple ID

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

Facebook

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

Amazon

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

Instagram

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

MAX

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

Netflix

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

Line

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

X (Twitter)

Product	Task type	Return fields
NumberChecker	`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
NumberChecker	`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
NumberChecker	`zalo`	`number`, `activated`

TikTok

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

Microsoft

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

Snapchat

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

Messenger

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

GoTo

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

Threads

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

Spotify

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

Band

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

DHL

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

Sideline

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

Airbnb

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

Pornhub

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

Temu

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

Botim

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

Exchange Registration Checkers

Binance

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

KuCoin

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

Htx

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

CoinW

Product	Task type	Return fields
NumberChecker	`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
NumberChecker	`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`

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.