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 1 credit 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.