Skip to main content
POST
Enrich person interests

Authorizations

Authorization
string
header
required

Access token issued by gtm.service.id. Its access_identity claim carries team_sid, actor_sid and actor_type, and that team scope is authoritative.

Team-SID
string
header
required

Team scope for tokens that do not carry one. Ignored when the token already names a team.

Body

application/json

Request body of enrich_linkedin_person_interests.

profile_id
string

The person by any identifier, read by its shape: a profile URN (ACoAA…), a Sales Navigator id (ACwAA…), a Recruiter id (AEMAA…), urn:li:fsd_profile:…, urn:li:member:, a vanity slug or any profile link. Provide exactly one of profile_id / public_identifier / ln_member_id / recruiter_id.

Maximum string length: 2048
public_identifier
string

The same field under the slug's name: a vanity slug from /in/…, the whole profile link (any linkedin.com host, a Sales Navigator lead link too) or a URN; read by its shape, so a URN here and a slug in profile_id both work, and a link and its slug share one ledger entry. A value that names no member (a company page, a feed link) is 422 public_identifier_not_resolvable. Whatever key the method's wire takes is found for you: from your team's own history or the stored corpus for free, else by ONE extra LinkedIn request, and the receipt says which (data_request.target_resolved_via: "ledger" | "corpus" | "browser", null when nothing had to be resolved). A slug LinkedIn does not know is 422 public_identifier_unresolved.

Maximum string length: 2048
ln_member_id
string

The member number: the digits, or urn:li:member:. It resolves from your team's history or the stored corpus; a number nobody knows is 422 ln_member_id_unresolved, since LinkedIn opens no profile by the number.

Maximum string length: 64
recruiter_id
string

A Recruiter (talent) id (AEMAA…): it names the member it decodes to.

Maximum string length: 128
tab
enum<string> | null

Which interests tab to read; top_voices when omitted. One tab per call, each its own read.

Available options:
top_voices,
companies,
groups,
newsletters,
schools
page_size
integer

Items per page, 1..100 (wire default 10).

Required range: 1 <= x <= 100
cursor
string | null

Opaque cursor: pass back paging.next_page_cursor verbatim; omitted = first page.

linkedin_account_sid
string | null

Executor account (ln_ac_...). Given: the call runs on that account ONLY; a saturated or held enrichment bucket refuses 429 bucket_saturated (with retry_after). Omitted: the service auto-picks one of your connected accounts with remaining capacity (422 no_connected_accounts when none is ready, 429 when all are at capacity).

Required string length: 18
Pattern: ^ln_ac_
idempotency_key
string | null

Replay guard (team_sid, idempotency_key). A repeat with the same key returns the stored ledger outcome without running again, except a failure that answered with retry_after: once that time has passed, a repeat under the same key runs again. A target named by another key than the one the wire takes spends at most ONE resolve read, journaled under this key plus ":resolve" (sha256:<64 hex>:resolve past 120 characters), which a repeat replays; a stored read of another target never answers. While that read runs, a repeat is 429 target_resolve_in_progress (retry_after). A refusal after it names it (error.context.data_request_sid, target_resolved_via "browser").

Maximum string length: 128
trust_cache_max_age_days
integer | null

Accept a stored payload this many days old instead of fetching (probe tier 2, §9.5): a hit answers with served_from_cache / cache_source "data_cluster", spending no browser run and no bucket slot. Omitted, the stored payload is never consulted and the call always dispatches.

Required range: 1 <= x <= 3650

Response

action success envelope.

success
enum<boolean>
required
Available options:
true
operation
enum<string>
required
Available options:
action
action
string
required

kebab-case verb; matches the route segment.

item
any
required
result
object
required
meta
object
required
pacing
object