Get LinkedIn Company

Description

This endpoint retrieves comprehensive company information from LinkedIn including company description, employee count, industry, location, recent posts, and key statistics. Perfect for business research, competitive analysis, and lead generation.

Endpoint

POST https://app.dumplingai.com/api/v1/linkedin/company

Headers

Content-Type: application/json
Authorization: Bearer <API_KEY> (required)

Request Body

{
  "url": "string" // Required. LinkedIn company URL
}

Responses

Success (200)

Returns comprehensive company information including posts, employee data, and company statistics.

{
  "success": true,
  "name": "Sustainable Energy Solutions",
  "image": "https://media.licdn.com/dms/image/v2/C4D0BAQGJHvkwKFxZug/company-logo_200_200/company-logo_200_200/0/1641234567890?e=2147483647&v=beta&t=abc123def456ghi789jkl012mno345pqr678stu901vwx",
  "description": "Leading renewable energy company specializing in solar and wind power solutions. We help businesses and communities transition to clean energy with innovative technology and sustainable practices. Founded in 2015, we've installed over 500MW of renewable energy capacity across North America.",
  "website": "https://sustainableenergysol.com",
  "industry": "Renewable Energy Semiconductor Manufacturing",
  "companySize": "201-500 employees",
  "companyType": "Privately Held",
  "founded": "2015",
  "headquarters": "Austin, Texas, United States",
  "specialties": [
    "Solar Energy",
    "Wind Power", 
    "Energy Storage",
    "Grid Integration",
    "Sustainability Consulting"
  ],
  "followers": 28453,
  "employees": [
    {
      "name": "Maria Rodriguez",
      "title": "Chief Technology Officer",
      "image": "https://media.licdn.com/dms/image/v2/C5603AQE9vXwkBFnTgQ/profile-displayphoto-shrink_400_400/profile-displayphoto-shrink_400_400/0/1633298765432?e=2147483647&v=beta&t=def456ghi789jkl012mno345pqr678stu",
      "linkedinUrl": "https://www.linkedin.com/in/maria-rodriguez-cto"
    },
    {
      "name": "James Park",
      "title": "VP of Engineering",
      "image": "https://media.licdn.com/dms/image/v2/C4E03AQHxFz2qW_sOVR/profile-displayphoto-shrink_400_400/profile-displayphoto-shrink_400_400/0/1629876543210?e=2147483647&v=beta&t=ghi789jkl012mno345pqr678stu901vwx",
      "linkedinUrl": "https://www.linkedin.com/in/james-park-engineering"
    }
  ],
  "recentPosts": [
    {
      "title": "Excited to announce our new solar panel efficiency breakthrough! Our latest research has achieved 24.5% efficiency in commercial-grade panels. This means more clean energy generation per square foot for our clients. 🌞⚡",
      "activityType": "Posted by Sustainable Energy Solutions",
      "link": "https://www.linkedin.com/posts/sustainable-energy-solutions_solar-cleanenergy-innovation-activity-7334567890123456789-zTP8",
      "image": "https://media.licdn.com/dms/image/v2/D4E22AQGKpfjyh-hbrA/feedshare-shrink_2048_1536/feedshare-shrink_2048_1536/0/1747234567890?e=2147483647&v=beta&t=jkl012mno345pqr678stu901vwx234yza",
      "engagement": {
        "likes": 847,
        "comments": 32,
        "shares": 156
      }
    },
    {
      "title": "Proud to be recognized as one of Austin's Top Green Employers for 2024! Our commitment to sustainability goes beyond our products - we're also carbon neutral in our operations and offer green commute incentives to all team members. 🌱",
      "activityType": "Posted by Sustainable Energy Solutions", 
      "link": "https://www.linkedin.com/posts/sustainable-energy-solutions_sustainability-greenemployer-austin-activity-7331234567890123456-jTB9",
      "image": "https://media.licdn.com/dms/image/v2/D4D22AQF8kpgth-icrB/feedshare-shrink_2048_1536/feedshare-shrink_2048_1536/0/1746987654321?e=2147483647&v=beta&t=mno345pqr678stu901vwx234yza567bcd",
      "engagement": {
        "likes": 1243,
        "comments": 58,
        "shares": 287
      }
    }
  ],
  "locations": [
    {
      "city": "Austin",
      "state": "Texas", 
      "country": "United States",
      "isHeadquarters": true,
      "employeeCount": "201-500"
    },
    {
      "city": "Denver",
      "state": "Colorado",
      "country": "United States", 
      "isHeadquarters": false,
      "employeeCount": "51-100"
    }
  ],
  "jobOpenings": [
    {
      "title": "Senior Solar Engineer",
      "location": "Austin, TX",
      "type": "Full-time",
      "postedDate": "2024-01-10",
      "url": "https://www.linkedin.com/jobs/view/3456789012"
    },
    {
      "title": "Renewable Energy Project Manager",
      "location": "Denver, CO", 
      "type": "Full-time",
      "postedDate": "2024-01-08",
      "url": "https://www.linkedin.com/jobs/view/3456789013"
    }
  ]
}

