Skip to content
Ordinal
Esc
↑↓navigate↵open⌘Jpreview

Mention format by username

Look up the mention format for a LinkedIn user or organization by their username to use in posts or comments.

The username is the part after /in/ or /company/ in a LinkedIn profile URL:

  • Personal profile: linkedin.com/in/johndoe - username is johndoe
  • Company page: linkedin.com/company/acme-inc - username is acme-inc

Returns both user and organization results if a username matches both (rare but possible).

GET/linkedin/{username}/mentions
Authorization
AuthorizationBearer token · headerrequired

API key authentication. Generate an API key from your workspace settings.

Path parameters
usernamestringrequired

LinkedIn username (vanity name) to look up

min length 1
Responses
200

LinkedIn mention information

userobject | null
Show properties
usernamestring

LinkedIn username (vanity name)

urnstring

LinkedIn URN for the user

typestring
Allowed:User
displayNamestring

Full display name of the user

firstNamestring

First name of the user

mentionFormatstring

Pre-formatted mention string using full name, e.g. @[John Doe](urn:li:person:ABC123)

firstNameMentionFormatstring

Pre-formatted mention string using first name only, e.g. @[John](urn:li:person:ABC123)

organizationobject | null
Show properties
usernamestring

LinkedIn username (vanity name)

urnstring

LinkedIn URN for the organization

typestring
Allowed:Organization
displayNamestring

Display name of the organization

mentionFormatstring

Pre-formatted mention string, e.g. @[Acme Inc](urn:li:organization:123456)

401

Unauthorized - Missing or invalid API key

codestring
messagestring
404

Not Found - Resource does not exist

codestring
messagestring
Try it
Server
Authorization
Parameters
Request
curl -X GET 'https://app.tryordinal.com/api/v1/linkedin/string/mentions' \
  -H 'Authorization: Bearer YOUR_TOKEN'
Response
{
  "user": {
    "username": "johndoe",
    "urn": "urn:li:person:ABC123xyz",
    "type": "User",
    "displayName": "John Doe",
    "firstName": "John",
    "mentionFormat": "@[John Doe](urn:li:person:ABC123xyz)",
    "firstNameMentionFormat": "@[John](urn:li:person:ABC123xyz)"
  },
  "organization": {
    "username": "acme-inc",
    "urn": "urn:li:organization:123456",
    "type": "Organization",
    "displayName": "Acme Inc",
    "mentionFormat": "@[Acme Inc](urn:li:organization:123456)"
  }
}