API Apollo.io umożliwia wyszukiwanie osób, wzbogacanie rekordów i zarządzanie przepływem pracy sprzedażowej za pomocą własnego kodu. Wywołujesz go przez HTTPS, używając klucza API Apollo.io. Możesz też pominąć klucz i pozwolić klientowi AI uzyskać dostęp do tych samych danych przez serwer MCP Apollo.io. Obie ścieżki wykorzystują kredyty Twojego planu i podlegają jego limitom.
Ten przewodnik przeprowadza przez API Apollo.io — od pierwszego kliknięcia do pierwszego wywołania. Pokazuje, jak utworzyć klucz i gdzie go znaleźć. Obejmuje dokumentację API Apollo.io, kontrolę stanu, wyszukiwanie osób, wzbogacanie danych, limity zapytań i koszty kredytów. Kończy się omówieniem oficjalnego serwera MCP dla Apollo.io oraz procedury sprawdzania adresów zwracanych przez API. Wszystkie informacje pochodzą z oficjalnej dokumentacji dla deweloperów pod adresem docs.apollo.io, przejrzanej w październiku 2026 roku. Apollo.io oznacza kilka stron jako niedawno zaktualizowane, dlatego potwierdź szczegóły w dniu rozpoczęcia pracy.
Nie jesteśmy powiązani z Apollo.io. BillionVerify to usługa weryfikacji adresów e-mail. Aby uzyskać szerszy obraz platformy, przeczytaj nasz przewodnik po Apollo.io.
Najważniejsze informacje (sprawdzone w październiku 2026 roku):
- Każdy poziom, w tym bezpłatny, zapewnia pewien dostęp do API. Bezpłatne konta wymagają służbowego adresu e-mail dla niektórych endpointów.
- API Apollo.io przesyła klucz w nagłówku
x-api-key, a bazowy URL tohttps://api.apollo.io/api/v1. - Klucz API Apollo.io z określonym zakresem uprawnień umożliwia dostęp wyłącznie do zaznaczonych endpointów. Klucz główny zapewnia dostęp do wszystkich.
- Większość endpointów umożliwia 200 wywołań na minutę w płatnym planie, w porównaniu z 50 w planie bezpłatnym.
- Serwer MCP Apollo.io znajduje się pod adresem
https://mcp.apollo.io/mcpi loguje użytkownika za pomocą OAuth.
Co robi API Apollo.io
Apollo.io opisuje swoje API jako sposób na programowe wyszukiwanie, wzbogacanie, tworzenie i zarządzanie danymi. Za nim stoi baza ponad 240 milionów kontaktów i 30 milionów firm. Dokumentacja dzieli te działania na trzy zadania:
- Tworzenie integracji. Połącz swój produkt z danymi Apollo.io, twórz konta i uruchamiaj sekwencje.
- Wzbogacanie danych. Uzupełniaj dane osób i firm pojedynczo lub zbiorczo.
- Znajdowanie osób. Wyszukuj według stanowiska, lokalizacji, szczebla i wielu innych filtrów.
Twój plan decyduje o tym, z których endpointów możesz korzystać, jak szybko możesz je wywoływać oraz ile kosztuje każde wywołanie. Apollo.io informuje również, że jego narzędzia nie mogą wykonywać działań, których nie da się wykonać w aplikacji. Jeśli na Twoim koncie brakuje danej funkcji, API jej nie odblokuje.
Które plany obejmują API?
FAQ dla deweloperów informuje, że każdy poziom ma podstawowy dostęp. Bardziej zaawansowane funkcje są dostępne tylko w wybranych poziomach. Nasz przewodnik po cenach Apollo.io przedstawia poziomy i przypisane do nich pule kredytów.
Darmowych kont dotyczy jeden wyjątek. Niektóre endpointy wyszukiwania osób, wzbogacania danych i rekordów wymagają konta zarejestrowanego przy użyciu firmowego adresu e-mail. Każda strona dotycząca danego endpointu wyraźnie o tym informuje. Płatne konta nie są objęte tym ograniczeniem.
Dla kogo jest API Apollo.io?
Najczęściej korzystają z niego trzy grupy:
- Zespoły Sales i RevOps, które chcą przesyłać wzbogacone dane do CRM lub hurtowni danych.
- Deweloperzy w firmach tworzących oprogramowanie, którzy osadzają dane Apollo.io we własnym produkcie.
- Partnerzy, którzy tworzą integracje marketplace. Logują się za pomocą OAuth 2.0 zamiast klucza.
Apollo.io dodaje uwagę dotyczącą licencji. Udostępnianie, ujawnianie lub odsprzedaż jego danych osobom, które nie są użytkownikami Apollo.io, wymaga indywidualnej umowy.
Dokumentacja API Apollo.io: Gdzie wszystko się znajduje
Dokumentacja API Apollo.io znajduje się pod adresem docs.apollo.io. Górny pasek dzieli ją na sekcje Get Started, API, MCP, CLI, OpenAPI i Changelog. Sekcja API zawiera jedną stronę dla każdego endpointu.

