Companies: Profile

Retrieve a company profile

Returns a company's full LinkedIn profile including page details, viewer permissions, locations, and funding information.

get/v1/{account_id}/companies/{identifier}

Request

  • Base URL: https://api.curviate.com
  • URL: https://api.curviate.com/v1/{account_id}/companies/{identifier}
  • Auth: HTTP bearer

Path parameters

account_idstring required

The connected LinkedIn account to read with.

identifierstring required

The company to retrieve: its public handle (the linkedin.com/company/<handle> slug) or numeric id. Both come back on a search/companies result.

Response

The company's LinkedIn profile. Content fields (description, tagline) are returned verbatim and are never stored. follower_count is the audience-size signal that replaces the retired company followers list.

object'company_profile' required

Response type discriminator.

idstring required

LinkedIn company numeric identifier.

namestring required

Company display name.

descriptionstring

Company description (content pass-through, never stored).

public_identifierstring

LinkedIn public slug (the segment after linkedin.com/company/).

profile_urlstring

Full LinkedIn company profile URL.

public_picture_urlstring

URL of the company's public logo/profile picture (when available).

taglinestring

Short company tagline (when set).

follower_countnumber

Total follower count: the audience-size signal (replaces the retired company followers list).

is_activeboolean

Whether the company page is active.

is_archivedboolean

Whether the company page has been archived.

is_verifiedboolean

Whether the company has a verified LinkedIn organization badge.

verified_atstring

Timestamp the company was verified (present when is_verified is true).

phonestring

Company contact phone number (when available).

fundingobject

Funding round details (when available). Never observed on a live probe so far; shape is not fabricated.

acquired_byobject

Acquiring-company details (when the company has been acquired). Never observed on a live probe so far; shape is not fabricated.

hashtagsstring[]

Hashtags associated with the company page (without the # prefix).

industrystring[]

Industry categories (when available).

websitestring

Company website URL (when available).

establishment_yearnumber

Year the company was established (when available).

fields_of_expertisestring[]

Specialty areas (when available).

observed_atstring required

ISO-8601 timestamp for when this data was observed on LinkedIn. On a live fetch this is the time of the fetch; on a stored answer it is when the data was actually seen, not when you asked for it.

source'store' | 'live' required

Whether this answer came from Curviate's stored copy or from a fresh LinkedIn fetch. A stored answer costs the connected account nothing and is never surfaced to the person being read. It also carries less: fields Curviate does not retain (message bodies, notes, attachments, third-party contact details) are only ever present on a live fetch. Pass mode=live when you need them.

withdrawnboolean required

Whether LinkedIn has told us this resource no longer exists, such as a removed profile. When true, the answer above is the copy Curviate still holds and must not be treated as current. Always present; false is the normal case.

withdrawn_atstring

ISO-8601 timestamp for when a fetch MOST RECENTLY found this resource gone on LinkedIn. Every later fetch that finds it gone again moves it. Present only when withdrawn is true.

Example response

{
  "safety_warning": {
    "row": "profile_views",
    "reset_at": "2026-09-05T00:00:00.000Z",
    "hint": {
      "parameter": "profile_views.ceiling",
      "message": "This account is at its ceiling for profile_views. This action went through because profile_views.posture is warn, and it counted: 101 of 100 this window. Raise profile_views.ceiling, or wait for the window to reset at 2026-09-05T00:00:00.000Z."
    },
    "reason": "ceiling",
    "blocked": false
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.