Find Clients

The search system helps agencies discover new business opportunities by searching for companies with open roles and potential client contacts.

Job searches

Find companies with active hiring needs:


POST /v1/searches/jobs
Authorization: Bearer <token>
Content-Type: application/json
 
{
  "query": "companies hiring backend engineers in Berlin"
}

View results — both matching jobs and associated contacts:


GET /v1/searches/jobs/:searchId/results/jobs
GET /v1/searches/jobs/:searchId/results/contacts

Refresh a search to get updated results:


POST /v1/searches/jobs/:searchId/refreshes
Authorization: Bearer <token>

Client searches

Search directly for potential client companies:


POST /v1/searches/clients
Authorization: Bearer <token>
Content-Type: application/json
 
{
  "query": "medtech companies with 50-500 employees in DACH region"
}

View discovered contacts:


GET /v1/searches/clients/:searchId/results/contacts
Authorization: Bearer <token>

Expand results to find more prospects:


POST /v1/searches/clients/:searchId/expansions
Authorization: Bearer <token>

Prospect lists

Save discovered contacts to named lists for follow-up:


POST /v1/pools/prospects
Authorization: Bearer <token>
Content-Type: application/json
 
{
  "name": "Berlin Medtech Prospects Q2"
}

Manage list contacts and leads:


GET    /v1/pools/prospects/user/:userId
GET    /v1/pools/prospects/:publicId
PATCH  /v1/pools/prospects/:publicId
PATCH  /v1/pools/prospects/:publicId/leads
PATCH  /v1/pools/prospects/:publicId/contacts

Agent-powered prospecting

The AI agent can run client searches autonomously. Results land in the inbox for review:


POST /v1/agent/threads
Authorization: Bearer <token>
Content-Type: application/json
 
{
  "prompt": "Find medtech companies hiring embedded recruiters in Germany"
}

Review agent findings in the inbox:


GET /v1/inbox?type=client_prospect&surface=crm
Authorization: Bearer <token>

Convert a prospect to a client:


POST /v1/inbox/:id/actions/create-client
Authorization: Bearer <token>