Documentazione API di LastDatabase

L'API di LastDatabase fornisce accesso programmatico alla ricerca di lead, alla scoperta e allo sblocco di contatti B2B, alla verifica dell'indirizzo email, alla verifica del numero di telefono, alla verifica del numero WhatsApp, alla verifica del numero Telegram, ai crediti dell'account e alle informazioni sull'utilizzo dell'API.

Un'unica chiave API cliente attiva è sufficiente per autenticare i servizi API di LastDatabase supportati. Non è necessaria una chiave API separata per la ricerca di lead, la verifica dell'indirizzo email, la verifica del numero di telefono, la verifica tramite WhatsApp e la verifica tramite Telegram.

La capacità di richieste API è separata dal consumo del prodotto. Il tuo piano API controlla i limiti tecnici delle richieste e la capacità delle chiavi API. I pacchetti di prodotti determinano la quantità di record di lead, i crediti di verifica e i fondi del portafoglio per la verifica dei messaggi.

Quick Start

1. Crea una chiave API

Accedi al tuo account cliente e apri Gestione API. Genera una chiave API per la tua applicazione e memorizzala in modo sicuro sul tuo server.

2. Invia il token Bearer

Autorizzazione: Bearer YOUR_API_KEY Accetta: application/json

3. Eseguire una ricerca non distruttiva

curl -X GET \ "https://lastdatabase.com/api/integrations/v1/people/search?country=USA&industry=technology&limit=5" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Accept: application/json"

La ricerca di persone è un'operazione di individuazione. Gli indirizzi email restituiti da questo endpoint sono mascherati. Utilizza "Sblocco persone" quando desideri sbloccare intenzionalmente un singolo contatto B2B.

Autenticazione

Gli endpoint API protetti utilizzano l'autenticazione HTTP Bearer. Includi la tua chiave API attiva nel Authorization intestazione della richiesta.

Autorizzazione: Portatore YOUR_API_KEY

Le credenziali mancanti restituiscono un errore HTTP 401 Non autorizzato con un token mancante. Anche una chiave API non valida o disabilitata restituisce un errore HTTP 401.

Ogni richiesta autenticata contribuisce al limite giornaliero di richieste associato alla chiave API. Quando la chiave raggiunge il limite giornaliero, l'API restituisce il codice di stato HTTP 429 Too Many Requests.

Consulta la guida completa all'autenticazione API per informazioni su archiviazione delle credenziali, rotazione delle chiavi, limiti di frequenza e procedure di sicurezza in ambiente di produzione.

Directory degli endpoint

API di ricerca dei dati dei lead

L'endpoint generale di ricerca lead supporta più inventari di dati LastDatabase tramite type parametro di query.

GET https://lastdatabase.com/api/leads/search

I criteri di ricerca supportati includono paese, città, settore e parola chiave, ove applicabile. Il numero di risultati è limitato dall'endpoint.

curl -X GET \ "https://lastdatabase.com/api/leads/search?type=email&country=USA&industry=technology&keyword=CEO&limit=10" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Accept: application/json"

Busta di risposta

{ "status": true, "type": "email", "count": 10, "data": [ ... ] }

Migliori data I campi dipendono dal tipo di inventario selezionato. Le applicazioni dovrebbero tollerare campi nullable o non disponibili, anziché presumere che ogni record contenga ogni possibile attributo.

Per istruzioni dettagliate su come filtrare e implementare le funzionalità, consultare la sezione Ricerca e filtraggio tramite API.

Ricerca persone e sblocco API

L'integrazione con l'API People separa la scoperta dal consumo. La ricerca restituisce contatti B2B con indirizzi email mascherati. Lo sblocco è un'operazione separata.

Cerca persone

GET /api/integrations/v1/people/search

Almeno uno di keyword, country, city or industry deve contenere un valore.

curl -X GET \ "https://lastdatabase.com/api/integrations/v1/people/search?country=USA&industry=technology&limit=5" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Accept: application/json"

La risposta può includere ID record, nome, cognome, indirizzo email mascherato, qualifica professionale, anzianità, azienda, sito web aziendale, URL di LinkedIn, settore, paese, stato, città, codice postale, numero di dipendenti, fatturato e tecnologia, laddove tali campi siano disponibili.

