Skip to main content
LinkupAPI connects your product or AI agent to LinkedIn, WhatsApp, and real-time B2B intelligence. One unified API to automate outreach, find contacts, and gather market insights for sales and recruitment.

​
What You Can Build

Sales Automation

Generate leads, automate outreach on LinkedIn/WhatsApp, track funding signals, and enrich company data in real-time.

Recruitment Automation

Source candidates, track hiring companies, and connect with talent on LinkedIn and WhatsApp at scale.

​
What’s New in V2

Action-Based Endpoints

Each category has a single endpoint. Send the action in the request body instead of calling different URLs.

Account Management

Manage your accounts via the API. List accounts, get details, and use account_id in all requests.

Standardized Responses

Every response follows the same format with success, data/error, and metadata fields.

​
Quick Start

​
1. Get Your API Key

Sign up at linkupapi.com

​
2. Connect Your Account

curl -X POST https://api.linkupapi.com/v2/login \
  -H "x-api-key: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"platform": "linkedin", "login_token": "your_token", "country": "FR"}'

​
3. Make Your First Request

curl -X POST https://api.linkupapi.com/v2/profiles \
  -H "x-api-key: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"account_id": "your_account_id", "action": "get_me"}'

​
Authentication

All V2 endpoints require your API key in the x-api-key header.

​
Request Format

All action endpoints use POST with the following body structure: 
{
  "account_id": "acc_123",
  "action": "action_name",
  "params": {
    "key": "value"
  }
}
​
account_id
string
required
The unique identifier of the account to use for this action.
​
action
string
required
The action to perform. Each category has its own set of available actions.
​
params
object
Action-specific parameters. See each action’s documentation for required and optional fields.

​
Response Format

Every V2 response follows a standardized format.

​
Success Response

{
  "success": true,
  "data": {
    "..."
  },
  "metadata": {
    "action": "get_profile",
    "account_id": "acc_123",
    "credits_consumed": 1,
    "timestamp": "2026-03-24T12:00:00Z"
  }
}

​
Error Response

{
  "success": false,
  "error": {
    "code": "INVALID_PARAMS",
    "message": "Missing required parameter: profile_url"
  },
  "metadata": {
    "action": "get_profile",
    "credits_consumed": 0,
    "timestamp": "2026-03-24T12:00:00Z"
  }
}

​
Credit System

Most actions consume 1 credit per request. Actions that return lists (search, get connections, etc.) consume 1 credit per 10 results, rounded up. For example:
  • Fetching a single profile: 1 credit
  • Searching with 25 results: 3 credits (25 / 10 = 2.5, rounded up to 3)
  • Listing 10 connections: 1 credit
The exact number of credits consumed is always returned in the metadata.credits_consumed field of the response.

​
Available Categories

CategoryEndpointDescription
ProfilesPOST /v2/profilesGet profile info, search profiles, visit profiles, get contact info
MessagesPOST /v2/messagesSend messages, get conversations, list inbox
NetworkPOST /v2/networkSend connection requests, manage invitations, get connections
ContentPOST /v2/contentCreate posts, comment, like, repost, get feed
RecruiterPOST /v2/recruiterCreate job posts, get candidates, manage job offers
CreditsGET /v2/creditsCheck your credit balance
WebhooksPOST/GET /v2/webhooksReal-time event notifications via webhook URLs
MailPOST /v2/mailFind, reverse-lookup, and validate email addresses

​
Need Help?