st.openCompanyPage
This action allows you to open a company page to retrieve its basic information and perform additional company-related actions if needed.
Constraints
⏺️
Root Start: allowed, when
companyUrl parameter is provided.⬆️
Parent Actions: st.doForCompanies, nv.openCompanyPage.
⬇️
Parameters
{
"actionType": "st.openCompanyPage",
"label": "company1",
"companyUrl": "https://www.linkedin.com/company/company1",
"basicInfo": true,
"then": { ... }
}
label(optional) – custom label for tracking this action in workflow completion.companyUrl(required for root start, forbidden for parent start) – public or hashed LinkedIn URL of the company.basicInfo(optional, default:false) – when set totrue, the action includes basic company information in the results.then(optional) – object or array of child actions to be executed within this action.
Result options
- Successful page opening with
basicInfoset totrue:
{
"actionType": "st.openCompanyPage",
"label": "company1",
"success": true,
"data": {
"name": "TechCorp",
"publicUrl": "https://www.linkedin.com/company/company1",
"description": "TechCorp is a leading provider of innovative technology solutions for businesses worldwide.",
"location": "Cupertino, California",
"headquarters": "US",
"industry": "Information Technology",
"specialties": "Cloud Computing, AI, Software Development",
"website": "https://techcorp.com",
"employeesCount": 500,
"yearFounded": 2019,
"ventureFinancing": true,
"jobsCount": 12,
"then": { ... }
}
}
label– included only if specified in the action parameters.data– basic information about the company and results of child actions execution.name– name of the company.publicUrl– public LinkedIn URL of the company.description– description of the company.location– free-form string representing the company headquarters location.headquarters– two-character country code (e.g., "US", "UK") representing headquarters location.industry– enum representing the company industry. Takes specific values available in the LinkedIn interface.specialties– comma-separated list of company's specialties.website– company's official website URL.employeesCount– total number of employees associated with the company.yearFounded– year the company was established, if available.ventureFinancing– boolean indicating whether the company has received venture financing.jobsCount– number of current job vacancies posted by the company.then– results of child actions execution.
- Successful page opening with
basicInfoset tofalse:
{
"actionType": "st.openCompanyPage",
"label": "company1",
"success": true,
"data": {
"then": { ... }
}
}
label– included only if specified in the action parameters.data.then– results of child actions execution.
- Failed page opening:
{
"actionType": "st.openCompanyPage",
"label": "company1",
"success": false,
"error": {
"type": "companyNotFound",
"message": "The provided URL is not an existing LinkedIn company."
}
}
label– included only if specified in the action parameters.error.type– enum with the following possible values:companyNotFound– provided URL is not an existing LinkedIn company.