API Reference/LinkedIn Specific/Retrieve a company profile

Retrieve a company profile

GEThttps://api.postpress.ai/v1/linkedin/company/{identifier}

Get a company profile from its name or ID.

Authorization

X-API-KEYstringrequired
API key from your postpress dashboard. Sent as a request header.

Path parameters

identifierstringrequired
The identifier of the company. Accepts the public identifier (e.g. `acme`), the numeric id, or the URN (`urn:li:fsd_company:...`).

Query parameters

account_idstringrequired
The linked account to perform the request from.

Response 200 OK

objectstringCompanyProfilerequired
idstringrequired
namestringrequired
descriptionstringrequired
entity_urnstringrequired
public_identifierstringrequired
profile_urlstringrequired
taglinestring
followers_countnumber
is_followingboolean
is_employeeboolean
hashtagsarray of objectsrequired
hashtags object
titlestringrequired
messagingobjectrequired
messaging object
is_enabledbooleanrequired
idstring
entity_urnstring
claimedbooleanrequired
viewer_permissionsobjectrequired
viewer_permissions object
canMembersInviteToFollowbooleanrequired
canReadContentSuggestionsbooleanrequired
canReadMessagesbooleanrequired
canUpdateOrganizationProfilebooleanrequired
canCreateOrganicSharebooleanrequired
canReadAdminDashboardbooleanrequired
canReadOrganizationActivitybooleanrequired
canEditCuratorsbooleanrequired
canManageOrganizationalPageFollowbooleanrequired
canReadOrganizationFollowerAnalyticsbooleanrequired
canInviteMemberToFollowbooleanrequired
canReadOrganizationLeadsAnalyticsbooleanrequired
canEditPendingAdministratorsbooleanrequired
canManageMessagingAccessbooleanrequired
canSeeEmployeeExperienceAsMemberbooleanrequired
canEmployeesInviteToFollowbooleanrequired
canSeeOrganizationAdministrativePagebooleanrequired
canManageAdminRolesbooleanrequired
canEditOrganizationDetailsbooleanrequired
canApproveContentbooleanrequired
canViewTeamPerformancebooleanrequired
canManageOrganizationSettingsbooleanrequired
canAccessAdvancedAnalyticsbooleanrequired
canModerateCommentsbooleanrequired
canCreateAdsbooleanrequired
canManageAdBudgetsbooleanrequired
canEditPageThemebooleanrequired
canPublishNewslettersbooleanrequired
canEditCustomTabsbooleanrequired
canManageIntegrationsbooleanrequired
canAssignRolesbooleanrequired
canApprovePendingMembersbooleanrequired
canEditCareerPageSettingsbooleanrequired
canViewBillingInformationbooleanrequired
organization_typestringrequired
PUBLIC_COMPANYEDUCATIONALSELF_EMPLOYEDGOVERNMENT_AGENCYNON_PROFITSELF_OWNEDPRIVATELY_HELDPARTNERSHIP
locationsarray of objectsrequired
locations object
is_headquarterbooleanrequired
countrystringrequired
citystringrequired
postalCodestring
streetarray of stringsrequired
descriptionstring
areastring
logostring
localized_descriptionarray of objects
Localized values keyed by locale (e.g. `en_US`, `fr_FR`).
localized_namearray of objects
Localized values keyed by locale.
localized_taglinearray of objects
Localized values keyed by locale.
industryarray of strings
activitiesarray of strings
employee_countnumber
employee_count_rangeobject
employee_count_range object
fromnumberrequired
tonumberrequired
websitestring
foundation_datestring
phonestring
insightsobject
insights object
employeesCountobject
employeesCount object
totalCountnumberrequired
averageTenurestringrequired
employeesCountGrapharray of objectsrequired
employeesCountGraph object
datestringrequired
countnumberrequired
growthGrapharray of objectsrequired
growthGraph object
monthRangenumberrequired
growthPercentagenumberrequired
acquired_byobject
acquired_by object
idstringrequired
namestringrequired
public_identifierstringrequired
profile_urlstringrequired
crunchbase_fundingobject
crunchbase_funding object
last_updated_atstringrequired
company_urlstringrequired
roundsobjectrequired
rounds object
urlstringrequired
total_countnumberrequired
last_roundobjectrequired
last_round object
announced_onstringrequired
urlstringrequired
funding_typestringrequired
investors_countnumberrequired
lead_investorsarray of objectsrequired
lead_investors object
namestringrequired
urlstringrequired
logostring
money_raisedobject
money_raised object
amountnumberrequired
currencystringrequired

Example request

curl --request GET \
  --url 'https://api.postpress.ai/api/v1/linkedin/company/acme?account_id=acc_linkedin_01HXYZ4QK3WJ8FN3M6QH7TZ8GR' \
  --header 'X-API-KEY: pp_live_...' \
  --header 'accept: application/json'

Example response

