disburse / docs

Quickstart

disburse turns one plain-English query into a ranked, structured list of the companies and people that fit, over a REST API or straight into your agent via MCP. This page gets you your first result in about a minute.

1. Get an API key

Create a key in the dashboard. Keys look like sk_live_…. Treat it like a password; it authenticates every request and is metered against your plan.

2. Make a request

Every endpoint is a POST under /v1, authenticated with a bearer token. The base URL is your deployment (e.g. https://api.disburse.dev).

bash
curl https://api.disburse.dev/v1/search/people \
  -H "Authorization: Bearer sk_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{"query": "heads of growth at Series B fintechs in Australia", "limit": 5}'

You can also skip the natural-language parser and pass structured filters directly:

bash
curl https://api.disburse.dev/v1/search/companies \
  -H "Authorization: Bearer sk_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{"filters": {"location": {"country": "AU"}, "industry": "software"}, "limit": 5}'

Need a whole list, not a page? Pass count and the server handles pagination, deduplication and quality filtering in one call — the response includes a summary saying exactly what came back and why it stopped:

bash
curl https://api.disburse.dev/v1/search/people \
  -H "Authorization: Bearer sk_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{"query": "founders in Australia", "count": 200}'

3. Read the response

json
{
  "interpreted": { "entity": "person", "filters": { "seniority": "head" }, "limit": 5 },
  "results": [
    { "id": "prs_…", "full_name": "Ada Lovelace", "title": "Head of Growth", "company_domain": "acme.com" }
  ],
  "total": 128,
  "next_cursor": "eyJ…"
}
  • interpreted: how your query was parsed (useful for debugging phrasing).
  • results: the matched records.
  • total: matches for the structured filters (exact on keyword searches; strong_matches counts the rows that clearly match your keywords).
  • next_cursor: pass it back as cursor to page; null when there are no more.

Next steps