Prospecting (client discovery)

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

Naming note. In the app this is the Prospecting module (/prospecting), a paid add-on. It replaced the old standalone Find Clients page, and /find-clients links now redirect to /prospecting. The API keeps its original searches/jobs and searches/clients paths, documented below, so existing integrations are unaffected. Prospecting also folds in the former Find Email page as its Enrichment tool.

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>