Skip to main content
POST
Start account research on a target company and receive a magic link immediately. Account research finds the buyers at that company and the warm paths into them through your network. The link points to a live report page. While the research runs (typically 2 to 5 minutes) it shows a “processing” state and auto-refreshes every 30 seconds. Once complete, the same URL renders the full report. No polling or second request needed. If your workspace already has research in progress, a new run may take a little longer to start; it begins automatically once capacity frees up, and the report page keeps showing “processing” until then. In that case the response status is QUEUED instead of PROCESSING; the magic link works the same way. A run can still fail after it starts, most often because the LinkedIn URL is not the company’s own page. The magic link then says the research failed and why, instead of “processing”, and stops refreshing. Get Job Status with the returned job_id reads FAILED with failure_reason and reason_code (for example company_not_found). If a run cannot be started at all, the error message says why. The magic link is stable: repeated calls with the same workspace and LinkedIn URL return the same link. Re-running research updates the existing report in place.

Authorizations

Authorization
string
header
required

The API key you created on the API settings page of the Clustr app.

Body

application/json
company_name
string
required

Name of the target company.

Example:

"Acme Corp"

company_linkedin_url
string<uri>
required

The company's LinkedIn page URL. It must contain /company/.

Example:

"https://www.linkedin.com/company/acme-corp/"

countries
string[]

Keep only buyers in these countries, for example ["United States", "United Kingdom"].

Example:
completion_email
string<email>

Email to notify when the report is ready.

Example:

"notify@example.com"

Response

Account research started; magic link available immediately

success
boolean
required
Example:

true

data
object
required