Docs / Search
get_company
Read one company page.
This action only reads. It changes nothing, so it is safe to try.
What you give it
| Input | What it is | Where to get it |
|---|---|---|
companyneeded | A company link or a company id. The company: its LinkedIn page URL, its name as it appears in that URL, or its numeric id. | Open the company's page on LinkedIn and copy the address from your browser. It looks like https://www.linkedin.com/company/their-name Or run search_linkedin_companies and use results[].profileUrl from its answer.7 more places to get it
|
connectionIdoptional | A connection id. Which of your LinkedIn accounts to act from (its id from list_linkedin_accounts). Omit to use your first live one. | Run list_linkedin_accounts and use accounts[].id from its answer.15 more places to get it
|
Call it
curl -X POST https://api.heyreagent.com/v1/actions/get_company \
-H "Authorization: Bearer YOUR_KEY" \
-H "content-type: application/json" \
-d '{"company":"PASTE_COMPANY_LINK_HERE"}'The same call in JavaScript
const response = await fetch("https://api.heyreagent.com/v1/actions/get_company", {
method: "POST",
headers: {
"Authorization": "Bearer YOUR_KEY",
"content-type": "application/json",
},
body: JSON.stringify({
"company": "PASTE_COMPANY_LINK_HERE"
}),
});
const answer = await response.json();
console.log(answer);The same call in Python
import requests
response = requests.post(
"https://api.heyreagent.com/v1/actions/get_company",
headers={"Authorization": "Bearer YOUR_KEY"},
json={
"company": "PASTE_COMPANY_LINK_HERE",
},
)
print(response.json())The same call in n8n
Add an HTTP Request node and fill it in like this:
| Method | POST |
| URL | https://api.heyreagent.com/v1/actions/get_company |
| Send Headers | On. Name Authorization, Value Bearer YOUR_KEY |
| Send Body | On. Body Content Type JSON, Specify Body Using JSON, then paste the body below |
{
"company": "PASTE_COMPANY_LINK_HERE"
}Put your own key where it says YOUR_KEY. Put your own value where it says PASTE_…_HERE: the table above says where each one comes from. New here? Start with your first call.
What you get back
When it worked, the answer is { "ok": true, "result": { … } }. Inside result:
id | A company id. Other actions take it. |
name | string |
description | string |
entityUrn | string |
publicIdentifier | string |
profileUrl | A company link. Other actions take it. |
tagline | string |
followersCount | number |
isFollowing | boolean |
isEmployee | boolean |
hashtags[].title | string |
messaging.isEnabled | boolean |
messaging.id | A company messaging id. Other actions take it. |
messaging.entityUrn | string |
claimed | boolean |
viewerPermissions.canMembersInviteToFollow | boolean |
viewerPermissions.canReadContentSuggestions | boolean |
viewerPermissions.canReadMessages | boolean |
viewerPermissions.canUpdateOrganizationProfile | boolean |
viewerPermissions.canCreateOrganicShare | boolean |
viewerPermissions.canReadAdminDashboard | boolean |
viewerPermissions.canReadOrganizationActivity | boolean |
viewerPermissions.canEditCurators | boolean |
viewerPermissions.canManageOrganizationalPageFollow | boolean |
viewerPermissions.canReadOrganizationFollowerAnalytics | boolean |
viewerPermissions.canInviteMemberToFollow | boolean |
viewerPermissions.canReadOrganizationLeadsAnalytics | boolean |
viewerPermissions.canEditPendingAdministrators | boolean |
viewerPermissions.canManageMessagingAccess | boolean |
viewerPermissions.canSeeEmployeeExperienceAsMember | boolean |
viewerPermissions.canEmployeesInviteToFollow | boolean |
viewerPermissions.canSeeOrganizationAdministrativePage | boolean |
viewerPermissions.canManageAdminRoles | boolean |
viewerPermissions.canEditOrganizationDetails | boolean |
viewerPermissions.canApproveContent | boolean |
viewerPermissions.canViewTeamPerformance | boolean |
viewerPermissions.canManageOrganizationSettings | boolean |
viewerPermissions.canAccessAdvancedAnalytics | boolean |
viewerPermissions.canModerateComments | boolean |
viewerPermissions.canCreateAds | boolean |
viewerPermissions.canManageAdBudgets | boolean |
viewerPermissions.canEditPageTheme | boolean |
viewerPermissions.canPublishNewsletters | boolean |
viewerPermissions.canEditCustomTabs | boolean |
viewerPermissions.canManageIntegrations | boolean |
viewerPermissions.canAssignRoles | boolean |
viewerPermissions.canApprovePendingMembers | boolean |
viewerPermissions.canEditCareerPageSettings | boolean |
viewerPermissions.canViewBillingInformation | boolean |
organizationType | PUBLIC_COMPANY | EDUCATIONAL | SELF_EMPLOYED | GOVERNMENT_AGENCY | NON_PROFIT | SELF_OWNED | PRIVATELY_HELD | PARTNERSHIP or null |
locations[].isHeadquarter | boolean |
locations[].country | string |
locations[].city | string |
locations[].postalCode | string |
locations[].street | string[] |
locations[].description | string |
locations[].area | string |
logo | string |
industry | string[] |
activities | string[] |
employeeCount | number |
employeeCountRange.from | number |
employeeCountRange.to | number |
website | string |
foundationDate | string |
phone | string |
acquiredBy.id | string |
acquiredBy.name | string |
acquiredBy.publicIdentifier | string |
acquiredBy.profileUrl | string |
crunchbaseFunding.lastUpdatedAt | string |
crunchbaseFunding.companyUrl | string |
A field that does not apply to an answer is left out, or is null. There are 17 more fields nested inside these.
When it did not work, the answer is { "ok": false, "error": "…", "message": "…" }. What each error means.
Good to know
- company also takes the page's name as it appears in its link (linkedin.com/company/<this>).
In Claude or ChatGPT
Once connected, ask in your own words. The assistant sees this action as a tool with the same name, get_company, and the same inputs.