Zrzut ekranu: strona People API Search w dokumentacji deweloperskiej Apollo.io, pochodząca z przewodnika Apollo.io dotyczącego testowania klucza.
Każda strona endpointu ma ten sam układ. Pole „Najważniejsze informacje o endpoincie” u góry zawiera kluczową ścieżkę dostępu, zakres OAuth, informacje o tym, kto może z niego korzystać, oraz koszt w kredytach. Poniżej znajdują się parametry. Po prawej stronie dostępne są wybór języka, pole danych uwierzytelniających, żądanie cURL i przykładowa odpowiedź.
Możesz testować działanie bezpośrednio na stronie. Wklej klucz w polu nagłówka, uzupełnij wymagane parametry i kliknij Wypróbuj. Kod 200 oznacza, że wywołanie się powiodło. Nawet bez klucza możesz otworzyć każdą przykładową odpowiedź, aby zobaczyć schemat.
Plik OpenAPI
Apollo.io publikuje całe API jako jeden plik OpenAPI 3 pod adresem https://docs.apollo.io/openapi/apollo-rest-api.json. Jest on przebudowywany za każdym razem, gdy dokumentacja ulega zmianie. Załaduj go do Postman lub innego klienta API, a każdy endpoint zostanie dodany wraz z parametrami. Możesz także przekazać go generatorowi kodu, aby zbudować typowanego klienta w wybranym języku.
W Postman zachowaj klucz w uprzednio skonfigurowanym uwierzytelnianiu API Key i ustaw zmienną apiKey. Dokumentacja ostrzega, że wklejenie klucza jako tokenu Bearer zwróci kod 401. Tokeny Bearer są przeznaczone dla partnerów OAuth.
Indeks czytelny maszynowo
Dokumentacja publikuje również indeks w formacie zwykłego tekstu pod adresem docs.apollo.io/llms.txt. Zawiera on każdą stronę jako link Markdown. Narzędzia AI do programowania mogą go odczytać, aby znaleźć właściwą stronę endpointu bez przeszukiwania całej witryny.
Jak uzyskać klucz API Apollo.io
Klucz API Apollo.io tworzy się w aplikacji, a nie w witrynie dokumentacji. Ścieżka to Settings, następnie Integrations, a potem API Keys. Mogą to zrobić tylko administratorzy oraz użytkownicy, których profil uprawnień obejmuje klucze.
Oto jak krok po kroku uzyskać dostęp do klucza API Apollo.io:
- Otwórz Apollo.io i kliknij Settings > Integrations > API Keys. Panel deweloperski pod adresem developer.apollo.io wyświetla tę samą stronę.
- Kliknij Create new key.
- Wprowadź nazwę i opis.
- Zaznacz każdy endpoint, który może wywoływać klucz, albo włącz opcję Set as master key.
- Kliknij Create API key.
- Kliknij Copy i wklej klucz w bezpiecznym miejscu.