Content-Type: application/json
X-RateLimit-Limit: The rate limit for the user
X-RateLimit-Remaining: The remaining number of requests for the user

Bad Request (400)

Returned if the request is invalid or missing required parameters.

{
  "error": "'url' parameter is required and must be a non-empty string. Please provide a LinkedIn company URL."
}

Bad Gateway (502)

Returned if the external service is unavailable or returns invalid data.

{
  "error": "Failed to retrieve LinkedIn company information"
}

Internal Server Error (500)

Returned if there’s an unexpected server error.

{
  "error": "An unexpected server error occurred while fetching LinkedIn company information"
}

Example Request

curl -X POST https://app.dumplingai.com/api/v1/linkedin/company \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
  "url": "https://www.linkedin.com/company/sustainable-energy-solutions"
}'

Example Response

{
  "success": true,
  "name": "Sustainable Energy Solutions",
  "image": "https://media.licdn.com/dms/image/v2/C4D0BAQGJHvkwKFxZug/company-logo_200_200/company-logo_200_200/0/1641234567890?e=2147483647&v=beta&t=abc123def456ghi789jkl012mno345pqr678stu901vwx",
  "description": "Leading renewable energy company specializing in solar and wind power solutions. We help businesses and communities transition to clean energy with innovative technology and sustainable practices.",
  "website": "https://sustainableenergysol.com",
  "industry": "Renewable Energy Semiconductor Manufacturing",
  "companySize": "201-500 employees",
  "companyType": "Privately Held",
  "founded": "2015",
  "headquarters": "Austin, Texas, United States",
  "followers": 28453,
  "recentPosts": [
    {
      "title": "Excited to announce our new solar panel efficiency breakthrough! Our latest research has achieved 24.5% efficiency in commercial-grade panels.",
      "activityType": "Posted by Sustainable Energy Solutions",
      "link": "https://www.linkedin.com/posts/sustainable-energy-solutions_solar-cleanenergy-innovation-activity-7334567890123456789-zTP8"
    }
  ]
}

Notes

The url parameter must be a valid LinkedIn company URL (contains ‘linkedin.com/company/’)
This endpoint returns only publicly available company information
The response includes employee profiles, recent company posts, job openings, and office locations
Some company sections may be limited based on LinkedIn’s visibility settings
This endpoint uses 10 credits per request
Company data may vary based on privacy settings and available public information

Rate Limiting

Rate limit headers (X-RateLimit-Limit and X-RateLimit-Remaining) are included in the response to indicate the user’s current rate limit status.

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

url

string<uri>

required

Full LinkedIn company page URL (https://www.linkedin.com/company/...).

requestSource

enum<string>

Optional identifier describing where the API request originated.

Available options:

API,

WEB,

MAKE_DOT_COM,

ZAPIER,

N8N,

PLAYGROUND,

DEFAULT_AUTOMATION,

AGENT_PREVIEW,

AGENT_LIVE,

AUTOPILOT,

STUDIO

Response

LinkedIn company returned.

success

boolean

required

name

string

description

string | null

location

object

Show child attributes

employeeCount

integer | null

website

string<uri> | null

logo

string<uri> | null

slogan

string | null

posts

object[]

Show child attributes

industry

string | null

size

string | null

founded

integer | null

headquarters

string | null

type

string | null

specialties

string[]

employees

object[]

API Documentation

Endpoints

Description

Endpoint

Headers

Request Body

Responses

Success (200)

Bad Request (400)

Bad Gateway (502)

Internal Server Error (500)

Example Request

Example Response

Notes

Rate Limiting

Authorizations

Body

Response

API Documentation

Endpoints

​Description

​Endpoint

​Headers

​Request Body

​Responses

​Success (200)

​Bad Request (400)

​Bad Gateway (502)

​Internal Server Error (500)

​Example Request

​Example Response

​Notes

​Rate Limiting

Authorizations

Body

Response

Description

Endpoint

Headers

Request Body

Responses

Success (200)

Bad Request (400)

Bad Gateway (502)

Internal Server Error (500)

Example Request

Example Response

Notes

Rate Limiting