Developer API · v1

The people-research API for AI agents and apps.

DeepSearch resolves a person from a name, phone, email, or username and returns a sourced view of their public online footprint — social accounts, contact details, work history, relatives, and web mentions. Build full dossiers and ask follow-up questions, all over a simple JSON API designed to be called by autonomous agents.

Get API keys Read the docs OpenAPI spec

Built to be called by agents

Point your agent or framework at the machine-readable contract and it can discover and call every endpoint. Authenticate with a bearer key; responses stream as Server-Sent Events or return a single JSON object.

Hosted MCP serverStreamable HTTP

Add DeepSearch to Claude, Cursor, or any MCP client and call it as tools — search, dossier, and chat — with the user's API key.

https://deepsearch.app/api/mcp

OpenAPI 3.1 specThe full machine-readable contract. Load it to call every endpoint.llms.txtA plain-language brief for LLMs and AI search engines.Agent manifestai-plugin.json pointing agents at the OpenAPI document.

Billing is user-managed. DeepSearch doesn't take payment from agents directly. When a call needs an account or credits, the API replies with a sign-up URL to hand to your user — they subscribe once on the web, and your agent then calls with their key. A 401 or 402 response carries the exact message and link to relay.

Endpoints

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.

Quickstart

Create a key in the developer portal, then resolve your first person.

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

Authentication

Send your key as a bearer token: Authorization: Bearer dsk_…. Keys are created and revoked in the portal.

Pricing

Usage runs on your wallet — 10 requests per 7-day window, then 1 coin per metered request. Cached dossiers are free.

Start building

Create an API key and make your first request in minutes.

Get API keys Read the docs