> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dumplingai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get LinkedIn Company

> Retrieve company profile metadata, size, and industry information from LinkedIn.

## 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

```json theme={null}
{
  "url": "string" // Required. LinkedIn company URL
}
```

## Responses

### Success (200)

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

```json theme={null}
{
  "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.

```json theme={null}
{
  "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.

```json theme={null}
{
  "error": "Failed to retrieve LinkedIn company information"
}
```

### Internal Server Error (500)

Returned if there's an unexpected server error.

```json theme={null}
{
  "error": "An unexpected server error occurred while fetching LinkedIn company information"
}
```

## Example Request

```bash theme={null}
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

```json theme={null}
{
  "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.


## OpenAPI

````yaml POST /api/v1/linkedin/company
openapi: 3.0.3
info:
  title: DumplingAI API
  version: 1.0.0
  description: >
    REST API for DumplingAI's content intelligence and automation platform.

    All endpoints are grouped under `/api/v1`; most are secured via Bearer API
    keys unless an operation explicitly sets `security: []`.
servers:
  - url: https://app.dumplingai.com
    description: Production
security:
  - bearerAuth: []
tags:
  - name: YouTube
    description: Access metadata, search results, and transcripts from YouTube.
  - name: TikTok
    description: Retrieve TikTok profile, video, follower, and transcript data.
  - name: LinkedIn
    description: Programmatically fetch LinkedIn company and profile data.
  - name: Search
    description: Search-orientated endpoints spanning web, news, maps, and autocomplete.
  - name: Google
    description: Integrations with Google business listings and location data.
  - name: Scraping
    description: Webpage capture, crawling, and structured content extraction utilities.
  - name: Documents
    description: Document processing, conversion, and metadata utilities.
  - name: AI
    description: DumplingAI agent and knowledge base endpoints.
  - name: Developer Tools
    description: Utilities for executing sandboxed code via API.
paths:
  /api/v1/linkedin/company:
    post:
      tags:
        - LinkedIn
      summary: Get LinkedIn company
      description: >-
        Retrieve company profile metadata, size, and industry information from
        LinkedIn.
      operationId: getLinkedInCompany
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/LinkedInCompanyRequest'
            examples:
              default:
                value:
                  url: https://www.linkedin.com/company/checkboxai/
      responses:
        '200':
          description: LinkedIn company returned.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LinkedInCompanyResponse'
        '400':
          description: Invalid request payload.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Missing or invalid API key.
        '500':
          description: Unexpected server error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  schemas:
    LinkedInCompanyRequest:
      type: object
      required:
        - url
      properties:
        url:
          type: string
          format: uri
          description: >-
            Full LinkedIn company page URL
            (`https://www.linkedin.com/company/...`).
        requestSource:
          $ref: '#/components/schemas/RequestSource'
      additionalProperties: false
    LinkedInCompanyResponse:
      type: object
      properties:
        success:
          type: boolean
        name:
          type: string
        description:
          type: string
          nullable: true
        location:
          type: object
          properties:
            city:
              type: string
              nullable: true
            state:
              type: string
              nullable: true
            country:
              type: string
              nullable: true
          additionalProperties: false
        employeeCount:
          type: integer
          nullable: true
        website:
          type: string
          format: uri
          nullable: true
        logo:
          type: string
          format: uri
          nullable: true
        slogan:
          type: string
          nullable: true
        posts:
          type: array
          items:
            type: object
            properties:
              url:
                type: string
                format: uri
              datePublished:
                type: string
                nullable: true
              text:
                type: string
                nullable: true
            required:
              - url
            additionalProperties: false
        industry:
          type: string
          nullable: true
        size:
          type: string
          nullable: true
        founded:
          type: integer
          nullable: true
        headquarters:
          type: string
          nullable: true
        type:
          type: string
          nullable: true
        specialties:
          type: array
          items:
            type: string
        employees:
          type: array
          items:
            type: object
            additionalProperties: true
      required:
        - success
      additionalProperties: true
    ErrorResponse:
      type: object
      properties:
        error:
          type: string
          description: Human-readable description of what went wrong.
      required:
        - error
    RequestSource:
      type: string
      description: Optional identifier describing where the API request originated.
      enum:
        - API
        - WEB
        - MAKE_DOT_COM
        - ZAPIER
        - N8N
        - PLAYGROUND
        - DEFAULT_AUTOMATION
        - AGENT_PREVIEW
        - AGENT_LIVE
        - AUTOPILOT
        - STUDIO
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key

````