# Extraia um nome e um sinal de gênero de um endereço de e-mail > Extraia um nome candidato de um endereço de e-mail e complemente seu fluxo no Excel, no Google Sheets ou na API com a previsão e os campos de origem correspondentes, sem substituir as informações fornecidas pela própria pessoa. Canonical HTML: https://www.genderapi.io/pt/blog/extrair-nomes-de-enderecos-de-email Last reviewed: 2026-09-29 ## Informações da publicação Primeira publicação: 2025-06-14T12:00:00.000Z Última revisão: 2026-09-29T00:00:00.000Z ## A GenderAPI consegue extrair um nome de um endereço de e-mail? Sim. Em endereços pessoais compatíveis, a GenderAPI pode extrair um nome candidato da parte antes do @ e retornar um sinal de gênero, contexto de país e confiança. Trata-se de uma inferência, não de uma verificação de identidade, e endereços genéricos ou aleatórios podem ficar sem resultado. - [Demonstração ao vivo da V2 e das suas opções](https://www.genderapi.io/pt/blog/extrair-nomes-de-enderecos-de-email#demo) ## Analise um endereço de e-mail Envie um valor e confira a resposta completa, incluindo resultados desconhecidos e créditos usados. Sempre IA (padrão): 2 créditos, mesmo quando o resultado for desconhecido. Fallback: 1 crédito, incluindo o fallback de IA e os resultados desconhecidos. Desativado, apenas conjunto de dados (sem IA): 1 crédito por requisição concluída, mesmo quando o resultado for desconhecido. Com a interpretação de apelidos: 1 crédito se o resultado vier do conjunto de dados, ou 2 no total se a IA for usada, mesmo quando o resultado for desconhecido. O valor enviado (o endereço de e-mail completo) é transmitido à GenderAPI.io e repassado ao serviço de IA configurado no modo Sempre IA (padrão) ou quando o fallback de IA for necessário, mas não no modo Desativado. [Saiba mais sobre o tratamento dos dados](https://www.genderapi.io/pt/data-provenance). Esta resposta real foi obtida em 1º de outubro de 2026; apenas o saldo da conta foi substituído. Os valores ao vivo podem ser diferentes. Uma previsão não é uma identidade confirmada. **Resposta V2 real; obtida em 1º de outubro de 2026** ```json { "data": { "input": { "type": "email", "value": "lucas.silva@example.com", "country": null }, "name": "lucas", "gender": "male", "country": null, "confidence": 0.98, "confidence_kind": "model_reported", "sample_count": null, "source": "ai", "result_status": "identified", "reason": null, "country_source": null, "match": { "name": null, "method": "model_inference", "scope": null, "country": null } }, "meta": { "request_id": "633abdfc-8360-414f-95f9-187966c8ed9e", "duration_ms": 381, "access": { "mode": "api_key", "reason": null }, "usage": { "charged_credits": 2, "remaining_credits": 49999, "billing_status": "confirmed", "resets_at": null, "limit": null, "period_seconds": null } } } ``` - [crie uma conta](https://app.genderapi.io/user/register) ## Do endereço de e-mail aos dados estruturados - Entrada: emilyblack@email.com - Extração: Emily - Enriquecimento: Gênero + confiança ## Escolha onde processar os dados de e-mail - [Microsoft Excel Instalar o complemento →](https://appsource.microsoft.com/en-us/product/office/WA200008555) - [Google Sheets Abrir o Marketplace →](https://workspace.google.com/marketplace/app/gender_api_determines_gender_of_name_or/712811575775) - [Shopify Ver o aplicativo →](https://apps.shopify.com/gender-api) - [Excel / CSV em lote Abrir a ferramenta →](https://app.genderapi.io/csv) - [Airtable Ver a extensão →](https://airtable.com/marketplace/blkqCasjQIqmmBrmb/gender-api-io-determine-gender) - [REST API Ver o endpoint →](https://www.genderapi.io/pt/docs/v2/gender-from-email) ## Processe colunas de endereços com o complemento do Excel Escolha o método para endereços de e-mail e, em seguida, mapeie a coluna de origem e os campos de resultado. Use GENDER.FROM_EMAIL para consultas dinâmicas em células ou o painel lateral para resultados permanentes. - [Assistir ao tutorial do Excel](https://youtu.be/6j4w-3oMZnA) - [Complemento GenderAPI para Excel](https://www.genderapi.io/pt/blog/genderize-excel-names-using-genderapi-excel-add-in) - [Fórmulas GENDER no Excel](https://www.genderapi.io/pt/blog/formula-genero-para-microsoft-excel) ## Analise endereços de e-mail com o complemento ou uma fórmula Use o complemento para linhas existentes, um fluxo compatível para novas linhas ou a fórmula GENDER para consultas em células individuais. - [Guia do complemento](https://www.genderapi.io/pt/blog/como-determinar-o-genero-no-google-sheets-usando-gender-api-add-on) - [Fórmula GENDER no Google Sheets](https://www.genderapi.io/pt/blog/formula-genero-google-sheets-identificar-genero-por-nomes) ## Integre a análise de endereços de e-mail ao seu backend Chame o endpoint autenticado para endereços de e-mail a partir do servidor, sem expor a chave de API no navegador nem em código público. Trate explicitamente o esquema da resposta, os códigos de erro e o consumo de créditos. Captura de tela de resultados de uma integração anterior; ela não mostra o contrato de resposta atual da V2. - [Requisição individual para um endereço de e-mail](https://www.genderapi.io/pt/docs/v2/gender-from-email) - [Requisição para vários endereços de e-mail](https://www.genderapi.io/pt/docs/v2/batch) ## Não force um resultado quando o endereço não contém um nome Endereços funcionais, identificadores aleatórios e caixas de correio compartilhadas nem sempre oferecem um sinal confiável. Preserve data.result_status, data.reason e data.confidence e trate os resultados incertos separadamente. Uma correspondência em um endereço de e-mail não confirma a identidade nem o nome do titular da caixa de correio. Meça a qualidade com os seus próprios dados e não baseie uma decisão de alto impacto para uma pessoa somente nesta previsão. ## Guarde os dados de origem e a previsão separadamente Mantenha o identificador original do registro. A API não abre nenhum perfil, não verifica quem é o titular de uma conta e não confirma nenhuma identidade. Envie um contexto de país somente quando tiver uma informação confiável; não o deduza do domínio nem do idioma do site. A consulta ao conjunto de dados analisa a parte antes do @, remove um sufixo iniciado por + e avalia os nomes candidatos. Uma requisição padrão também pode acrescentar um número limitado de candidatos a partir de prefixos e sufixos de partes compostas. Se várias linhas corresponderem, é escolhida a que tem o maior número de ocorrências registradas; esse candidato não é necessariamente o nome real da pessoa. Se você enviar um país, a linha desse país tem preferência para cada candidato; quando ela não existe, pode ser usada uma linha global. Verifique data.match.scope e country_source. | Registro | Campo | Interpretação | | --- | --- | --- | | Registro de origem | contact_id / original_email | Mantenha os dados de origem no seu próprio sistema e não substitua pela previsão um nome informado pela própria pessoa. Estes não são campos da resposta da API. | | Nome candidato | data.name / data.match | O nome escolhido pode ser null. Não existe um campo de sobrenome verificado, e uma correspondência não comprova quem é o titular da caixa de correio. | | Previsão | data.gender / data.result_status / data.reason | Grave um resultado desconhecido como null em JSON. Uma linha empatada no conjunto de dados pode conter um nome candidato sem gênero. | | Evidência | data.source / data.confidence_kind / data.confidence / data.sample_count | confidence fica entre 0 e 1. A frequência no conjunto de dados e uma pontuação da IA são medidas diferentes; para a IA, sample_count é null. | | Registro da operação | meta.request_id / meta.usage | Guarde o ID e o status da cobrança; uma resposta perdida não significa que a operação foi gratuita nem que falhou. | ### Escolha o modo de processamento e o custo em créditos Em uma requisição individual, o padrão é fallback; nos itens de um lote, off. forceToGenderize é opcional para nomes, endereços de e-mail e nomes de usuário; nesse caso, omita ai_mode ou use fallback, porque a opção não pode ser combinada com off nem com always. Resultados unknown concluídos também são cobrados. Um saldo inicial positivo basta para começar; ao final da operação, o saldo pode ficar negativo. Quando a IA é usada, ela recebe o endereço completo que você enviou, incluindo o domínio e o sufixo com +, mesmo que seja instruída a ignorar essas partes. forceToGenderize pode associar um gênero sem que um nome real tenha sido encontrado; isso não significa que um nome verificado foi extraído para o seu CRM. | Opção | Processamento | Custo por item concluído | | --- | --- | --- | | options.ai_mode: off | Somente o conjunto de dados | 1 crédito | | options.ai_mode: fallback | Primeiro o conjunto de dados; se não for possível determinar um gênero, fallback de IA comum | 1 crédito no total, incluindo a IA | | options.ai_mode: always | Diretamente para a IA | 2 créditos | | forceToGenderize: true | Primeiro o conjunto de dados; depois, interpretação do apelido sem exigir um nome real | 1 se o conjunto de dados bastar; 2 no total se a IA for usada | ### Teste primeiro uma requisição de e-mail que usa somente o conjunto de dados Uma entrada de exemplo não garante uma previsão específica. Defina GENDERAPI_API_KEY no ambiente do servidor e não coloque a chave em código público do lado do cliente. A V1 e a V2 usam a mesma chave da conta e o mesmo saldo. Verifique a chave com /api/v2/usage e confirme que meta.access.mode tem o valor api_key. Escolha uma linguagem de programação. [Configure sua chave de API](https://www.genderapi.io/pt/docs/v2/authentication#environment-setup), depois execute o exemplo no seu servidor. Cada requisição de previsão é uma nova operação cobrada, inclusive as novas tentativas. Estes exemplos não fazem novas tentativas automaticamente. Verifique o status da cobrança antes de enviar outra requisição. ### Antes de executar: acesso e tratamento de erros Execute estes exemplos no seu servidor. Defina GENDERAPI_API_KEY no ambiente do processo com a sua chave de API existente. Confirme que meta.access.mode é api_key: uma chave não reconhecida pode levar ao teste por IP. Respostas JSON com HTTP 4xx e 5xx preservam o corpo do erro e retornam um código de saída diferente de zero. Verifique code, action e meta.usage.billing_status antes de fazer uma nova tentativa. **cURL** cURL 7.76+ em um shell POSIX. Execute no seu terminal. [Documentação do ambiente de execução](https://curl.se/docs/manpage.html) ```bash curl --silent --show-error --fail-with-body --max-time 30 \ --request POST 'https://api.genderapi.io/api/v2/gender' \ --header "Authorization: Bearer ${GENDERAPI_API_KEY:?Set GENDERAPI_API_KEY}" \ --header 'Content-Type: application/json' \ --data '{ "type": "email", "value": "alice.smith@example.com", "options": { "ai_mode": "off" } }' ``` **JavaScript / Node.js** Node.js 22+; fetch nativo. Salve como example.mjs e execute node example.mjs. [Documentação do ambiente de execução](https://nodejs.org/api/globals.html#fetch) ```javascript // Server-side Node.js. Save as example.mjs. const apiKey = process.env.GENDERAPI_API_KEY; if (!apiKey) throw new Error("Set GENDERAPI_API_KEY"); const body = { "type": "email", "value": "alice.smith@example.com", "options": { "ai_mode": "off" } }; const response = await fetch("https://api.genderapi.io/api/v2/gender", { method: "POST", headers: { Authorization: `Bearer ${apiKey}`, "Content-Type": "application/json", }, body: JSON.stringify(body), signal: AbortSignal.timeout(30_000), redirect: "error", }); const raw = await response.text(); if (!(response.headers.get("content-type") ?? "").includes("json")) { throw new Error(`HTTP ${response.status}: expected JSON; request ID ${response.headers.get("x-request-id")}`); } const result = JSON.parse(raw); // Also accepts application/problem+json. if (!response.ok) { console.error(`HTTP ${response.status}`, result); process.exitCode = 1; // A retry is a new operation; inspect billing first. } else { console.log(JSON.stringify(result, null, 2)); // For batches, inspect every item: HTTP 200 may contain item errors. } ``` **Python** Python 3.10+; biblioteca padrão. Salve como example.py e execute python3 example.py. [Documentação do ambiente de execução](https://docs.python.org/3/library/urllib.request.html) ```python import json import os import sys import urllib.error import urllib.request api_key = os.environ.get("GENDERAPI_API_KEY") if not api_key: raise RuntimeError("Set GENDERAPI_API_KEY") body = json.loads("{\"type\":\"email\",\"value\":\"alice.smith@example.com\",\"options\":{\"ai_mode\":\"off\"}}") class NoRedirect(urllib.request.HTTPRedirectHandler): def redirect_request(self, req, fp, code, msg, headers, newurl): return None request = urllib.request.Request( "https://api.genderapi.io/api/v2/gender", method="POST", data=json.dumps(body).encode("utf-8"), headers={ "Authorization": "Bearer " + api_key, "Content-Type": "application/json", }, ) opener = urllib.request.build_opener(NoRedirect()) try: response = opener.open(request, timeout=30) except urllib.error.HTTPError as error: response = error # Keep the Problem Details body on non-2xx responses. with response: status = response.status raw = response.read().decode("utf-8") if "json" not in response.headers.get("Content-Type", ""): raise RuntimeError(f"HTTP {status}: expected a JSON response") result = json.loads(raw) print(json.dumps(result, indent=2), file=sys.stderr if status >= 300 else sys.stdout) if not 200 <= status < 300: sys.exit(1) # Inspect code, action and billing before retrying. # For batches, inspect every item even when HTTP status is 200. ``` **PHP** PHP 8+ com a extensão cURL. Salve como example.php e execute php example.php. [Documentação do ambiente de execução](https://www.php.net/manual/en/book.curl.php) ```php 'POST', CURLOPT_RETURNTRANSFER => true, CURLOPT_FOLLOWLOCATION => false, CURLOPT_TIMEOUT => 30, CURLOPT_HTTPHEADER => [ 'Authorization: Bearer ' . $apiKey, 'Content-Type: application/json', ], CURLOPT_POSTFIELDS => json_encode($body, JSON_THROW_ON_ERROR), ]); $raw = curl_exec($ch); if ($raw === false) { throw new RuntimeException(curl_error($ch)); } $status = curl_getinfo($ch, CURLINFO_HTTP_CODE); $contentType = curl_getinfo($ch, CURLINFO_CONTENT_TYPE) ?: ''; curl_close($ch); if (strpos($contentType, 'json') === false) { throw new RuntimeException("HTTP $status: expected a JSON response"); } $result = json_decode($raw, true, 512, JSON_THROW_ON_ERROR); $output = json_encode($result, JSON_PRETTY_PRINT | JSON_THROW_ON_ERROR) . PHP_EOL; if ($status < 200 || $status >= 300) { fwrite(STDERR, $output); // Preserve the Problem Details body. exit(1); } echo $output; // For batches, inspect every item; HTTP 200 can contain item errors. ``` **Java** Java 17+; cliente HTTP padrão. Salve como GenderApiExample.java e execute java GenderApiExample.java. [Documentação do ambiente de execução](https://docs.oracle.com/en/java/javase/17/docs/api/java.net.http/java/net/http/HttpClient.html) ```java import java.net.URI; import java.net.http.HttpClient; import java.net.http.HttpRequest; import java.net.http.HttpResponse; import java.nio.charset.StandardCharsets; import java.time.Duration; public class GenderApiExample { private static String requiredEnv(String name) { String value = System.getenv(name); if (value == null || value.isBlank()) throw new IllegalStateException("Set " + name); return value; } public static void main(String[] args) throws Exception { String apiKey = requiredEnv("GENDERAPI_API_KEY"); String body = "{\"type\":\"email\",\"value\":\"alice.smith@example.com\",\"options\":{\"ai_mode\":\"off\"}}"; HttpClient client = HttpClient.newBuilder() .connectTimeout(Duration.ofSeconds(10)) .followRedirects(HttpClient.Redirect.NEVER) .build(); HttpRequest request = HttpRequest.newBuilder(URI.create("https://api.genderapi.io/api/v2/gender")) .timeout(Duration.ofSeconds(30)) .header("Authorization", "Bearer " + apiKey) .header("Content-Type", "application/json") .POST(HttpRequest.BodyPublishers.ofString(body, StandardCharsets.UTF_8)) .build(); HttpResponse response = client.send(request, HttpResponse.BodyHandlers.ofString(StandardCharsets.UTF_8)); if (!response.headers().firstValue("content-type").orElse("").contains("json")) { throw new IllegalStateException("HTTP " + response.statusCode() + ": expected JSON"); } // JSON text; parse with your application's JSON library when integrating. if (response.statusCode() < 200 || response.statusCode() >= 300) { System.err.println(response.body()); // Includes Problem Details. System.exit(1); } System.out.println(response.body()); // For batches, inspect each item's data or error, including on HTTP 200. } } ``` **C# / .NET** Aplicação de console .NET 8+. Use como Program.cs em um projeto de console e depois execute dotnet run. [Documentação do ambiente de execução](https://learn.microsoft.com/en-us/dotnet/fundamentals/networking/http/httpclient) ```csharp using System; using System.Net.Http; using System.Net.Http.Headers; using System.Text; using System.Text.Json; string RequiredEnv(string name) => !string.IsNullOrWhiteSpace(Environment.GetEnvironmentVariable(name)) ? Environment.GetEnvironmentVariable(name)! : throw new InvalidOperationException($"Set {name}"); var apiKey = RequiredEnv("GENDERAPI_API_KEY"); using var handler = new HttpClientHandler { AllowAutoRedirect = false }; using var client = new HttpClient(handler) { Timeout = TimeSpan.FromSeconds(30) }; using var request = new HttpRequestMessage(HttpMethod.Post, "https://api.genderapi.io/api/v2/gender"); request.Headers.Authorization = new AuthenticationHeaderValue("Bearer", apiKey); request.Content = new StringContent("{\"type\":\"email\",\"value\":\"alice.smith@example.com\",\"options\":{\"ai_mode\":\"off\"}}", Encoding.UTF8, "application/json"); using var response = await client.SendAsync(request); var raw = await response.Content.ReadAsStringAsync(); if (!(response.Content.Headers.ContentType?.MediaType?.Contains("json") ?? false)) throw new InvalidOperationException($"HTTP {(int)response.StatusCode}: expected JSON"); using var result = JsonDocument.Parse(raw); if (!response.IsSuccessStatusCode) { Console.Error.WriteLine(result.RootElement); // Preserve Problem Details. Environment.ExitCode = 1; } else { Console.WriteLine(result.RootElement); // For batches, inspect every item even on HTTP 200. } ``` **Go** Go 1.22+; biblioteca padrão. Salve como main.go e execute go run main.go. [Documentação do ambiente de execução](https://pkg.go.dev/net/http) ```go package main import ( "encoding/json" "fmt" "io" "net/http" "os" "strings" "time" ) func requiredEnv(name string) string { value := os.Getenv(name) if value == "" { panic("Set " + name) } return value } func run() error { apiKey := requiredEnv("GENDERAPI_API_KEY") body := "{\"type\":\"email\",\"value\":\"alice.smith@example.com\",\"options\":{\"ai_mode\":\"off\"}}" request, err := http.NewRequest("POST", "https://api.genderapi.io/api/v2/gender", strings.NewReader(body)) if err != nil { return err } request.Header.Set("Authorization", "Bearer " + apiKey) request.Header.Set("Content-Type", "application/json") client := &http.Client{ Timeout: 30 * time.Second, CheckRedirect: func(req *http.Request, via []*http.Request) error { return http.ErrUseLastResponse }, } response, err := client.Do(request) if err != nil { return err } defer response.Body.Close() raw, err := io.ReadAll(response.Body) if err != nil { return err } if !strings.Contains(response.Header.Get("Content-Type"), "json") || !json.Valid(raw) { return fmt.Errorf("HTTP %d: expected a JSON response", response.StatusCode) } if response.StatusCode < 200 || response.StatusCode >= 300 { return fmt.Errorf("HTTP %d: %s", response.StatusCode, raw) } fmt.Println(string(raw)) // For batches, inspect every item even on HTTP 200. return nil } func main() { if err := run(); err != nil { fmt.Fprintln(os.Stderr, err) // Keep Problem Details for error handling. os.Exit(1) } } ``` - [Guia de erros e novas tentativas →](https://www.genderapi.io/pt/docs/v2/errors-and-retries) ### Trate os resultados de listas e de requisições repetidas POST /api/v2/gender/batch aceita até 50 itens com uma chave de API e 10 com o teste por IP. Informe valores próprios de type, value e options em cada item. Se quiser usar o fallback de IA comum, defina fallback explicitamente em cada item. id deve ser único dentro do lote; index começa em zero dentro do lote enviado. Guarde separadamente os seus próprios identificadores de job e de linha de origem. HTTP 200 não significa que todos os itens foram concluídos. Trate os resultados identified, unknown e error separadamente; meta.summary.succeeded conta tanto identified quanto unknown. Avalie data.gender, source, confidence_kind, confidence, match e reason em conjunto. Não trate uma pontuação da IA e uma frequência no conjunto de dados como equivalentes. Se meta.usage.billing_status tiver o valor confirmed, repita somente os erros operacionais que permitem uma nova requisição. Se o status for unconfirmed ou se a resposta tiver sido perdida, pare e verifique a cobrança. Reenviar o mesmo item, inclusive um resultado unknown concluído, cria uma nova operação paga; nunca reenvie a lista inteira às cegas. [Contrato das requisições em lote](https://www.genderapi.io/pt/docs/v2/batch) · [Campos da resposta](https://www.genderapi.io/pt/docs/v2/responses) · [Opções de IA](https://www.genderapi.io/pt/docs/v2/ai-options) · [Avaliação de precisão e confiança](https://www.genderapi.io/pt/accuracy-methodology) · [Política de Privacidade](https://www.genderapi.io/pt/privacy-policy) Os complementos para Excel e Google Sheets e as demais integrações prontas podem usar a própria conexão e o próprio formato de resultado. Não presuma que a saída deles segue este esquema JSON da V2; consulte o guia atual da integração correspondente. ## Nome e gênero a partir de endereços de e-mail ### É possível extrair um nome de um endereço de e-mail? A GenderAPI pode extrair um nome candidato da parte antes do @ em endereços pessoais compatíveis e, quando disponíveis, retornar informações de gênero, país e confiança. O candidato é uma inferência, não o nome verificado do titular da caixa de correio. ### Todo endereço de e-mail fornece um nome? Não. Endereços funcionais, identificadores aleatórios e partes locais sem um nome real nem sempre oferecem um sinal confiável. Verifique data.result_status, data.reason, data.confidence e data.confidence_kind na resposta da V2. ### As consultas de e-mail são armazenadas? Segundo a política publicada, as consultas de e-mail não são retidas como registros de consulta reutilizáveis. Os logs técnicos e de segurança separados seguem os prazos indicados na Política de Privacidade. Não use dados pessoais sensíveis na demonstração pública. ### Posso usar o recurso no Excel e no Google Sheets? Sim. Colunas de endereços podem ser processadas com o complemento do Excel, o complemento do Google Sheets ou a ferramenta de importação de arquivos Excel e CSV. Essas integrações têm o próprio formato de resultado, diferente do JSON da V2. ### Quais campos a API retorna? A V2 retorna data.name, data.gender, data.match e os campos de fonte e confiança e, em meta, também o ID da operação e o consumo de créditos. O nome candidato ou o gênero podem ser null. Não existe um campo de sobrenome verificado. ### Quando a IA é usada? Em uma requisição individual da V2, o fallback de IA comum fica ativado por padrão. Nesta demonstração, você pode usar uma requisição padrão ou forceToGenderize; off e always são definidos na requisição à API. O fallback de IA comum custa 1 crédito no total, always custa 2. Com forceToGenderize, é cobrado 1 crédito se o conjunto de dados fornecer um resultado ou 2 no total se a IA for usada; o resultado pode continuar unknown. ### Posso testar o serviço gratuitamente? As contas incluem 200 créditos gratuitos por dia, e o teste por IP compartilhado oferece 10 créditos por endereço IP público a cada 24 horas. Uma chave ausente ou não reconhecida pode levar ao teste por IP; verifique o campo meta.access.mode na resposta. Trata-se de créditos, não de um número de requisições.