Zrzut ekranu: okno dialogowe Create new API key w portalu deweloperskim Apollo.io, pochodzące z dokumentacji Apollo.io.
Apollo.io wyświetla pełny klucz na końcu. Skopiuj go wtedy. Jeśli go utracisz, wygeneruj go ponownie z panelu.
Gdzie znaleźć istniejący klucz API Apollo.io
Jeśli chcesz znaleźć utworzony wcześniej klucz API Apollo.io, wróć do panelu deweloperskiego i otwórz API keys. Każdy utworzony przez Ciebie klucz znajduje się na tej liście. Pasek boczny portalu zawiera także strony Quick Start, Usage i Subscription. W tym samym pasku bocznym znajduje się strona OAuth Registration dla partnerów.
Apollo.io pozwala zrobić dwie rzeczy z istniejącym kluczem. Opcja Regenerate tworzy nowy sekret i kopiuje go. Opcja Delete trwale usuwa klucz. Traktuj obie czynności jak przejście przez drzwi bez powrotu, ponieważ każdy skrypt korzystający ze starego klucza przestanie działać.
Klucz główny czy ograniczony zakresem?
Ten wybór ma większe znaczenie niż jakikolwiek inny podczas tworzenia klucza API Apollo.io.
| Typ | Do czego uzyskuje dostęp | Do czego go używać |
|---|---|---|
| Klucz ograniczony zakresem (domyślny) | Tylko do zaznaczonych endpointów | Większość integracji |
| Klucz główny | Do każdego endpointu | Endpointy, które tego wymagają, oraz serwer MCP używający klucza |
Klucz ograniczony zakresem, który wywołuje niezaznaczony endpoint, zwraca błąd 403. Niektóre endpointy, takie jak lista użytkowników obszaru roboczego, działają tylko z kluczem głównym. Apollo.io zaleca traktowanie klucza głównego jak hasła. Może on wykonać dowolną czynność API dozwoloną dla Twojego konta.
Jako który użytkownik działa klucz?
Klucz API Apollo.io identyfikuje obszar roboczy, a nie konkretną osobę. Apollo.io nie może określić, który członek zespołu go użył. Każde żądanie działa jako najdłużej aktywny administrator obszaru roboczego, a ten użytkownik staje się właścicielem wszystkiego, co tworzy wywołanie. Aby sprawdzić, kto to jest, wywołaj endpoint pobierający profil bieżącego użytkownika — nie zużywa on kredytów.
Zaskakuje to zespoły, które tworzą klucz z konta o ograniczonych uprawnieniach. Klucz nie ogranicza zakresu, do którego kod może uzyskać dostęp.
Kontrola stanu API Apollo.io
Najszybszym sposobem przetestowania nowego klucza jest pojedyncze wywołanie kontroli stanu. To jedno żądanie GET do auth/health, które nie zużywa kredytów.
curl --request GET \ --url 'https://api.apollo.io/api/v1/auth/health' \ --header 'Content-Type: application/json' \ --header 'x-api-key: YOUR_API_KEY'
Jeśli wszystko jest prawidłowo skonfigurowane, kontrola stanu API Apollo.io zwraca dwie wartości:
{ "healthy": true, "is_logged_in": true }
Gdy obie wartości to true, klucz działa. Jeśli którakolwiek ma wartość false, sprawdź, czy po kluczu nie ma zbędnych spacji lub znaków końca linii, a następnie wyślij żądanie ponownie. W Postman ustaw typ autoryzacji na No Auth i zamiast tego dodaj klucz jako nagłówek.
Czy API Apollo.io nie działa?
Osoby wyszukujące to hasło czasami chcą uzyskać inną odpowiedź. Chcą wiedzieć, czy sama usługa jest niedostępna. Wywołanie auth/health sprawdza Twój klucz i logowanie, a nie całą platformę. W przypadku awarii Apollo.io prowadzi stronę statusu pod adresem status.apollo.io.
Odpowiedź 429 z kodem USAGE.RATE_LIMIT.PLATFORM_RATE_LIMIT oznacza, że platforma odrzuca ruch z powodu wysokiego obciążenia w całym systemie. Nie ma to nic wspólnego z Twoim planem. Dokumentacja zaleca odczekać 60 sekund i ponowić próbę.
Główne grupy endpointów w API Apollo.io
Dokumentacja wymienia dziesiątki endpointów. Dzielą się one na sześć grup.
| Grupa | Zakres | Przykłady |
|---|---|---|
| Wyszukiwanie i wzbogacanie | Znajdowanie osób i firm, uzupełnianie rekordów | Wyszukiwanie w People API, wzbogacanie danych osób, wyszukiwanie organizacji |
| Zarządzanie rekordami | Konta, kontakty, transakcje, listy, notatki | Tworzenie kontaktu, zbiorcza aktualizacja kont, dodawanie rekordów do listy |
| Kontakt z potencjalnymi klientami | Sekwencje, e-maile, połączenia, zadania, rozmowy | Dodawanie kontaktów do sekwencji, natychmiastowe wysyłanie e-maila |
| Asystent AI | Przekazywanie zadania wbudowanemu asystentowi | Uruchamianie zadania asystenta, sprawdzanie statusu zadania asystenta |
| Workspace | Użytkownicy, skrzynki pocztowe, pola niestandardowe | Pobieranie listy użytkowników, tworzenie pola niestandardowego |
| Analityka i wykorzystanie | Raporty, statystyki wykorzystania, wyniki webhooków | Wysyłanie zapytań do raportu analitycznego, wyświetlanie statystyk wykorzystania |
Zarządzanie rekordami, sekwencje i większość wywołań Workspace wykorzystują 0 kredytów. Koszt dotyczy wyszukiwania i wzbogacania danych, które omawiamy poniżej.
Wyszukiwanie to nie wzbogacanie
Ten podział często dezorientuje nowych użytkowników. Wyszukiwanie w bazie danych Apollo.io osób zwraca profile. Wyniki nie zawierają adresów e-mail ani numerów telefonów. Aby je uzyskać, potrzebujesz drugiego wywołania — do endpointu wzbogacania. Wyszukiwanie własnych zapisanych kontaktów odbywa się za pomocą innego zestawu endpointów, które podlegają innym limitom.
Dokumentacja wyszukiwania osób w API Apollo.io
Dokumentacja wyszukiwania osób w API Apollo.io obejmuje jeden endpoint POST: /mixed_people/api_search. Apollo.io opisuje osoby jako nowych potencjalnych klientów, których nie zapisano jeszcze jako kontaktów.
curl --request POST \ --url 'https://api.apollo.io/api/v1/mixed_people/api_search?person_titles[]=sales%20director&person_locations[]=california&per_page=10' \ --header 'accept: application/json' \ --header 'x-api-key: YOUR_API_KEY'
Parametry umieszcza się w ciągu zapytania. Możesz zawęzić wyszukiwanie według:
- Stanowisk:
person_titles[], a takżeperson_not_titles[], aby wykluczyć niektóre z nich. - Poziomu stanowiska:
person_seniorities[]. - Lokalizacji:
person_locations[]określa miejsce zamieszkania osób, aorganization_locations[]siedzibę główną firmy. - Wielkości i przychodów firmy:
organization_num_employees_ranges[]orazrevenue_range[min]. - Technologii: filtrów dotyczących ponad 1500 technologii używanych przez firmę.
- Sygnałów rekrutacyjnych:
q_organization_job_titles[]oraz liczby ofert pracy. - Statusu adresu e-mail:
contact_email_status[], z wartościami takimi jak verified, unverified, likely to engage i unavailable. - Stronicowania:
pageorazper_page.
Endpoint wyszukiwania osób wykorzystuje 0 kredytów. Zwraca maksymalnie 100 rekordów na stronę. Ma również limit wyświetlania wynoszący 50 000 rekordów, czyli 500 stron. Dodaj filtry, aby się w nim zmieścić.
Co zwraca wyszukiwanie osób w API Apollo.io
Odpowiedź wyszukiwania osób zawiera liczbę total_entries oraz listę people. Nie zawiera adresów e-mail ani numerów telefonów. Aby uzyskać dane kontaktowe, przekaż każdy wynik do endpointu wzbogacania danych.
Wyszukiwanie ma własne limity, wymienione w sekcji dotyczącej limitów zapytań poniżej.
Jeśli wyszukujesz według contact_email_status[], pamiętaj, skąd pochodzi ta wartość. Opisuje ona własny zapis Apollo.io dotyczący adresu. Nie jest to bieżący test skrzynki pocztowej.
Jak szybciej czytać dokumentację wyszukiwania osób w API Apollo.io
Zacznij od pola z najważniejszymi informacjami o endpointcie. Sprawdź wiersze dotyczące wykorzystania kredytów i dostępu z bezpłatnego konta. Następnie przejrzyj listę parametrów pod kątem potrzebnych filtrów. Na koniec wykonaj jedno małe zapytanie z per_page=10, zanim zaczniesz przeglądać tysiące wyników.
Wzbogacaj dane osób za pomocą API Apollo.io
Wzbogacanie odświeża rekordy, które już posiadasz. Apollo.io oferuje dwa endpointy dla osób:
- Wzbogacanie danych osoby:
POST /people/match, jedna osoba na wywołanie. - Masowe wzbogacanie danych osób: do 10 osób w jednym żądaniu.
Apollo.io potrzebuje wystarczającej ilości danych, aby dopasować właściwą osobę. Sam adres e-mail wystarczy. Wystarczy również imię i nazwisko wraz z domeną firmy. Endpoint akceptuje także URL LinkedIn, nazwę organizacji lub identyfikator osoby w Apollo.io. Jeśli wyślesz tylko imię i nazwisko, możesz otrzymać odpowiedź 200, która nie zawiera żadnych wzbogaconych danych.
Sprawdzaj match_confidence w każdej odpowiedzi. Przyjmuje ono wartość high, medium, low lub none.
curl --request POST \ --url 'https://api.apollo.io/api/v1/people/match?email=mark%40sumware.com' \ --header 'accept: application/json' \ --header 'x-api-key: YOUR_API_KEY'
Odpowiedź zawiera stanowisko osoby, historię zatrudnienia, dane firmy oraz email_status, na przykład verified. Ten status jest własną etykietą Apollo.io. Nasza kontrola opisana w dalszej części tego przewodnika sprawdza sam adres.
Numery telefonów, adresy prywatne i waterfall
Trzy opcjonalne przełączniki zmieniają zakres otrzymywanych danych:
reveal_personal_emails=truedodaje prywatne adresy. Apollo.io nie ujawni ich w przypadku osób z regionów objętych GDPR.reveal_phone_number=truedodaje wszystkie numery telefonów, w tym numery komórkowe. Wymaga to parametruwebhook_url. Apollo.io sprawdza numery asynchronicznie i wysyła je do Twojego webhooka, co może potrwać kilka minut.run_waterfall_emailirun_waterfall_phonenajpierw przeszukują Apollo.io, a następnie skonfigurowanych zewnętrznych dostawców danych. Końcowe wyniki również są dostarczane przez webhook.
Unikaj podwójnych opłat
Jeśli później ponownie wzbogacisz dane tej samej osoby, możesz ponownie wydać kredyty na te same dane. Apollo.io sugeruje przekształcanie wzbogaconych osób w kontakty. Kontakt należy do Twojej organizacji, więc jego dane pozostają dostępne.
Limity szybkości API Apollo.io
Limity szybkości dotyczą zespołu, a nie klucza ani użytkownika. Dotyczą również poszczególnych endpointów i obowiązują jednocześnie w trzech przedziałach: minucie, godzinie i dniu. Musisz mieścić się w każdym obowiązującym przedziale.
| Limit | Free | Basic | Professional | Organization |
|---|---|---|---|---|
| Żądania na minutę | 50 | 200 | 200 | 200 |
| Żądania na godzinę | 200 | 400 | 400 | 600 |
| Żądania na dzień | 600 | 2,000 | 2,000 | 6,000 |
Ta tabela przedstawia wartości domyślne. Endpointy wyszukiwania i wzbogacania danych mają wyższe limity w płatnych planach:
- Endpointy wzbogacania danych: 1,000 żądań na minutę w płatnych planach, bez limitu godzinnego ani dziennego. Konta Free mają limit 50 na minutę, a w przypadku endpointów zbiorczych — 20.
- Endpointy wyszukiwania: 200 na minutę, 6,000 na godzinę i 50,000 na dzień w płatnych planach.
- Niższe limity: raport analityczny zapytań umożliwia 5 żądań na godzinę.
Dokumentacja Apollo.io zwraca uwagę, że wysoki limit wzbogacania danych nie oznacza zgody na wysyłanie nieograniczonej liczby wywołań. Saldo kredytów nadal określa, ile danych możesz wzbogacić.