Sblocca una persona

POST /api/integrations/v1/people/unlock

{ "lead_id": 26515564 }

lead_id È richiesto un valore numerico, che deve essere un numero intero positivo. Lo sblocco utilizza il flusso di lavoro esistente di sottoscrizione, soppressione e verifica dei clienti di LastDatabase. Prima di decidere quale record sbloccare, è necessario utilizzare la funzione di ricerca per individuare i record.

API di verifica e-mail

POST /api/integrations/v1/email/verify

La richiesta accetta un requisito email valore. Deve essere un indirizzo email RFC sintatticamente valido e non può superare i 254 caratteri.

curl -X POST \ "https://lastdatabase.com/api/integrations/v1/email/verify" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -d '{ "email": "user@example.com" }'

Una risposta efficace include status, type, l'identificativo normalizzato e il risultato della verifica.

Consultare la documentazione di Email Verifier per ulteriori concetti di verifica e interpretazione dei risultati.

API di verifica telefonica

POST /api/integrations/v1/phone/verify

curl -X POST \ "https://lastdatabase.com/api/integrations/v1/phone/verify" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -d '{ "phone": "+8801712345678", "country": "BD", "idempotency_key": "550e8400-e29b-41d4-a716-446655440000" }'

La verifica telefonica utilizza lo stesso sistema di accredito della dashboard del cliente. Il controller API non addebita autonomamente un secondo set di crediti.

L'errore HTTP 402 può essere restituito quando i crediti di verifica sono insufficienti.

Consultare la documentazione di Phone Verificator per ulteriori indicazioni.

API di verifica del numero WhatsApp

POST /api/integrations/v1/whatsapp/verify

La verifica di WhatsApp è un'operazione asincrona di massa. È necessario inviare un array di numeri di telefono e un UUID di richiesta univoco.

Il prezzo attuale per il cliente è di $0.01 per numero fatturabile . L'importo viene bloccato dal portafoglio di messaggistica LastDatabase del cliente al momento della creazione del servizio e finalizzato secondo il flusso di lavoro di verifica.

curl -X POST \ "https://lastdatabase.com/api/integrations/v1/whatsapp/verify" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -d '{ "numbers": [ "+15550000001", "+15550000002" ], "request_uuid": "550e8400-e29b-41d4-a716-446655440001" }'

Risposta accettata

La creazione di un'attività avvenuta con successo restituisce il codice HTTP 202 Accepted . La risposta include il servizio, l'ID dell'attività, l'UUID della richiesta, lo stato dell'attività, il numero totale di attività, il numero di attività fatturabili, il prezzo per attività, l'importo totale e la data e l'ora di creazione.

{ "status": true, "service": "whatsapp", "job": { "id": 123, "request_uuid": "550e8400-e29b-41d4-a716-446655440001", "status": "pending", "total_numbers": 2001, "fatturabili_numbers": 2001, "price_per_number_cents": 1, "total_amount_cents": 2001, "created_at": "2026-09-29T10:00:00+00:00" } }

Per il flusso di lavoro più completo del prodotto, consultare la documentazione di WhatsApp Number Verifier.

API per la verifica del numero Telegram

POST /api/integrations/v1/telegram/verify

La verifica tramite Telegram utilizza lo stesso contratto di invio massivo e la stessa architettura del portafoglio di messaggistica dei clienti della verifica tramite WhatsApp.

{ "numeri": [ "+15550000001", "+15550000002" ], "request_uuid": "550e8400-e29b-41d4-a716-446655440002" }

Si applica lo stesso limite massimo di 10,000 valori inviati. Il minimo di servizio effettivo è di 2,001 numeri univoci validi per paese, e ciascun gruppo di paesi deve soddisfare tale minimo in modo indipendente.

La creazione di un'attività andata a buon fine restituisce HTTP 202 Accepted . Un saldo insufficiente nel portafoglio può restituire HTTP 402.

Consultare la documentazione di Telegram Number Verificator per ulteriori informazioni sul prodotto.

