API pentru dezvoltatori · v1

API-ul de people-research pentru agenți AI și aplicații.

DeepSearch identifică o persoană pe baza unui nume, număr de telefon, e-mail sau username și returnează o imagine documentată a amprentei publice online — conturi sociale, detalii de contact, istoric profesional, rude și mențiuni pe web. Construiește dosare complete și pune întrebări ulterioare, totul printr-un API JSON simplu, conceput pentru a fi apelat de agenți autonomi.

Conceput pentru a fi apelat de agenți

Direcționează-ți agentul sau framework-ul către contractul citibil de mașină, iar acesta poate descoperi și apela fiecare endpoint. Autentifică-te cu o cheie bearer; răspunsurile vin sub formă de Server-Sent Events sau ca un singur obiect JSON.

Server MCP găzduitStreamable HTTP

Adaugă DeepSearch în Claude, Cursor sau orice client MCP și apelează-l ca instrumente (tools) — search, dossier și chat — folosind cheia API a utilizatorului.

https://deepsearch.app/api/mcp

Facturarea este gestionată de utilizator. DeepSearch nu preia plăți direct de la agenți. Când o cerere necesită un cont sau credite, API-ul răspunde cu un URL de înregistrare pe care îl transmiți utilizatorului tău — acesta se abonează o singură dată pe web, iar agentul tău apelează apoi API-ul cu cheia lui. Un răspuns 401 sau 402 conține mesajul exact și link-ul de retransmis.

Endpoint-uri

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.

Ghid rapid

Creează o cheie în portalul pentru dezvoltatori, apoi identifică prima ta persoană.

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"      }'

Autentificare

Trimite cheia ta ca token bearer: Authorization: Bearer dsk_…. Cheile se creează și se revocă din portal.

Prețuri

Utilizarea funcționează pe baza portofelului tău — 10 cereri pe fereastră de 7 zile, apoi 1 monedă pe cerere contorizată. Dosarele salvate în cache sunt gratuite.

Începe să construiești

Creează o cheie API și trimite prima ta cerere în câteva minute.