Unlocking Career Insights with the LinkedIn Profile and Job Data API

3 Jul 2025

In today’s competitive job market, understanding professional profiles and job opportunities is crucial for both individuals and organizations. The LinkedIn Profile and Job Data API empowers developers to seamlessly retrieve and analyze LinkedIn data, enabling applications to offer valuable insights into recent activities and job listings. By integrating this API, developers can enhance user experiences, streamline recruitment processes, and provide personalized career recommendations. Whether you’re building a job board, a recruitment tool, or a professional networking application, this API simplifies data extraction and enhances functionality.

Prerequisites

To get started with the LinkedIn Profile and Job Data API, you'll need a valid API key for authentication. Familiarity with making API calls will also be beneficial to leverage the full potential of the available actions.

Retrieve LinkedIn Recent Activity

The Retrieve LinkedIn Recent Activity action allows developers to fetch the last 50 activity posts from a specific LinkedIn profile using its URL. This action is particularly useful for applications that aim to analyze a user's engagement on the platform or to provide insights into their professional interactions.

Professional Analytics: Build analytics dashboards that visualize user engagement and recent activities.
Recruitment Insights: Help recruiters assess candidates' professional involvement and interests by reviewing their LinkedIn activity.
Content Curation: Create applications that aggregate and display recent professional activities for networking or content sharing purposes.


```python
import requests
import json

# Replace with your actual Cognitive Actions API key and endpoint
# Ensure your environment securely handles the API key
COGNITIVE_ACTIONS_API_KEY = "YOUR_COGNITIVE_ACTIONS_API_KEY"
# This endpoint URL is hypothetical and should be documented for users
COGNITIVE_ACTIONS_EXECUTE_URL = "https://api.cognitiveactions.com/actions/execute"

action_id = "1a3895e6-2b88-48a7-8346-414d7b1086bd" # Action ID for: Retrieve LinkedIn Recent Activity

# Construct the exact input payload based on the action's requirements
# This example uses the predefined example_input for this action:
payload = {}

headers = {
    "Authorization": f"Bearer {COGNITIVE_ACTIONS_API_KEY}",
    "Content-Type": "application/json",
    # Add any other required headers for the Cognitive Actions API
}

# Prepare the request body for the hypothetical execution endpoint
request_body = {
    "action_id": action_id,
    "inputs": payload
}

print(f"--- Calling Cognitive Action: {action.name or action_id} ---")
print(f"Endpoint: {COGNITIVE_ACTIONS_EXECUTE_URL}")
print(f"Action ID: {action_id}")
print("Payload being sent:")
print(json.dumps(request_body, indent=2))
print("------------------------------------------------")

try:
    response = requests.post(
        COGNITIVE_ACTIONS_EXECUTE_URL,
        headers=headers,
        json=request_body
    )
    response.raise_for_status() # Raise an exception for bad status codes (4xx or 5xx)

    result = response.json()
    print("Action executed successfully. Result:")
    print(json.dumps(result, indent=2))

except requests.exceptions.RequestException as e:
    print(f"Error executing action {action_id}: {e}")
    if e.response is not None:
        print(f"Response status: {e.response.status_code}")
        try:
            print(f"Response body: {e.response.json()}")
        except json.JSONDecodeError:
            print(f"Response body (non-JSON): {e.response.text}")
    print("------------------------------------------------")


## Extract Job Data from LinkedIn
The **Extract Job Data from LinkedIn** action enables developers to retrieve job listings based on specific filters like keywords, location, and company URL. This action supports pagination, allowing up to 10 pages of results, with 50 listings per page, making it possible to extract a comprehensive dataset of job opportunities.

### Input Requirements
To retrieve job listings, at least one of the following parameters must be provided: `keywords`, `location`, or `companyWebsite`. Additionally, you can specify the `page` number to navigate through the results.

### Expected Output
The API will return the job listings that match your criteria or a validation error if the required parameters are not met. This ensures that developers get relevant data tailored to their search needs.

### Use Cases for this specific action
- **Job Aggregation Platforms:** Create job boards that pull in listings from LinkedIn to provide users with a consolidated view of available jobs.
- **Market Research:** Analyze job trends and demands in specific locations or sectors by extracting and studying job data over time.
- **Personalized Job Recommendations:** Integrate this action into applications that suggest job opportunities based on user profiles or preferences.

import requests
import json

# Replace with your actual Cognitive Actions API key and endpoint
# Ensure your environment securely handles the API key
COGNITIVE_ACTIONS_API_KEY = "YOUR_COGNITIVE_ACTIONS_API_KEY"
# This endpoint URL is hypothetical and should be documented for users
COGNITIVE_ACTIONS_EXECUTE_URL = "https://api.cognitiveactions.com/actions/execute"

action_id = "d9dd87db-31d3-4a45-af4a-6503848bb442" # Action ID for: Extract Job Data from LinkedIn

# Construct the exact input payload based on the action's requirements
# This example uses the predefined example_input for this action:
payload = {
  "page": "1"
}

headers = {
    "Authorization": f"Bearer {COGNITIVE_ACTIONS_API_KEY}",
    "Content-Type": "application/json",
    # Add any other required headers for the Cognitive Actions API
}

# Prepare the request body for the hypothetical execution endpoint
request_body = {
    "action_id": action_id,
    "inputs": payload
}

print(f"--- Calling Cognitive Action: {action.name or action_id} ---")
print(f"Endpoint: {COGNITIVE_ACTIONS_EXECUTE_URL}")
print(f"Action ID: {action_id}")
print("Payload being sent:")
print(json.dumps(request_body, indent=2))
print("------------------------------------------------")

try:
    response = requests.post(
        COGNITIVE_ACTIONS_EXECUTE_URL,
        headers=headers,
        json=request_body
    )
    response.raise_for_status() # Raise an exception for bad status codes (4xx or 5xx)

    result = response.json()
    print("Action executed successfully. Result:")
    print(json.dumps(result, indent=2))

except requests.exceptions.RequestException as e:
    print(f"Error executing action {action_id}: {e}")
    if e.response is not None:
        print(f"Response status: {e.response.status_code}")
        try:
            print(f"Response body: {e.response.json()}")
        except json.JSONDecodeError:
            print(f"Response body (non-JSON): {e.response.text}")
    print("------------------------------------------------")


## Conclusion
The LinkedIn Profile and Job Data API provides powerful tools for developers looking to tap into rich professional data. By utilizing actions like retrieving recent activity and extracting job listings, you can create applications that not only enhance user engagement but also streamline job searching and recruitment processes. As you explore these capabilities, consider how they can be integrated into your projects to deliver greater value to users. Start leveraging this API today to unlock new opportunities in the world of professional networking and job data analysis.