API per crediti e utilizzo

GET /api/integrations/v1/credits

Utilizza questo endpoint per esaminare i record rimanenti relativi agli abbonamenti ai lead e l'utilizzo giornaliero corrente delle richieste associate alla chiave API autenticata.

curl -X GET \ "https://lastdatabase.com/api/integrations/v1/credits" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Accept: application/json"

Struttura di risposta

{ "status": true, "subscription": { "remaining_records": 5000, "has_available_records": true }, "api": { "daily_limit": 10000, "used_today": 125, "remaining_today": 9875 } }

I valori sopra riportati illustrano la forma della risposta. Il tuo account restituisce la quota attuale effettiva e l'utilizzo dell'API.

Limiti API vs fatturazione del prodotto

LastDatabase separa intenzionalmente i limiti tecnici delle richieste API dall'utilizzo commerciale del prodotto.

Piani API attuali

Codici di stato e errori HTTP

Idempotenza e tentativi sicuri

Le operazioni che possono consumare la quantità di prodotto disponibile o creare processi asincroni devono essere riprovate con attenzione.

Verifica del telefono

Fornire un UUID in idempotency_keyQuando si riprova la stessa operazione logica di verifica telefonica, riutilizzare la stessa chiave anziché creare un nuovo UUID per ogni tentativo di connessione di rete.

WhatsApp e Telegram

Fornire un UUID in request_uuidIl servizio di invio dei messaggi utilizza l'UUID della richiesta come parte del suo flusso di lavoro di idempotenza. Riutilizza lo stesso UUID quando tenti di inviare nuovamente la stessa richiesta logica.

Esempi di codice

cURL

curl -X GET \ "https://lastdatabase.com/api/integrations/v1/people/search?country=USA&limit=5" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Accept: application/json"

PHP

$apiKey = getenv('LASTDATABASE_API_KEY'); $ch = curl_init( 'https://lastdatabase.com/api/integrations/v1/people/search' . '?country=USA&limit=5' ); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_HTTPHEADER => [ 'Authorization: Bearer ' . $apiKey, 'Accept: application/json', ], ]); $response = curl_exec($ch); curl_close($ch); $data = json_decode($response, true);

Python

import os import requests api_key = os.environ["LASTDATABASE_API_KEY"] response = requests.get( "https://lastdatabase.com/api/integrations/v1/people/search", params={ "country": "USA", "limit": 5, }, headers={ "Authorization": f"Bearer {api_key}", "Accept": "application/json", }, timeout=30, ) response.raise_for_status() data = response.json()

Node.js

const apiKey = process.env.LASTDATABASE_API_KEY; const url = new URL( "https://lastdatabase.com/api/integrations/v1/people/search" ); url.searchParams.set("country", "USA"); url.searchParams.set("limit", "5"); const response = await fetch(url, { headers: { Authorization: `Bearer ${apiKey}`, Accept: "application/json" } }); const data = await response.json();

Procedure di sicurezza e produzione

• Archivia le chiavi API esclusivamente nei segreti lato server o nelle variabili d'ambiente.
• Non inserire mai le chiavi API nei repository Git.
• Non esporre mai le chiavi API nel codice JavaScript lato browser.
• Non includere mai chiavi API reali in screenshot, ticket o documentazione pubblica.
• Utilizza HTTPS per ogni richiesta API in ambiente di produzione.
• Disattiva le credenziali non più necessarie.
• Quando la separazione operativa risulta utile, è necessario utilizzare chiavi API separate per le applicazioni indipendenti.
• Convalidare i codici di stato HTTP prima di elaborare i corpi delle risposte.
• Utilizzare gli identificatori di idempotenza per le operazioni che li richiedono.

Prima di implementare le integrazioni in produzione, consulta la Guida all'autenticazione , la Conformità , l'Informativa sulla privacy e i Termini di servizio.

Eseguire l'API di LastDatabase in Postman

Esplora la raccolta ufficiale di API di LastDatabase in Postman. Usa Postman per testare l'autenticazione, i parametri e le richieste API supportate prima di integrarle nella tua applicazione.