n8n-nodes-linkupapi

n8n-nodes-linkupapi

Description

This n8n package provides comprehensive LinkedIn automation capabilities via the Linkup API. It offers a complete suite of features for profile management, networking, messaging, content creation, and recruitment automation.

Installation

npm install n8n-nodes-linkupapi

Configuration

• Create an account on LinkupAPI.com
• Get your API key from your dashboard
• Configure the credentials in your n8n workflow

Project Structure

n8n-nodes-linkupapi/
├── credentials/             # Linkup API credentials
│   └── LinkupApi.credentials.ts
├── nodes/                   # Node source code
│   └── Linkup/
│       ├── Linkup.node.ts   # Main node implementation
│       └── linkup.svg       # Node icon
├── package.json             # Project configuration
├── tsconfig.json           # TypeScript configuration
├── gulpfile.js             # Gulp build configuration
├── .eslintrc.js            # ESLint configuration
├── .gitignore              # Git ignored files
├── .npmignore              # npm ignored files
└── README.md               # Documentation

Features

Authentication

• LinkedIn Login
• Code Verification
• Secure token management

Profile Management

• Profile retrieval and extraction
• Profile information gathering
• Advanced profile search capabilities
• Contact information extraction

Network Management

• Send connection invitations
• Connection management and tracking
• Accept/withdraw invitations
• Network recommendations
• Invitation status monitoring

Messaging

• Send direct messages
• Retrieve conversation history
• Inbox management
• Message tracking

Content Management

• React to posts
• Add comments and replies
• Create new posts
• Search and filter posts
• Post analytics

Recruitment Tools

• Candidate management
• Job posting creation and management
• CV download and processing
• Application tracking

Signal API

• Extract post reactions
• Extract post comments
• Extract profile reactions
• Extract profile comments
• Extract profile posts
• Extract company posts

Company API

• Company search and discovery
• Company information extraction
• Company domain lookup
• Employee extraction

Person API

• Advanced profile search
• Profile enrichment
• Employee extraction from companies
• Decision maker identification

Usage Examples

Basic Authentication

// Login to LinkedIn
{
  "resource": "authentication",
  "operation": "login"
}

// Verify authentication code
{
  "resource": "authentication",
  "operation": "verifyCode",
  "verifyCodeParams": {
    "verificationCode": "123456"
  }
}

Profile Operations

// Get my profile
{
  "resource": "profile",
  "operation": "getMyProfile"
}

// Extract profile information
{
  "resource": "profile",
  "operation": "extractProfileInfo",
  "extractProfileParams": {
    "profileUrl": "https://www.linkedin.com/in/username"
  }
}

Network Operations

// Send connection request
{
  "resource": "network",
  "operation": "sendConnectionRequest",
  "sendConnectionParams": {
    "profileUrl": "https://www.linkedin.com/in/target",
    "connectionMessage": "Hi, I'd like to connect!"
  }
}

Content Operations

// React to a post
{
  "resource": "post",
  "operation": "reactToPost",
  "reactToPostParams": {
    "postUrl": "https://www.linkedin.com/posts/...",
    "reactionType": "LIKE"
  }
}

Company Operations

// Extract company employees
{
  "resource": "personApi",
  "operation": "extractCompanyEmployees",
  "extractCompanyEmployeesParams": {
    "company_name": "Microsoft",
    "total_results": 20,
    "decision_makers_only": false
  }
}

Development

# Install dependencies
pnpm install

# Build project
pnpm build

# Development mode (watch)
pnpm dev

# Lint code
pnpm lint

# Format code
pnpm format

API Coverage

This package covers 89% of the Linkup API endpoints:

• Authentication: 2/2 endpoints ✅
• Profile: 3/6 endpoints ✅
• Posts: 10/10 endpoints ✅
• Companies: 2/2 endpoints ✅
• Network: 8/8 endpoints ✅
• Messages: 3/4 endpoints ✅
• Recruitment: 6/6 endpoints ✅
• Signal: 6/6 endpoints ✅
• Data Search: 7/7 endpoints ✅

Requirements

• Node.js: >= 18.10
• n8n: Latest version
• Linkup API: Active account

Credentials

Configure the following credentials in n8n:

• API Key: Your Linkup API key
• LinkedIn Email: Your LinkedIn email
• LinkedIn Password: Your LinkedIn password
• Country: Your country code (default: FR)
• Login Token: LinkedIn authentication token

Error Handling

All operations include comprehensive error handling:

• Parameter validation
• API response validation
• Network error handling
• Authentication error management

Security

• No external dependencies
• Secure credential management
• No file system access
• No environment variable access
• All data passed through node parameters

Support

For support and documentation:

• Linkup API Documentation
• n8n Community
• GitHub Issues

Version

Current version: 2.4.15

License

MIT

Author

Eliott Cerpaud

Contributing

• Fork the repository
• Create a feature branch
• Make your changes
• Add tests if applicable
• Submit a pull request

Changelog

v2.4.15

• ✅ Complete English translation
• ✅ All error messages in English
• ✅ Updated documentation
• ✅ n8n compliance validation

v2.4.14

• ✅ Added Extract Company Employees feature
• ✅ New endpoint: /v1/data/employees/extract
• ✅ Enhanced person API capabilities

Previous versions

• Complete LinkedIn automation suite
• 41/46 API endpoints covered
• Comprehensive error handling
• TypeScript implementation