API sviluppatori · v1

L'API di ricerca persone per agenti AI e applicazioni.

DeepSearch risolve una persona a partire da nome, telefono, email o username e restituisce una vista con fonti del suo footprint pubblico online — account social, dettagli di contatto, storico lavorativo, familiari e menzioni sul web. Costruisci dossier completi e poni domande di follow-up, tutto tramite una semplice API JSON progettata per essere chiamata da agenti autonomi.

Progettata per essere chiamata da agenti

Punta il tuo agente o framework al contratto leggibile da macchina e potrà scoprire e chiamare ogni endpoint. Autenticati con una bearer key; le risposte vengono trasmesse in streaming come Server-Sent Events oppure restituite come un singolo oggetto JSON.

Server MCP hostedStreamable HTTP

Aggiungi DeepSearch a Claude, Cursor o qualsiasi client MCP e chiamalo come tool — search, dossier e chat — con la API key dell'utente.

https://deepsearch.app/api/mcp

La fatturazione è gestita dall'utente. DeepSearch non accetta pagamenti direttamente dagli agenti. Quando una chiamata richiede un account o dei crediti, l'API risponde con un URL di registrazione da passare al tuo utente — l'utente si abbona una sola volta sul web, e il tuo agente potrà poi chiamare l'API con la sua chiave. Una risposta 401 o 402 contiene il messaggio esatto e il link da inoltrare.

Endpoint

POST/api/v1/search
SearchFind people by name, phone, email, or username.
POST/api/v1/dossier
DossierBuild a full public-footprint profile for a person.
POST/api/v1/chat
ChatAsk follow-up questions about a person.
POST/api/v1/reverse-image
Reverse imageFind where an image appears online + visually similar images.
POST/api/v1/entity/search
Entity searchFind companies by name.
POST/api/v1/entity/dossier
Entity profileBuild a full company profile.
POST/api/v1/vin
VIN lookupDecode a vehicle by VIN.

Quickstart

Crea una chiave nel developer portal, poi risolvi la tua prima persona.

curl https://deepsearch.app/api/v1/search \  -H "Authorization: Bearer $DEEPSEARCH_API_KEY" \  -H "Content-Type: application/json" \  -d '{        "query": "Ada Lovelace",        "type": "name",        "format": "json"      }'

Autenticazione

Invia la tua chiave come bearer token: Authorization: Bearer dsk_…. Le chiavi vengono create e revocate nel portal.

Prezzi

L'utilizzo si basa sul tuo wallet — 10 richieste per finestra di 7 giorni, poi 1 coin per richiesta a consumo. I dossier in cache sono gratuiti.

Inizia a sviluppare

Crea una API key ed effettua la tua prima richiesta in pochi minuti.