API do weryfikacji email, które sprawdza też adresy catch-all
Sprawdź jednym wywołaniem REST, czy dana skrzynka istnieje. W domenach catch-all, gdzie większość API kończy na „accept-all” albo „ryzykowny”, dostajesz w tej samej odpowiedzi wynik prawidłowy albo nieprawidłowy. Nasze API do weryfikacji email daje zespołom programistów czyste dane JSON, które chronią reputację nadawcy we wszystkich kampaniach wychodzących.
curl -X POST https://api.giggal.ai/v1/verify \
-H "Authorization: Bearer tp_live_xxxxxxxxxxxxxxxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{"email":"alex.smith@example.com"}'1000 darmowych kredytów, bez karty. Kredyty nigdy nie wygasają.
Giggal.ai ma wyróżnienie Leader w serwisach SourceForge i Slashdot
Co zwraca jedno wywołanie API
Jedno wywołanie zwraca pełne dane o dostarczalności. Dostajesz główny status dostarczalności, ocenę ryzyka, liczbowy wynik dostarczalności, atrybuty skrzynki i wynik catch-all w tej samej odpowiedzi.
{
"success": true,
"data": {
"email": "alex.smith@example.com",
"is_valid": true,
"status": "deliverable",
"risk_level": "low",
"deliverability_score": 92,
"catch_all_score": 89,
"catch_all_verdict": "valid",
"details": {
"general": {
"domain": "example.com",
"reason": "Mailbox confirmed deliverable"
},
"attributes": {
"free_email": false,
"role_account": false,
"disposable": false,
"catch_all": true,
"has_plus_tag": false,
"mailbox_full": false,
"no_reply": false
},
"mail_server": {
"smtp_provider": "google",
"mx_record": "aspmx.l.google.com"
}
}
},
"meta": {
"creditsUsed": 1
}
}Jak obsłużyć wartości statusu w odpowiedzi
Główny status dostarczenia jest zwracany w polu status. Oto jak backend twojej aplikacji powinien interpretować każdą wartość i co z nią zrobić:
| Status | Znaczenie | Zalecane działanie |
|---|---|---|
| deliverable | Docelowy serwer pocztowy przyjął adresata. Skrzynka jest w pełni aktywna. | Można bezpiecznie wysyłać. Dodaj adres do głównych kampanii. |
| undeliverable | Skrzynka nie istnieje, składnia jest błędna, domena nie ma rekordów MX albo domena jest jednorazowa. | Nie wysyłaj. Usuń adres z kampanii, aby uniknąć twardych odbić. |
| unknown | Odpowiedź serwera nie daje jasnego wyniku, zwykle z powodu greylistingu lub przekroczenia czasu połączenia. | Sprawdź adres ponownie później. Kredyty za nieznane wyniki są zwracane automatycznie. |
Adresy catch-all sprawdzone w tym samym wywołaniu
Zwykłe testy zawodzą w domenach catch-all. Gdy firmowy serwer pocztowy przyjmuje każdy przychodzący adres, zwykłe narzędzia widzą pozytywną odpowiedź zarówno dla prawdziwych skrzynek, jak i dla literówek. Nie mogą sprawdzić nic więcej, więc większość z nich oznacza adres jako „ryzykowny” albo „accept-all” i zostawia decyzję tobie.
Około 30% typowej listy B2B to adresy w domenach catch-all albo w domenach za bramkami bezpieczeństwa poczty (SEG), takimi jak Proofpoint i Mimecast. Usunięcie tych adresów oznacza utratę prawdziwych kupujących. Wysyłka bez weryfikacji powoduje gwałtowny wzrost odbić.
Nasz silnik weryfikacji dokładnie sprawdza adresy catch-all w tym samym wywołaniu. Sprawdza, czy skrzynka istnieje, i zwraca catch_all_verdict („valid” albo „invalid”) oraz catch_all_score w skali od 0 do 100. Więcej znajdziesz w poradnikach o weryfikacji catch-all i o sprawdzaniu skrzynek za bramkami bezpieczeństwa poczty.
Tradycyjne API do weryfikacji
Zatrzymuje się na domenach accept-all
{
"email": "sarah.connor@cyberdyne.com",
"status": "risky",
"reason": "accept_all_domain",
"is_deliverable": null,
"action": "manual_review_required"
}Niepewność przechodzi na twój zespół. Wysyłasz i ryzykujesz dużo odbić albo odrzucasz prawdziwych potencjalnych klientów.
API Giggal.ai
Sprawdza catch-all w tym samym wywołaniu
{
"email": "sarah.connor@cyberdyne.com",
"status": "deliverable",
"is_valid": true,
"catch_all_verdict": "valid",
"catch_all_score": 94,
"details": { "catch_all": true }
}Potwierdzona aktywna skrzynka. Zachowujesz prawdziwe kontakty catch-all i chronisz reputację nadawcy.
Endpointy do testów pojedynczych, masowych i catch-all
Niezależnie od tego, czy sprawdzasz jeden kontakt, czy dużą listę, nasze API do weryfikacji email ma osobne endpointy przygotowane z myślą o wydajności i niezawodności.
Weryfikacja pojedynczego adresu e-mail
Synchroniczna weryfikacja jednego adresu e-mail. Sprawdza, czy adres istnieje, wykonuje diagnostykę domeny i sprawdza adresy catch-all w tym samym wywołaniu. Zwraca pełny wynik w JSON.
Zobacz dokumentację endpointuMasowa weryfikacja e-mail
Asynchroniczne przetwarzanie do 50 000 adresów w jednym zadaniu. Duplikaty i błędna składnia są usuwane po stronie serwera. Obsługuje nagłówek Idempotency-Key, który zapobiega podwójnemu naliczeniu opłaty.
Odpytywanie zadań i wyniki
Sprawdzaj postęp zadania przez GET /v1/jobs/:jobId co 10 do 15 sekund. Pobieraj wyniki stronami, do 500 rekordów na stronę. Wyniki są bezpiecznie przechowywane przez 48 godzin.
Masowe sprawdzanie adresów catch-all
Uruchom dokładny test catch-all dla adresów oznaczonych jako catch-all w ukończonym zadaniu masowym. Pobierz wyniki jako czysty plik CSV z kolumnami wyniku liczbowego i statusu.
Zobacz dokumentację catch-allOznaczenia w każdej odpowiedzi
Poza wynikiem prawidłowy albo nieprawidłowy każda odpowiedź zawiera szczegółowe atrybuty skrzynki. Pomagają one dzielić kontakty na segmenty, zapobiegać nadużyciom i stosować automatyczne reguły filtrowania.
| Oznaczenie | Ścieżka pola | Opis i zastosowanie |
|---|---|---|
| Jednorazowy | details.attributes.disposable | Wykrywa tymczasowe, jednorazowe skrzynki. Blokuj je od razu, aby zatrzymać nadużycia okresów próbnych. |
| Adres funkcyjny | details.attributes.role_account | Wykrywa ogólne skrzynki działów (info@, billing@, support@). Przekazuj je zespołom, które obsługują CRM. |
| Darmowa poczta | details.attributes.free_email | Oznacza domeny darmowej poczty dla konsumentów (gmail.com, yahoo.com), aby oddzielić prywatne skrzynki od firmowych kontaktów. |
| Catch-all | details.attributes.catch_all | Pokazuje, czy serwer przyjmuje całą pocztę. Użyj razem z catch_all_verdict, aby odzyskać prawidłowe kontakty. |
| Tag plus | details.attributes.has_plus_tag | Wykrywa adresy z aliasem (user+tag@). Zapobiega zakładaniu wielu kont przez jedną osobę. |
| Pełna skrzynka | details.attributes.mailbox_full | Pokazuje, że limit miejsca został przekroczony. Poczta wysłana na ten adres da miękkie odbicie. |
| No-reply | details.attributes.no_reply | Oznacza adresy nadawcze, których nikt nie czyta. Nie wysyłaj na nie wiadomości, które wymagają odpowiedzi. |
| Test czarnej listy | details.blacklist.is_blacklisted | Sprawdza domenę i adresy IP serwera na głównych listach DNSBL i podaje wyniki reputacji. |
Gdzie zespoły używają API do weryfikacji email
Nasze endpointy łączą się bezpośrednio z potokami danych, procesami w CRM i bazami danych.
Synchronizacja z CRM i hurtownią danych
Weryfikuj dane kontaktowe na bieżąco przed synchronizacją z Salesforce, HubSpot lub Snowflake. Czyść nieaktualne rekordy według harmonogramu i utrzymuj dokładne dane kontaktowe.
Czyszczenie list przed kampanią
Czyść listy mailingowe przed dużymi wysyłkami. Jeśli pracujesz ręcznie, listy możesz też wgrać bezpośrednio w interfejsie czyszczenia listy mailingowej.
Wzbogacanie danych o leadach
Uruchamiaj automatyczne testy skrzynek za każdym razem, gdy narzędzia SDR lub narzędzia do wzbogacania danych znajdą nowe firmowe adresy e-mail. Handlowcy piszą wtedy tylko na zweryfikowane adresy.
Automatyzacja procesów
Połącz nasze endpointy weryfikacji z Zapier, n8n, Make i webhookami przez nasze integracje.
Agenci AI przez MCP
Pozwól, aby Claude, ChatGPT, Cursor i własni agenci AI weryfikowali kontakty bezpośrednio w rozmowie przez nasz serwer MCP.
Walidacja formularzy rejestracji
Chcesz sprawdzać adresy, gdy użytkownicy wpisują je w formularzach rejestracji i formularzach kontaktowych? Zobacz nasze API do walidacji email do testów formularzy w czasie rzeczywistym.
Przykłady kodu
Fragmenty kodu po stronie serwera do testów pojedynczych i masowych. Trzymaj klucz API w zmiennych środowiskowych.
// Node.js (Node 18+)
const res = await fetch('https://api.giggal.ai/v1/verify', {
method: 'POST',
headers: {
'Authorization': `Bearer ${process.env.GIGGAL_API_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({ email: 'alex.smith@example.com' }),
});
const data = await res.json();
if (data.success) {
console.log('Status:', data.data.status); // deliverable, undeliverable, unknown
console.log('Catch-all result:', data.data.catch_all_verdict); // valid | invalid
} else {
console.error('Verification error:', data.error);
}import os
import requests
url = "https://api.giggal.ai/v1/verify"
headers = {
"Authorization": f"Bearer {os.environ['GIGGAL_API_KEY']}",
"Content-Type": "application/json"
}
payload = {"email": "alex.smith@example.com"}
response = requests.post(url, json=payload, headers=headers)
result = response.json()
if result.get("success"):
data = result["data"]
print("Status:", data["status"])
print("Catch-All Result:", data.get("catch_all_verdict"))
else:
print("Error:", result.get("error"))Proces masowy: wyślij zadanie, sprawdzaj postęp i pobierz wyniki
Utworzenie zadania wsadowego wymaga jednego wywołania. Sprawdzaj postęp co 10 do 15 sekund, aż status zadania zmieni się na completed.
// 1. Submit batch job (up to 50,000 emails)
const submitRes = await fetch('https://api.giggal.ai/v1/verify-batch', {
method: 'POST',
headers: {
'Authorization': `Bearer ${process.env.GIGGAL_API_KEY}`,
'Content-Type': 'application/json',
'Idempotency-Key': 'batch-job-2026-10-01-01',
},
body: JSON.stringify({
name: 'Q4 Sales Leads',
emails: ['alex.smith@example.com', 'maria.garcia@example.org'],
}),
});
const { data: job } = await submitRes.json();
const jobId = job.jobId;
// 2. Poll job status until completed
// GET https://api.giggal.ai/v1/jobs/${jobId}
// 3. Fetch paginated verification results
const resultsRes = await fetch(`https://api.giggal.ai/v1/jobs/${jobId}/results?page=1&limit=500`, {
headers: { 'Authorization': `Bearer ${process.env.GIGGAL_API_KEY}` },
});
const results = await resultsRes.json();Cennik API do weryfikacji email
Prosty cennik za użycie, bez miesięcznego zobowiązania. Jeden kredyt weryfikuje jeden adres. W pojedynczych testach przez API sprawdzanie catch-all jest w cenie tego samego 1 kredytu. W zadaniach wsadowych standardowa weryfikacja kosztuje 1 kredyt za adres, a dokładna weryfikacja wierszy catch-all kosztuje 1 kredyt za każdy sprawdzony adres catch-all. Kredyty nigdy nie wygasają, a kredyty za nieznane wyniki są zwracane automatycznie.
Potrzebujesz większego wolumenu dla firmy? Zobacz pełny cennik.
Limity zapytań i błędy
Standardowe limity zapytań obowiązują dla każdego klucza API. Stan limitu jest zwracany przy każdym zapytaniu w standardowych nagłówkach:X-RateLimit-Limit iX-RateLimit-Remaining.
Limity zapytań w oknie 15 minut
- Pojedyncze testy (/v1/verify)300 zapytań / 15 min
- Tworzenie zadań wsadowych30 zapytań / 15 min
- Tworzenie zadań catch-all30 zapytań / 15 min
- Odpytywanie zadań i wyniki600 zapytań / 15 min
Kody błędów HTTP
- 400 Bad Request: Błędna składnia albo nieprawidłowa treść JSON.
- 401 Unauthorized: Brak klucza API, klucz wygasł albo jest nieprawidłowy.
- 402 Payment Required: Za mało kredytów na koncie.
- 404 Not Found: Zadanie o podanym ID nie istnieje.
- 409 Conflict: Konflikt danych dla tego samego klucza idempotencji.
- 410 Gone: Wyniki zadania wsadowego wygasły po 48 godzinach.
- 429 Too Many Requests: Przekroczono limit zapytań.
Szczegółowy opis odpowiedzi z błędami i ich treści znajdziesz w dokumentacji błędów API.
Co mówią klienci
Prawdziwe opinie zespołów technicznych, sprzedaży i zespołów ds. wzrostu, które używają Giggal.ai.
"Before Giggal, our team spent hours manually reviewing catch-all addresses because other tools couldn't verify them with confidence. Now we upload large email lists, verify them in minutes, and move directly into campaign preparation."
Vernon L.
Zweryfikowany recenzent G2
"Fast and accurate email verification, excellent catch-all detection, easy-to-use interface, quick processing for large lists, lower bounce rates, improved sender reputation, and more confidence before launching email campaigns."
Billy W.
Recenzent SourceForge
"Giggal Email Verifier makes email validation fast, simple, and reliable. It helps us clean our lists, reduce bounce rates, and improve the overall performance of our outreach campaigns. The accuracy of the verification results makes it a valuable tool."
Hazel Peterson
Recenzent Product Hunt
API do weryfikacji email: pytania i odpowiedzi
Najczęstsze pytania techniczne o uwierzytelnianie, testy skrzynek i obsługę adresów catch-all.
Tak. Każde nowe konto dostaje 1000 darmowych kredytów od razu po rejestracji, bez karty płatniczej. Klucz API wygenerujesz w panelu dewelopera i od razu możesz wysyłać zapytania o weryfikację. Darmowe kredyty nigdy nie wygasają i dają pełny dostęp do każdego endpointu, w tym do pełnych testów skrzynek i dokładnego sprawdzania catch-all.
API sprawdza, czy skrzynka istnieje. Wykonuje zapytania DNS i MX, łączy się z docelowym serwerem pocztowym i sprawdza, czy konkretna skrzynka istnieje i może odbierać pocztę. Połączenie jest zamykane, zanim zostanie przesłana jakakolwiek wiadomość, więc odbiorca nie dostaje żadnego e-maila.
W domenach catch-all serwer pocztowy odpowiada, że przyjmie każdy adres. Dlatego zwykłe narzędzia zwracają wynik „ryzykowny” albo „nieznany”. Giggal sprawdza, czy skrzynka istnieje, i zwraca wynik prawidłowy albo nieprawidłowy oraz catch_all_score w skali od 0 do 100. Dzięki temu nie odrzucasz prawdziwych kontaktów.
Status „nieznany” pojawia się, gdy docelowy serwer pocztowy nie da jednoznacznej odpowiedzi w naszym limicie czasu. Zwykle powodem jest agresywny greylisting albo chwilowa awaria serwera. Nigdy nie płacisz za niejasne odpowiedzi: kredyty za każdą weryfikację z wynikiem nieznanym wracają automatycznie na saldo twojego konta.
Pojedyncze zapytanie synchronicznie sprawdza jeden adres i zwraca bezpośrednio odpowiedź JSON. Do weryfikacji list służy masowy endpoint API, który asynchronicznie przyjmuje do 50 000 adresów w jednym zadaniu wsadowym. Postęp śledzisz przez odpytywanie zadania, a po zakończeniu pobierasz wyniki stronami.
Tak. Giggal.ai udostępnia oficjalny zdalny serwer MCP (Model Context Protocol) pod adresem https://mcp.giggal.ai/mcp. Claude i ChatGPT łączą się z nim przez OAuth, bez klucza API. W lokalnej pracy w Cursor, VS Code i innych klientach możesz skonfigurować lokalny serwer giggal-mcp ze swoim kluczem API i weryfikować adresy bezpośrednio w edytorze.
API do weryfikacji email sprawdza, czy skrzynka naprawdę istnieje. Łączy się bezpośrednio z docelowymi serwerami pocztowymi, sprawdza rekordy DNS i ustala wynik dla adresów catch-all na listach sprzedażowych i w bazach klientów. API do walidacji email służy głównie do testów w czasie rzeczywistym w formularzach rejestracji. Sprawdza format, wykrywa domeny jednorazowe i blokuje fałszywe konta przy wysłaniu formularza. Jeśli potrzebujesz ochrony formularzy, zobacz nasze API do walidacji email.
Zwróć uwagę na trzy rzeczy. Pierwsza to prawdziwe sprawdzanie adresów catch-all, aby nie stracić do 30% kontaktów B2B w grupie „ryzykowne”. Druga to przejrzyste zasady rozliczeń z automatycznym zwrotem kredytów za nieznane wyniki. Trzecia to jasna cena za weryfikację, bez ukrytych opłat cyklicznych i bez miesięcznych minimów.
Zacznij weryfikować adresy e-mail w kilka minut
1000 darmowych kredytów, bez karty płatniczej.