{
  "object": "CompanyProfile",
  "id": "9374000",
  "name": "Acme Corp",
  "description": "Building the future of work.",
  "entity_urn": "urn:li:fsd_company:9374000",
  "public_identifier": "acme",
  "profile_url": "https://www.linkedin.com/company/acme",
  "tagline": "Better tools for builders.",
  "followers_count": 124000,
  "is_following": false,
  "is_employee": false,
  "hashtags": [{ "title": "#hiring" }, { "title": "#engineering" }],
  "messaging": { "is_enabled": true, "id": "msg_9374000", "entity_urn": "urn:li:fsd_messagingMember:9374000" },
  "claimed": true,
  "viewer_permissions": {
    "canMembersInviteToFollow": false,
    "canReadContentSuggestions": false,
    "canReadMessages": false,
    "canUpdateOrganizationProfile": false,
    "canCreateOrganicShare": false,
    "canReadAdminDashboard": false,
    "canReadOrganizationActivity": false,
    "canEditCurators": false,
    "canManageOrganizationalPageFollow": false,
    "canReadOrganizationFollowerAnalytics": false,
    "canInviteMemberToFollow": false,
    "canReadOrganizationLeadsAnalytics": false,
    "canEditPendingAdministrators": false,
    "canManageMessagingAccess": false,
    "canSeeEmployeeExperienceAsMember": false,
    "canEmployeesInviteToFollow": false,
    "canSeeOrganizationAdministrativePage": false,
    "canManageAdminRoles": false,
    "canEditOrganizationDetails": false,
    "canApproveContent": false,
    "canViewTeamPerformance": false,
    "canManageOrganizationSettings": false,
    "canAccessAdvancedAnalytics": false,
    "canModerateComments": false,
    "canCreateAds": false,
    "canManageAdBudgets": false,
    "canEditPageTheme": false,
    "canPublishNewsletters": false,
    "canEditCustomTabs": false,
    "canManageIntegrations": false,
    "canAssignRoles": false,
    "canApprovePendingMembers": false,
    "canEditCareerPageSettings": false,
    "canViewBillingInformation": false
  },
  "organization_type": "PRIVATELY_HELD",
  "locations": [
    {
      "is_headquarter": true,
      "country": "US",
      "city": "San Francisco",
      "postalCode": "94107",
      "street": ["123 Market St", "Suite 400"],
      "description": "HQ",
      "area": "California"
    }
  ],
  "logo": "https://media.licdn.com/.../logo.jpg",
  "industry": ["Software Development"],
  "activities": ["B2B SaaS"],
  "employee_count": 412,
  "employee_count_range": { "from": 201, "to": 500 },
  "website": "https://acme.example.com",
  "foundation_date": "2018",
  "phone": "+1 415 555 0100",
  "insights": {
    "employeesCount": {
      "totalCount": 412,
      "averageTenure": "2.4 years",
      "employeesCountGraph": [{ "date": "2026-05-01", "count": 412 }],
      "growthGraph": [{ "monthRange": 12, "growthPercentage": 18.4 }]
    }
  }
}

Errors

Every error response follows the same envelope:

titlestringrequired
Short error title.
detailstringoptional
Human-readable explanation.
instancestringoptional
Request identifier for support.
typestringrequired
Error type identifier.
statusnumberrequired
HTTP status code.
401 Unauthorized13 types

Credentials are missing, expired, or otherwise invalid.

  • errors/missing_credentials - Some credentials are necessary to perform the request.
  • errors/multiple_sessions - LinkedIn limits multiple sessions on certain Recruiter accounts. Use the cookie connection method.
  • errors/wrong_account - The provided credentials do not match the correct account.
  • errors/invalid_credentials - The provided credentials are invalid.
  • errors/invalid_proxy_credentials - The provided proxy credentials are invalid.
  • errors/invalid_checkpoint_solution - The checkpoint resolution did not pass successfully. Retry.
  • errors/checkpoint_error - The checkpoint does not appear to be resolvable.
  • errors/expired_credentials - Credentials have expired. Reconnect the account.
  • errors/expired_link - This link has expired. Generate a new one.
  • errors/insufficient_privileges - This resource is out of your API-key scopes.
  • errors/disconnected_account - The account is disconnected from the provider service.
  • errors/disconnected_feature - The service you're trying to reach is disconnected.
  • errors/invalid_credentials_but_valid_account_imap - IMAP/SMTP credentials are invalid but the account is otherwise valid.
403 Forbidden9 types

Authenticated but the account is restricted or the action is not allowed.

  • errors/insufficient_permissions - Valid authentication but insufficient permissions to perform the request.
  • errors/account_restricted - The account has been restricted by the provider.
  • errors/account_mismatch - This action cannot be done with your account.
  • errors/unknown_authentication_context - An additional step seems necessary to complete login.
  • errors/session_mismatch - Token user id does not match client session id.
  • errors/feature_not_subscribed - The requested feature has not been subscribed or authenticated properly.
  • errors/subscription_required - A subscription is required to use this feature.
  • errors/resource_access_restricted - You don't have access to this resource.
  • errors/action_required - An additional step is required.
404 Not Found2 types

The company or the targeted account does not exist.

  • errors/resource_not_found - The requested resource was not found.
  • errors/invalid_resource_identifier - The provided identifier is not valid for this resource.
422 Unprocessable Entity4 types

The request is well-formed but cannot be fulfilled as-is.

  • errors/invalid_account - The provided account is not designed for this feature.
  • errors/unprocessable_entity - The request cannot be processed in its current form.
  • errors/account_configuration_error - The account configuration prevents this request.
  • errors/provider_unreachable - The provider is currently unreachable.
500 Internal Server Error3 types

Something went wrong on our side or with the upstream provider.

  • errors/unexpected_error - Something went wrong.
  • errors/provider_error - The provider is experiencing operational problems. Retry later.
  • errors/authentication_intent_error - The current authentication intent was killed after failure.
503 Service Unavailable5 types

postpress is temporarily unable to handle the request.

  • errors/no_client_session - No client session is currently running.
  • errors/no_channel - No channel to client session.
  • errors/no_handler - Handler missing for that request.
  • errors/network_down - Network is down on the server side. Retry shortly.
  • errors/service_unavailable - Service temporarily unavailable. Retry later.
504 Gateway Timeout1 types

The upstream provider did not respond in time.

  • errors/request_timeout - Request timed out. Retry, and contact support if it persists.
Updated May 2026