linkedin_data_max

🚀 LinkedIn Data API Documentation

Welcome to the LinkedIn Data API! This document provides detailed information on how to interact with our endpoints to retrieve valuable company and employee data from LinkedIn. All requests are authenticated using headers provided by RapidAPI.

🔑 Authentication

Authentication is required for all API endpoints. You must include the following headers in every request:

Header	Type	Required	Description
x-rapidapi-key	string	✅ Yes	Your personal key from your RapidAPI subscription.
x-rapidapi-host	string	✅ Yes	The API host: `linkedin-data-max.p.rapidapi.com`

🏢 1. Search for Companies

This endpoint allows you to search for LinkedIn companies using a variety of filters like keywords, domain names, founding year, and more. It supports sorting and pagination.

Method & Path: POST /api/linkedin/companies/search/

▶️ Request Body

Parameter	Type	Required	Description
search_word	string	✅ Yes	A keyword to search for companies (e.g., "ikea", "software").
domain_name	string	❌ No	The domain name of a company (e.g., "microsoft.com").
country_code	string	❌ No	A two-letter ISO 3166-1 alpha-2 country code (e.g., "US", "DE", "CN").
founded_time	integer	❌ No	The year the company was founded (e.g., 1975).
followers_total_sort_mode	string	❌ No	Sort results by the total number of followers. Can be `asc` or `desc`.
employees_total_sort_mode	string	❌ No	Sort results by the total number of employees. Can be `asc` or `desc`.
page_number	integer	❌ No	The page number for pagination. Defaults to 1.
page_size	integer	❌ No	The number of results per page. Defaults to 10. Max 20..

✅ Success Response (200 OK)

{
  "code": "integer",
  "result": {
    "search_word": "string",
    "founded_time": "integer | null",
    "country_code": "string | null",
    "page_number": "integer",
    "page_size": "integer",
    "total": "integer",
    "count": "integer",
    "data": [
      {
        "unique_name": "string",
        "unique_id": "integer",
        "name": "string",
        "image_url": "string (url)",
        "background_image_url": "string (url)",
        "followers_total": "integer",
        "employees_total": "integer",
        "slogan": "string",
        "industry": "string",
        "category_names": ["string"],
        "size": "string",
        "founded_time": "string",
        "website_url": "string (url)",
        "specialty_names": ["string"],
        "headquarters": "string",
        "country_code": "string",
        "country_name": "string",
        "addresses": ["string"],
        "description": "string",
        "url": "string (url)",
        "employees": [
          {
            "name": "string",
            "position": "string",
            "image_url": "string (url)",
            "unique_name": "string"
          }
        ],
        "affiliated_companies": [
          {
            "url": "string (url)",
            "name": "string",
            "image_url": "string (url)"
          }
        ],
        "similar_companies": [
          {
            "url": "string (url)",
            "name": "string",
            "image_url": "string (url)"
          }
        ]
      }
    ]
  },
  "message": "string"
}

ℹ️ 2. Get Company Details

This endpoint retrieves detailed information for a single company by providing its full LinkedIn URL.

Method & Path: POST /api/linkedin/company/

▶️ Request Body

Parameter	Type	Required	Description
url	string	✅ Yes	The company's unique identifier (e.g., "ikea", "microsoft"). or linkedin company url ( e.g.,"https://www.linkedin.com/company/ikea

✅ Success Response (200 OK)

{
  "code": "integer",
  "result": {
    "url": "string",
    "data": {
      "/* See the company object structure in the 'Search for Companies' response above */": true
    }
  },
  "message": "string"
}

🧑‍💼 3. Search for Company Employees

This endpoint fetches a paginated list of employees for a specific company using its unique name (also known as the vanity name).

Method & Path: POST /api/linkedin/company/employees/search/

▶️ Request Body

Parameter	Type	Required	Description
unique_name	string	✅ Yes	The company's unique identifier (e.g., "ikea", "microsoft"). or linkedin company url ( e.g.,"https://www.linkedin.com/company/ikea
page_number	integer	❌ No	The page number for pagination. Defaults to 1.
page_size	integer	❌ No	The number of employees per page. Defaults to 10. Max 20.

✅ Success Response (200 OK)

{
  "code": "integer",
  "result": {
    "unique_name": "string",
    "page_number": "integer",
    "page_size": "integer",
    "total": "integer",
    "count": "integer",
    "data": [
      {
        "name": "string",
        "position": "string",
        "image_url": "string (url)",
        "url": "string (url)"
      }
    ]
  },
  "message": "string"
}