Zrzut ekranu: strona Usage w portalu deweloperskim Apollo.io z dziennymi i godzinowymi limitami dla endpointów wzbogacania danych, na podstawie dokumentacji Apollo.io.
Nagłówki odpowiedzi i błąd 429
Apollo.io dodaje nagłówki do uwierzytelnionych wywołań. Pokazują one limit, dotychczasowe wykorzystanie oraz liczbę żądań pozostałych w każdym przedziale:
x-rate-limit-minute,x-rate-limit-hourlyix-rate-limit-24-hourx-minute-usage,x-hourly-usageix-24-hour-usagex-minute-requests-left,x-hourly-requests-leftix-24-hour-requests-leftretry-after, wysyłany wraz z kodem429, podaje liczbę sekund do zresetowania przedziału
Po przekroczeniu limitu otrzymasz kod 429. Odczytaj retry-after i poczekaj. Przedział rozpoczyna się przy pierwszym żądaniu i nie jest powiązany z zegarem. Treść błędu zawiera obiekt error_details. Jego code ma wartość USAGE.RATE_LIMIT.API_RATE_LIMIT_EXCEEDED, gdy przekroczysz własny limit.
Aby odczytać bieżące limity zespołu w kodzie, wywołaj endpoint view API usage stats. Pojedyncze wywołanie może obejmować maksymalnie 74 ścieżki endpointów i nie zużywa żadnych kredytów.
Kredyty API Apollo.io: Co kosztuje
Wiele wywołań nic nie kosztuje. Apollo.io podaje, że punkty końcowe tworzące, aktualizujące, wyświetlające lub zarządzające rekordami zużywają 0 kredytów. Kredyty są naliczane za wzbogacanie danych, wyszukiwanie organizacji, wyszukiwanie wiadomości i punkty końcowe AI insight — wyłącznie wtedy, gdy zwracają dane spełniające kryteria.
| Punkt końcowy | Koszt w kredytach |
|---|---|
| Wzbogacanie danych osób | Od 1 do 9 za osobę: 1 za dane demograficzne lub adres e-mail oraz dodatkowe 8, jeśli zostanie zwrócony numer telefonu komórkowego |
| Masowe wzbogacanie danych osób | Ta sama zasada, do 10 osób na żądanie |
| Wzbogacanie danych organizacji | 1 za organizację |
| Wyszukiwanie organizacji | 1 za stronę, maksymalnie 100 wyników na stronę |
| Wyszukiwanie artykułów prasowych | 1 za stronę, maksymalnie 25 wyników na stronę |
| Oferty pracy organizacji | 1 za stronę |
| Pobieranie kompletnych informacji o osobie | 1 za osobę |
| Zadanie asystenta | Zmienna wartość, ustalana przez działania podejmowane przez asystenta |
Wyszukiwanie osób jest bezpłatne, dlatego rozsądny proces najpierw wyszukuje osoby, a następnie wzbogaca dane tylko dla najlepszych dopasowań. Przechodzenie między stronami punktu końcowego zużywającego kredyty powoduje naliczanie kredytów za każdą stronę. Apollo.io zaleca przeprowadzenie małego testu i sprawdzenie wykorzystania przed zwiększeniem skali.
Wzbogacanie kaskadowe może kosztować więcej. Kaskadowe wyszukiwanie adresów e-mail zwykle zużywa od 1 do 4 kredytów, a w niektórych konfiguracjach 20 lub więcej. Kaskadowe wyszukiwanie numerów telefonu zwykle zużywa od 8 do 25 kredytów, a w niektórych przypadkach 45 lub więcej.
Aby śledzić wydatki, otwórz w aplikacji Ustawienia > Rozliczenia i kredyty > Wykorzystanie kredytów. Karta Wykorzystanie w panelu deweloperskim pokazuje liczbę kredytów na telefon i e-mail wykorzystanych w bieżącym cyklu rozliczeniowym. Starsze plany mogą się różnić, dlatego sprawdź stronę Informacje o kredytach dla swojego obszaru roboczego.
Błędy i kody statusu
Większość punktów końcowych API Apollo.io korzysta z krótkiej listy kodów statusu:
| Kod | Znaczenie | Częsta przyczyna |
|---|---|---|
401 | Brak autoryzacji | Brak klucza, nieprawidłowy klucz lub klucz z nieaktywnego konta |
403 | Zabronione | Plan nie zapewnia dostępu do API lub klucz z ograniczonym zakresem nie obejmuje tego punktu końcowego |
404 | Nie znaleziono | Rekord nie istnieje lub nie jest dla Ciebie widoczny |
422 | Nie można przetworzyć | Nieprawidłowy lub brakujący parametr |
429 | Zbyt wiele żądań | Przekroczono limit zapytań |
500 | Błąd serwera | Błąd po stronie Apollo.io, spróbuj ponownie |
Apollo.io przenosi błędy do jednego formatu. Gdy punkt końcowy został już przeniesiony, odpowiedź zawiera obiekt error_details ze stałymi polami code, message, suggestions i context. Twórz rozgałęzienia w kodzie na podstawie error_details.code, nigdy na podstawie treści komunikatu. Apollo.io planuje usunąć stare pola błędów na poziomie głównym 16 lutego 2027 roku, dlatego już teraz korzystaj z nowego obiektu.
Serwer MCP Apollo.io
MCP to standard, który pozwala narzędziom AI wywoływać zewnętrzne usługi. Serwer MCP Apollo.io łączy Claude, ChatGPT i podobnych klientów z Twoim kontem Apollo.io. Możesz wtedy zapytać prostym językiem: znajdź liderów marketingu na poziomie VP w firmach SaaS albo wzbogacaj dane tych dziesięciu potencjalnych klientów.

