Documentation Index
Fetch the complete documentation index at: https://docs.pinkfish.ai/llms.txt
Use this file to discover all available pages before exploring further.
What can you do with it?
Manage your professional network with LinkedIn, including sharing posts, searching companies, creating company page posts, getting organization followers, posting job openings, and managing connections for comprehensive professional networking and recruitment activities.
How to use it?
Basic Command Structure
/your-linkedin-connection [action] [required-parameters] [optional-parameters]
Parameters
Required:
action - The operation to perform (get-profile, share-post, search-company, create-company-post, get-followers, post-job, get-connections)
Optional:
profile-id - LinkedIn profile ID
post-content - Content for posts
company-name - Company name for search
organization-id - Organization ID
job-title - Job title for posting
job-description - Job description
location - Job location
Get User Profile
Identify and retrieve the authenticated user’s profile information
Parameters:
- No parameters required for current user profile
Example:
/your-linkedin-connection
action: get-profile
Response:
{
"sub": "E0AVmS9A12",
"name": "John Doe",
"given_name": "John",
"family_name": "Doe",
"picture": "https://media.licdn.com/dms/image/C4D03AQGTPFGPXYZ123/profile-displayphoto-shrink_200_200/0?e=1612396800&v=beta&t=abcdefghijk",
"email": "johndoe@example.com"
}
Share Post
Share a post on LinkedIn to your network
Parameters:
profile-id (required) - LinkedIn profile ID
post-content (required) - Text content for the post
visibility (optional) - Post visibility (PUBLIC, CONNECTIONS)
media-category (optional) - Media category (NONE, ARTICLE, IMAGE)
Example:
/your-linkedin-connection
action: share-post
profile-id: E0AVmS9A12
post-content: Excited to share this update!
visibility: PUBLIC
media-category: NONE
Response:
{
"id": "urn:li:share:6789012345",
"created": {
"time": 1634567890000
}
}
Search Company
Search for companies to find organization information and IDs
Parameters:
company-name (required) - Name of the company to search for
limit (optional) - Number of results to return (default: 10)
Example:
/your-linkedin-connection
action: search-company
company-name: LinkedIn Corporation
limit: 10
Response:
{
"elements": [
{
"entity~": {
"vanityName": "linked-it"
},
"entity": "urn:li:organization:1032984"
},
{
"entity~": {
"vanityName": "linked"
},
"entity": "urn:li:organization:1333387"
}
],
"paging": {
"total": 12991,
"count": 10,
"start": 0
}
}
Create Company Post
Create a post on behalf of a company page
Parameters:
organization-id (required) - Organization ID
post-title (required) - Title of the post
post-content (required) - Text content of the post
post-subject (required) - Subject of the post
content-url (optional) - URL to link in the post
thumbnail-url (optional) - Thumbnail image URL
Example:
/your-linkedin-connection
action: create-company-post
organization-id: 123456
post-title: New Blog Post
post-content: We're excited to share our latest insights on industry trends...
post-subject: Check out our latest blog post
content-url: https://www.example.com/blog
thumbnail-url: https://www.example.com/image.jpg
Response:
{
"activity": "urn:li:activity:6789012345",
"id": "urn:li:share:6789012345"
}
Get Organization Followers
Retrieve follower count for an organization
Parameters:
organization-id (required) - Organization ID to get followers for
Example:
/your-linkedin-connection
action: get-followers
organization-id: 123456
Response:
{
"elements": [
{
"entityUrn": "urn:li:fs_followingInfo:urn:li:organization:123456",
"followerCount": 5000,
"followingInfo": {
"followerCount": 5000,
"followingType": "Organization"
}
}
]
}
Post Job Opening
Post a job opening on LinkedIn
Parameters:
company-id (required) - Company ID posting the job
job-title (required) - Title of the job position
job-description (required) - Description of the job
location-country (required) - Country code (e.g., US)
location-city (required) - City name
employment-status (optional) - Employment type (FULL_TIME, PART_TIME, CONTRACT)
experience-level (optional) - Experience level (ENTRY_LEVEL, MID_SENIOR, SENIOR, EXECUTIVE)
job-function (optional) - Job function category (ENGINEERING, MARKETING, SALES)
Example:
/your-linkedin-connection
action: post-job
company-id: 123456
job-title: Senior Software Engineer
job-description: We are looking for an experienced software engineer...
location-country: US
location-city: San Francisco
employment-status: FULL_TIME
experience-level: SENIOR
job-function: ENGINEERING
Response:
{
"id": "3456789",
"jobPosting": {
"title": "Senior Software Engineer",
"companyId": 123456,
"status": "ACTIVE"
}
}
Get Connections
Retrieve your LinkedIn connections information
Parameters:
start (optional) - Starting index for pagination (default: 0)
count (optional) - Number of connections to return (default: 50)
Example:
/your-linkedin-connection
action: get-connections
start: 0
count: 50
Response:
{
"elements": [
{
"miniProfile": {
"firstName": "Jane",
"lastName": "Smith",
"occupation": "Product Manager",
"entityUrn": "urn:li:fs_miniProfile:ABC123def456"
},
"connectionInfo": {
"connected": true,
"connectionDate": 1634567890000
}
}
],
"paging": {
"count": 50,
"start": 0,
"total": 500
}
}
Notes
LinkedIn uses URN (Uniform Resource Name) format for entity identification. Profile IDs are required for most operations and can be obtained from the get-profile endpoint. Company searches return organization URNs that can be used for posting and follower operations. Job postings require valid company IDs and location information. Connection data includes pagination for large contact lists.