API do ekstrakcji NIP
ze stron internetowych
Prosty REST API do automatycznego wyciągania i weryfikacji NIP. Integruj z CRM, ERP, systemami compliance lub własnymi aplikacjami.
Prosty w użyciu
// Przykład w JavaScript/Node.js
const response = await fetch('https://www.nipzestrony.pl/api/v1/lookup', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'Authorization': 'Bearer YOUR_API_KEY'
},
body: JSON.stringify({
domains: ['allegro.pl', 'example.com']
})
});
const data = await response.json();
console.log(data);
// Response:
// {
// "results": [
// {
// "domain": "allegro.pl",
// "status": "FOUND_CONFIRMED",
// "nip": "5272525995",
// "companyName": "Allegro.pl sp. z o.o.",
// "address": "ul. Grunwaldzka 182, 60-166 Poznań",
// "vatStatus": "CZYNNY"
// },
// {
// "domain": "example.com",
// "status": "FOREIGN_ENTITY",
// "message": "Firma zagraniczna"
// }
// ]
// }Możliwości API
Batch requests
Do 50 domen w jednym zapytaniu API. Idealne do masowego przetwarzania.
Weryfikacja MF
Każdy NIP automatycznie weryfikowany w Białej Liście VAT Ministerstwa Finansów.
Pełne dane
NIP, nazwa firmy, adres, status VAT, data weryfikacji - wszystko w JSON.
Dokumentacja API
/api/v1/lookupGłówny endpoint do wyszukiwania NIP ze stron internetowych.
Headers
Authorization: Bearer YOUR_API_KEY
Content-Type: application/jsonRequest Body
{
"domains": ["allegro.pl", "example.com"]
}Response
{
"results": [
{
"domain": "allegro.pl",
"status": "FOUND_CONFIRMED",
"nip": "5272525995",
"companyName": "Allegro.pl sp. z o.o.",
"address": "ul. Grunwaldzka 182, 60-166 Poznań",
"vatStatus": "CZYNNY",
"checkedAt": "2024-01-15T10:30:00Z"
}
],
"requestId": "req_abc123",
"creditsUsed": 1,
"creditsRemaining": 499
}Kody statusu wyniku
| Status | Opis |
|---|---|
FOUND_CONFIRMED | NIP znaleziony i zweryfikowany w MF |
FOUND_UNCONFIRMED | NIP znaleziony, weryfikacja MF niedostępna |
FOREIGN_ENTITY | Wykryto firmę zagraniczną (VAT UE lub inne) |
NOT_FOUND | Nie znaleziono NIP na stronie |
ERROR | Błąd przetwarzania (strona niedostępna itp.) |
Cennik API
Dostęp do API wymaga planu Pro
Plan Pro
29 PLN/mies
+ VAT
- 500 zapytań API miesięcznie
- Do 50 domen per request
- Weryfikacja w Białej Liście VAT
- Pełna dokumentacja
- Wsparcie email
Potrzebujesz więcej? Napisz na kontakt@nipzestrony.pl
Przykłady integracji
Python
import requests
response = requests.post(
'https://www.nipzestrony.pl/api/v1/lookup',
headers={'Authorization': 'Bearer KEY'},
json={'domains': ['allegro.pl']}
)
print(response.json())cURL
curl -X POST \
https://www.nipzestrony.pl/api/v1/lookup \
-H "Authorization: Bearer KEY" \
-H "Content-Type: application/json" \
-d '{"domains":["allegro.pl"]}'PHP
$response = Http::withToken('KEY')
->post('https://www.nipzestrony.pl/api/v1/lookup', [
'domains' => ['allegro.pl']
]);
return $response->json();C# / .NET
var client = new HttpClient();
client.DefaultRequestHeaders.Add(
"Authorization", "Bearer KEY");
var response = await client.PostAsJsonAsync(
"https://www.nipzestrony.pl/api/v1/lookup",
new { domains = new[] { "allegro.pl" } });FAQ dla developerów
Jak uzyskać klucz API?
Zarejestruj się, wybierz plan Pro i wygeneruj klucz API w panelu użytkownika. Klucz jest widoczny tylko raz - zapisz go bezpiecznie.
Jakie są limity rate?
Plan Pro: 10 requestów/minutę, do 50 domen per request. Przy przekroczeniu otrzymasz HTTP 429 (Too Many Requests).
Jak długo trwa przetwarzanie?
Typowo 10-60 sekund na domenę (zależnie od wielkości strony). Przy batch requestach domeny przetwarzane są równolegle. Timeout: 300 sekund per request.
Czy wyniki są cache'owane?
Tak, wyniki są cache'owane przez 24 godziny. Powtórne zapytanie o tę samą domenę w ciągu 24h nie zużywa kredytów i zwraca natychmiast.