Skip to main content
GET

Find LinkedIn Mentions

Finds people and companies you can tag (@mention) in a LinkedIn post from this account. Each result has a text field: put it in the post’s LinkedIn text exactly as it is. Requires the accounts:read permission. LinkedIn never turns a plain “@Name” into a tag when a post comes through its API. A tag has to be written as @[Name](urn:li:person:ID), @[Name](urn:li:organization:ID) or @[Name](urn:li:organizationBrand:ID), with the name spelled exactly as LinkedIn spells it. This search gives you that text. The LinkedIn mentions guide shows the whole flow.

Who you can find

LinkedIn has no search of all its members, so the search looks in these places, in this order: People and companies tagged before, and teammates, match when their name holds q, in any case. Followers are matched by LinkedIn. The company search needs the short name exactly as it is in the link: acme finds the company at linkedin.com/company/acme, but Acme Inc does not. Each person or company shows up once, under the first place it was found. LinkedIn gives a person a different ID depending on how the account was connected. The search only returns people whose ID works from this account. Search with the account the post goes out from.

Request

integer
required
The LinkedIn account the post goes out from, from List Accounts (platform is linkedin)
string
required
2 to 200 characters: a name, or a company’s LinkedIn link or short name. Page followers are searched only when q looks like a name: it starts with a letter, holds only letters, spaces, periods, apostrophes and hyphens with never two non-letters in a row, has at most one space, and is at least 3 characters long (6 when it has a space or a period).

Response

object[]
The people and companies found, best first: tagged before, teammates, followers, companies. Empty when nothing was found.
available: the account’s Page followers can be searched (they are, when q looks like a name). needs_reconnect: the account was connected through PostSyncer’s older LinkedIn connection and can’t search Page followers until it is reconnected in PostSyncer. Teammates, people and companies tagged before, and companies still work.

Putting a result in a post

Paste text into the post’s LinkedIn text: content[].text, or the account’s own LinkedIn text in accounts[].settings.title, when you create or update a post.
On LinkedIn, the names become tags. On every other network the post goes to, a tag goes out as just the name (“Great talk today with Jane Doe at Acme!”). Get Post returns the text as you saved it, with the tags in it.

Error Codes

Bad Request
The account is not a LinkedIn account: {"message": "Account is not a LinkedIn account", "code": "INVALID_PROVIDER"}
Unauthorized
Missing or invalid API token
Forbidden
The key does not have the accounts:read permission
Not Found
No account with this ID in a workspace you can access
Unprocessable Entity
q is missing, shorter than 2 characters or longer than 200