Ricerca e filtraggio tramite API

È possibile effettuare ricerche nei dati di LastDatabase a livello programmatico utilizzando l'API generica Lead Search o l'API People Search, focalizzata sull'integrazione.

Le due interfacce di ricerca sono pensate per flussi di lavoro differenti. La Ricerca generale di lead espone diverse tipologie di dati. La Ricerca persone è progettata per la ricerca di contatti B2B, dove l'indirizzo email rimane nascosto fino a quando non viene richiesta un'operazione di sblocco separata.

Ricerca generale di lead

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

Autenticati con la tua chiave API Bearer e scegli l'inventario dei dati tramite type parametro di query.

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"

Tipi di dati supportati

Tipo	dataset	Esempio
`email`	Dati di posta elettronica e contatti aziendali B2B.	`?type=email`
`consumer_email`	Registri delle email dei consumatori.	`?type=consumer_email`
`phone`	Registri dei contatti telefonici.	`?type=phone`
`mixed`	Scorte miste di piombo.	`?type=mixed`
`fax`	Registri dei contatti via fax.	`?type=fax`

Se la richiesta non seleziona uno dei tipi di inventario non e-mail gestiti esplicitamente, l'attuale implementazione della ricerca generale utilizza il percorso di ricerca e-mail B2B.

Filtri di ricerca

L'API generale supporta i seguenti filtri principali, ove applicabili all'inventario dei dati selezionato.

Parametro	Missione	Esempio
`type`	Selezionare l'inventario dei dati.	`email`
`country`	Filtra per paese.	`USA`
`city`	Filtra per città.	`New York`
`industry`	Filtra per settore.	`technology`
`keyword`	Ricerca nei campi di testo supportati.	`CEO`
`limit`	Numero massimo di risultati per la richiesta.	`10`

I campi disponibili nei record variano a seconda del set di dati. Le applicazioni non devono presumere che un record di indirizzo email di un consumatore, un record telefonico, un record misto e un record aziendale B2B abbiano schemi identici.

Risposta alla ricerca generale

Le risposte di successo alla ricerca di lead utilizzano un modello di alto livello comune:

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

Settore	Descrizione
`status`	Indica se la richiesta è stata completata con successo.
`type`	L'inventario dei dati utilizzato per la ricerca.
`count`	Numero di record restituiti in questa risposta.
`data`	Raccolta di record corrispondenti.

Ricerca di personale B2B

GET /api/integrations/v1/people/search

La Ricerca persone è pensata per la scoperta di contatti. Accetta keyword, country, city and industry filtri.

Parametro	Obbligatorio	Convalida
`keyword`	È richiesto almeno un filtro di ricerca	Stringa, massimo 150 caratteri
`country`	È richiesto almeno un filtro di ricerca	Stringa, massimo 100 caratteri
`city`	È richiesto almeno un filtro di ricerca	Stringa, massimo 100 caratteri
`industry`	È richiesto almeno un filtro di ricerca	Stringa, massimo 150 caratteri
`limit`	Nodo	Numero intero da 1 a 50; valore predefinito 25

La richiesta deve contenere almeno un filtro di ricerca non vuoto. L'invio del solo limite senza un criterio di ricerca non supera la convalida.

Esempio

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"

Scoperta mascherata

La ricerca di persone intenzionalmente non espone un indirizzo email completo. I risultati della ricerca restituiscono un indirizzo email mascherato e email_unlocked: false.

A seconda della disponibilità, un risultato di ricerca persone può contenere:

ID record Ultimo database
Nome
Cognome
Indirizzo email mascherato
Stato di sblocco dell'email
Ruolo lavorativo
Anzianità
Azienda
Sito web aziendale
URL di LinkedIn
Industria
Paese
Regione / Stato
Città
Codice postale
Dimensioni dei dipendenti
Reddito
Tecnologia

Schema illustrativo della risposta

{ "status": true, "type": "email", "count": 1, "filters": { "country": "USA", "industry": "technology" }, "data": [ { "id": 26515564, "first_name": "Example", "last_name": "Contact", "email": "e***@example.com", "email_unlocked": false, "job_title": "Executive", "company_name": "Example Company", "industry": "Technology", "country": "USA" } ] }

I valori nell'esempio precedente illustrano la struttura della risposta. I record effettivi e i campi disponibili dipendono dai dati corrispondenti.

Sblocca un contatto B2B

POST /api/integrations/v1/people/unlock

Dopo aver selezionato un risultato di ricerca, invia il suo ID record LastDatabase come lead_id.

curl -X POST \ "https://lastdatabase.com/api/integrations/v1/people/unlock" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -d '{ "lead_id": 26515564 }'

L'ID è obbligatorio, deve essere un numero intero e deve essere almeno pari a 1.

L'endpoint di sblocco delega all'implementazione esistente di sblocco dei contatti di LastDatabase. Tale flusso di lavoro condiviso rimane responsabile della proprietà del cliente, del consumo dell'abbonamento, della disattivazione e dei comportamenti di verifica applicabili.

La ricerca e lo sblocco sono volutamente separati. Non sbloccare automaticamente tutti i risultati della ricerca, a meno che questo comportamento non sia previsto dalla tua applicazione e dalle funzionalità del tuo account.

Limiti di ricerca e paginazione

La ricerca di persone accetta un massimo limit di 50 e il valore predefinito è 25.

L'API di ricerca persone attualmente disponibile restituisce un set di risultati limitato in un'unica risposta. Al momento non pubblica parametri di paginazione, offset o cursore.

Anche la ricerca generale di lead utilizza un limite di risultati. Le applicazioni dovrebbero richiedere solo il numero di record necessari per l'operazione corrente.

I limiti delle richieste API sono separati dal consumo dei record dei lead. Le richieste di ricerca contribuiscono al raggiungimento del limite giornaliero di richieste tecniche della chiave API. Le operazioni che utilizzano il prodotto sono regolate dal relativo limite di utilizzo del prodotto da parte del cliente.

Guida all'implementazione

Utilizzare filtri specifici

Effettua ricerche più precise utilizzando criteri come paese, città, settore o parole chiave, anziché eseguire ripetutamente ricerche generiche.

Sono previsti campi nullable

Non tutti i record contengono tutti gli attributi opzionali. Considera i campi mancanti relativi ad azienda, tecnologia, fatturato, posizione o altri attributi opzionali come una normale condizione dei dati.

Non dedurre dati sbloccati

Un risultato di ricerca persone mascherato deve rimanere mascherato nella tua applicazione finché l'endpoint di sblocco non restituisce correttamente il record sbloccato corrispondente.

Gestire gli errori di convalida

I parametri non validi possono restituire un errore HTTP 422. Correggi la richiesta anziché riprovare immediatamente con lo stesso payload non valido.

Gestire i limiti API

Il codice HTTP 429 indica che la chiave API autenticata ha raggiunto il limite di richieste giornaliere. Evitare cicli di tentativi aggressivi.

Mantieni private le chiavi API

Le richieste di ricerca devono provenire da codice lato server attendibile quando contengono la chiave API di LastDatabase. Consulta la guida all'autenticazione API.

Ultimo aggiornamento: settembre 29, 2026