Zrzut ekranu: strona Apollo.io MCP w dokumentacji dla deweloperów, październik 2026 r.
Trzy sposoby połączenia
| Sposób | Jak działa |
|---|---|
| Konektory AI | Wbudowane integracje w ChatGPT, Claude, Perplexity, Replit i Cursor. Bez konfiguracji serwera. |
| Wtyczki programistyczne | Wtyczki pierwszej strony do narzędzi takich jak Codex. |
| Samodzielny serwer MCP | Skieruj dowolnego klienta MCP obsługującego zdalne serwery na jeden URL. |
Ustawienia samodzielnego serwera są krótkie:
| Ustawienie | Wartość |
|---|---|
| Endpoint | https://mcp.apollo.io/mcp |
| Transport | Streamable HTTP |
| Logowanie | OAuth 2.0 |
| Instalacja lokalna | Niepotrzebna |
| Klucz API | Niepotrzebny, chyba że klient nie ma przeglądarki |
W Claude Code jedna komenda dodaje serwer. Uruchom ją, następnie wpisz /mcp i dokończ logowanie OAuth:
claude mcp add --transport http apollo https://mcp.apollo.io/mcp
Jeśli zarządzasz kilkoma obszarami roboczymi, dodaj ten sam URL pod inną nazwą dla każdego z nich. Zaloguj się osobno do każdego połączenia.
Serwery bez przeglądarki
OAuth wymaga okna przeglądarki. Zadanie cron lub potok CI go nie ma. W takich przypadkach serwer akceptuje klucz API przesłany jako X-Api-Key. Klucz musi być kluczem głównym. Klucz z ograniczonym zakresem uprawnień zwróci 403 z kodem API_INACCESSIBLE, ponieważ serwer MCP nie jest jednym z endpointów, które można zaznaczyć.
Przechowuj ten klucz jak każdy produkcyjny sekret. Działa on jako administrator obszaru roboczego i zużywa jego kredyty. Nowe narzędzia MCP od razu uzyskują dostęp do klucza głównego, ale klient może przechowywać buforowaną listę narzędzi. Połącz się ponownie i wywołaj tools/list, aby ją odświeżyć.
Co potrafi serwer MCP Apollo.io
Lista narzędzi obejmuje wyszukiwanie i prospecting, wzbogacanie danych osób i firm, kontakty, listy, sekwencje, jednorazowe wiadomości e-mail, zadania, sprawdzanie domen e-mail oraz analitykę. Działania związane ze wzbogacaniem danych zużywają kredyty. Większość pozostałych działań nie zużywa żadnych. Apollo.io ostrzega, że wyszukiwanie osób nie zwraca adresów e-mail ani numerów telefonów, więc asystent musi wykonać dla nich etap wzbogacania danych.
Praktyczne ograniczenia opisane w dokumentacji:
- Połączenie nie wiąże się z dodatkową opłatą. Obowiązują Twój plan, uprawnienia i kredyty.
- Działania destrukcyjne, takie jak masowe usuwanie, nie są obsługiwane.
- Serwer przestrzega Twoich uprawnień. W przypadku OAuth działa jako zalogowany użytkownik.
- Apollo.io MCP stosuje osobne limity zapytań i nie zwraca nagłówków limitów zapytań.
- Apollo.io zabrania trenowania modeli AI na swoich danych MCP, dlatego najpierw wyłącz trenowanie w swoim kliencie AI.
Apollo.io zaleca ustawienie działań zużywających kredyty jako wymagających zatwierdzenia, aby rozmowny asystent nie mógł samodzielnie zużyć wszystkich kredytów.
Inne sposoby korzystania z API Apollo.io
- CLI Apollo.io. Narzędzie wiersza poleceń z dostępem do pełnego API. Zainstaluj je za pomocą Homebrew, gotowego pliku binarnego lub ze źródła. Korzysta z OAuth, więc nie wymaga klucza.
- OAuth 2.0. Partnerzy używają go do wywoływania API dla wspólnych klientów, a dokumentacja zawiera aplikację marketplace do gotowych integracji.
- Rozszerzenie Chrome. Jeśli wolisz klikać zamiast programować, przeczytaj nasz przewodnik po rozszerzeniu Apollo do Chrome.
Sprawdzaj adresy z API Apollo.io, zanim wyślesz wiadomość
Niezależnie od wybranej ścieżki dane mają jeden słaby punkt. Pochodzą z bazy danych. Ludzie zmieniają pracę, a firmy przenoszą się do nowych domen. Pole email_status to własna etykieta Apollo.io, a nie wynik świeżego testu. Zimna wiadomość wysłana na nieaktywny adres kończy się odbiciem, a odbicia szkodzą reputacji nadawcy.
Dlatego dodaj kontrolę między wzbogacaniem danych a uruchomieniem sekwencji. BillionVerify testuje każdy adres bez wysyłania wiadomości. Sprawdza składnię, domenę, rekordy MX oraz, jeśli o to poprosisz, skrzynkę pocztową przez SMTP. Wykrywa adresy jednorazowe i funkcyjne. Raportuje catch-all jako osobny wynik, zamiast uznawać go za prawidłowy. Nieznane wyniki nic nie kosztują, a ponowne sprawdzenie w ciągu 24 godzin jest bezpłatne. Zanim podłączysz API, możesz ręcznie sprawdzić, czy adres e-mail istnieje, korzystając z bezpłatnego narzędzia internetowego.

BillionVerify zwraca dla każdego adresu status, informację o dostarczalności i przyczynę.
Mały pipeline
Prosty pipeline składa się z czterech kroków:
- Wykonaj bezpłatne wyszukiwanie osób przez API.
- Wzbogać dane tylko dla najlepszych dopasowań.
- Wyślij każdy adres do REST API BillionVerify.
- Dodaj do sekwencji tylko adresy z możliwością dostarczenia.
Wywołanie BillionVerify to jedno żądanie POST. Wyślij klucz w nagłówku BV-API-KEY i ustaw check_smtp na true, aby przeprowadzić test aktywnej skrzynki:
curl -X POST https://api.billionverify.com/v1/verify/single \
-H "BV-API-KEY: YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"email":"mark@sumware.com","check_smtp":true}'
Odpowiedź zawiera status, is_deliverable, is_catchall, is_role, is_disposable oraz reason. Aby sprawdzić do 50 adresów w jednym wywołaniu, użyj ścieżki zbiorczej. W przypadku całego eksportu prześlij plik CSV, TXT lub XLSX i pobierz wyniki później. Pełna dokumentacja znajduje się w dokumentacji BillionVerify.
Weryfikacja z poziomu klienta AI
Jeśli Apollo.io jest już połączone z klientem AI za pomocą konfiguracji MCP, dodaj obok niego hostowany serwer MCP BillionVerify. Znajduje się pod adresem https://mcp.billionverify.com/mcp i wykorzystuje OAuth do logowania. Twój asystent może wtedy wzbogacić dane potencjalnego klienta przez Apollo.io i sprawdzić adres w jednej rozmowie. Określ swoją politykę, na przykład które statusy akceptować i co robić z adresami catch-all.
Inne kontrole
- Nasza strona dotycząca weryfikacji e-maili Apollo opisuje proces eksportu.
- Podejrzany kontakt możesz sprawdzić za pomocą naszego bezpłatnego narzędzia do odwrotnego wyszukiwania adresu e-mail, które pokazuje, jakie publiczne informacje są powiązane z adresem.
- Numery telefonów zwrócone przez webhook również warto przetestować. Nasz bezpłatny walidator numerów telefonów pokazuje, czy numer jest prawidłowy w danym kraju i jakiego jest typu.
BillionVerify przyznaje 20 bezpłatnych kredytów każdego dnia korzystania z konta, maksymalnie 600 miesięcznie. Nigdy nie wygasają i nie potrzebujesz karty kredytowej.
Wskazówki dotyczące tworzenia aplikacji z wykorzystaniem API Apollo.io
- Zacznij od jednego, ograniczonego klucza na integrację. Jeśli jeden wycieknie, unieważnisz tylko ten klucz.
- Najpierw uruchom kontrolę stanu. Wykluczy ona problemy z kluczem, zanim zaczniesz debugować kod.
- Przeczytaj sekcję „Najważniejsze informacje o endpointach”. Dokumentacja wyszukiwania osób w API Apollo.io z góry pokazuje koszt w kredytach.
- Wyszukuj, zanim wzbogacisz dane. Wyszukiwanie jest bezpłatne, a wzbogacanie danych już nie.
- Testuj z
per_page=10. Małe partie pokazują koszty kredytów, zanim staną się problemem. - Przestrzegaj wartości
retry-after. Wielokrotne wywoływanie ograniczonego endpointu tylko wydłuża oczekiwanie. - Czytaj
error_details.code. Treść komunikatu może się zmienić bez uprzedzenia. - Weryfikuj przed wysłaniem. Kredyt wydany na adres, na który wiadomość odbije się, to podwójna strata.
FAQ
Czy Apollo.io ma API?
Tak, Apollo.io ma API REST. Umożliwia wyszukiwanie osób i firm, wzbogacanie kontaktów oraz aktualizowanie kont, transakcji i sekwencji. Podstawowy dostęp jest dostępny w każdym planie. Twój plan określa, z których endpointów możesz korzystać, jak szybko oraz ile kosztuje każde wywołanie.
Jak uzyskać klucz API Apollo.io?
Klucz Apollo.io znajdziesz w sekcji Integracje w Ustawieniach: otwórz Klucze API i wybierz Utwórz nowy klucz. Nadaj mu nazwę, zaznacz endpointy, z których może korzystać, i potwierdź, a następnie od razu skopiuj sekret. Może to zrobić administrator lub użytkownik z odpowiednim profilem uprawnień.
Gdzie znajdę mój klucz API Apollo.io?
Lista kluczy API Apollo.io znajduje się na stronie Klucze API, do której przejdziesz z aplikacji lub panelu deweloperskiego. Pełny sekret jest wyświetlany podczas tworzenia klucza. Utrata sekretu oznacza konieczność wygenerowania klucza ponownie, co utworzy nowy.
Czy API Apollo.io jest bezpłatne?
Wywołania API Apollo.io, które tworzą, wyświetlają lub aktualizują rekordy, są bezpłatne, podobnie jak wyszukiwanie osób. Wzbogacanie danych i niektóre endpointy wyszukiwania pobierają kredyty, gdy zwracają dane. Konta bezpłatne mogą korzystać z API w ramach limitów bezpłatnego planu, ale niektóre endpointy wymagają służbowego adresu e-mail.
Jaki jest limit zapytań API Apollo.io?
W płatnym planie większość endpointów API Apollo.io obsługuje 200 wywołań na minutę, a limity godzinowe i dzienne różnią się w zależności od planu. Bezpłatny plan obejmuje 50 wywołań na minutę, 200 na godzinę i 600 dziennie. Limity dotyczą zespołu i endpointu, a odpowiedź 429 oznacza ich przekroczenie.
Jak przetestować kontrolę stanu API Apollo.io?
Kontrola stanu Apollo.io to żądanie GET do ścieżki auth/health z ustawionym nagłówkiem klucza. Odpowiedź healthy: true i is_logged_in: true oznacza, że klucz działa. Nie są pobierane żadne kredyty.
Czy wyszukiwanie osób przez API Apollo.io zwraca adresy e-mail?
Nie, endpoint wyszukiwania osób Apollo.io zwraca wyłącznie profile, bez adresów e-mail i numerów telefonów. Uruchom endpoint wzbogacania osób lub zbiorczego wzbogacania osób na wynikach, aby uzyskać dane kontaktowe, co wiąże się z kosztem kredytów.
Gdzie znajduje się dokumentacja API Apollo.io?
Dokumentacja API Apollo.io znajduje się na stronie docs.apollo.io. Każdy endpoint ma własną stronę z parametrami, panelem testowym i przykładową odpowiedzią. Możesz także pobrać plik OpenAPI i zaimportować go do Postman.
Czym jest serwer MCP Apollo.io?
Serwer MCP Apollo.io łączy klientów AI z Twoim obszarem roboczym za pośrednictwem protokołu Model Context Protocol. Jego URL to https://mcp.apollo.io/mcp, korzysta ze Streamable HTTP i OAuth oraz nie wymaga lokalnej instalacji. Nadal obowiązują Twój plan, uprawnienia i kredyty.
Jaki jest najlepszy serwer MCP dla Apollo.io?
Apollo.io publikuje jeden oficjalny serwer MCP i to jego opisuje dokumentacja. Nie testowaliśmy opcji firm trzecich. Wybierz oficjalny serwer, jeśli chcesz korzystać z tych samych uprawnień i zasad dotyczących kredytów co w aplikacji.
Czy należy weryfikować adresy e-mail pochodzące z API Apollo.io?
Tak, sprawdź każdy adres e-mail z API Apollo.io przed rozpoczęciem kampanii. Pole email_status odzwierciedla własne dane Apollo.io, a ludzie zmieniają pracę. Szybkie sprawdzenie za pomocą API BillionVerify usuwa nieaktywne adresy i chroni reputację nadawcy.
Obejrzyj wideo: Jak zweryfikować numer telefonu: darmowy walidator numerów
Obejrzyj wideo: Jak zweryfikować e-maile z Apollo przed wysyłką
