Company

Cost: 1 credit / successful request. (Extra charges might be incurred if premium optional parameters are used. Please read the description of the parameters that you intend to use)

Get structured data of a Company Profile


POST/api/v1/linkedin/company

Company Profile Endpoint

This endpoint allows you to get structured data of a LinkedIn Company Profile.

Required attributes

  • Name
    url
    Type
    string
    Description

    The LinkedIn url of the company.

  • Name
    use_cache
    Type
    string
    Description

    Alters the caching behaviour.

    • if-present The default behavior. Fetches profile from cache regardless of age of profile. If profile is not available in cache, API will attempt to source profile externally.
    • if-recent - API will make a best effort to return a fresh profile no older than 29 days.
    • never - Do not ever read profile from cache.

Optional attributes

  • Name
    lang
    Type
    string
    Description

    The language in which you need your response.

Request

POST
/v1/linkedin/company
  curl --location --request POST 'https://api.datamagnet.co/api/v1/linkedin/company' \
  --header 'Authorization: Bearer {token}' \
  --header 'Content-Type: application/json' \
  --data-raw '{
      "url": "https://linkedin.com/company/apple"
  }'

Response

{
"message": {
"affiliated_pages_data": [],
"background_cover_image_url": null,
"company_id": "162479",
"company_name": "Apple",
"company_type": "Public Company",
"description": "We’re a diverse collective of thinkers and doers, continually reimagining what’s possible to help us all do what we love in new ways. And the same innovation that goes into our products also applies to our practices — strengthening our commitment to leave the world better than we found it. This is where your work can make a difference in people’s lives. Including your own.\n\nApple is an equal opportunity employer that is committed to inclusion and diversity. Visit apple.com/careers to learn more.",
"employees": "299,940",
"followers": "19,002,500",
"founded_year": null,
"headcount": "10,001+ employees",
"hq_address": {
  "is_hq": true,
  "line_1": "1 Apple Park Way",
  "line_2": "Cupertino, California 95014, US"
},
"industry": "Computers and Electronics Manufacturing",
"location": "Cupertino, California",
"profile_pic_url": null,
"similar_pages_data": [
  {
    "industry": "Software Development",
    "link": "https://www.linkedin.com/company/google?trk=similar-pages",
    "location": "Mountain View, CA",
    "name": "Google"
  },
  {
    "industry": "Software Development",
    "link": "https://www.linkedin.com/company/amazon?trk=similar-pages",
    "location": "Seattle, WA",
    "name": "Amazon"
  },
  {
    "industry": "Software Development",
    "link": "https://www.linkedin.com/company/microsoft?trk=similar-pages",
    "location": "Redmond, Washington",
    "name": "Microsoft"
  },
  {
    "industry": "Entertainment Providers",
    "link": "https://www.linkedin.com/company/netflix?trk=similar-pages",
    "location": "Los Gatos, CA",
    "name": "Netflix"
  },
  {
    "industry": "Software Development",
    "link": "https://www.linkedin.com/company/meta?trk=similar-pages",
    "location": "Menlo Park, CA",
    "name": "Meta"
  },
  {
    "industry": "Motor Vehicle Manufacturing",
    "link": "https://www.linkedin.com/company/tesla-motors?trk=similar-pages",
    "location": "Austin, Texas",
    "name": "Tesla"
  },
  {
    "industry": "Musicians",
    "link": "https://se.linkedin.com/company/spotify?trk=similar-pages",
    "location": "Stockholm, Stockholm County",
    "name": "Spotify"
  },
  {
    "industry": "IT Services and IT Consulting",
    "link": "https://www.linkedin.com/company/ibm?trk=similar-pages",
    "location": "Armonk, New York, NY",
    "name": "IBM"
  },
  {
    "industry": "Software Development",
    "link": "https://www.linkedin.com/company/linkedin?trk=similar-pages",
    "location": "Sunnyvale, CA",
    "name": "LinkedIn"
  },
  {
    "industry": "Computers and Electronics Manufacturing",
    "link": "https://kr.linkedin.com/company/samsung-electronics?trk=similar-pages",
    "location": "Suwon-Si, Gyeonggi-Do",
    "name": "Samsung Electronics"
  }
],
"specialities": [
  "Innovative Product Development",
  "World-Class Operations",
  "Retail",
  "Telephone Support"
],
"tagline": null,
"universal_name_id": "apple",
"update_data": [],
"website": "http://www.apple.com/careers"
}
}

The Company Model

It contains all the attributes of an company LinkedIn open profile.

Properties

  • Name
    company_name
    Type
    string
    Description

    The name of the company.

  • Name
    affiliated_pages_data
    Type
    list
    Description

    List of Affiliated Company.

  • Name
    background_cover_image_url
    Type
    string
    Description

    The URL of the company's background cover image.

  • Name
    company_id
    Type
    string
    Description

    LinkedIn's Internal and immutable ID of this Company profile.

  • Name
    company_type
    Type
    string
    Description

    Possible values:

    EDUCATIONAL: Educational Institution

    GOVERNMENT_AGENCY : Government Agency

    NON_PROFIT: Nonprofit

    PARTNERSHIP: Partnership

    PRIVATELY_HELD: Privately Held

    PUBLIC_COMPANY: Public Company

    SELF_EMPLOYED: Self-Employed

    SELF_OWNED: Sole Proprietorship

  • Name
    description
    Type
    string
    Description

    A textual description of the company.

  • Name
    employees
    Type
    list
    Description

    The size of the company as indicated on LinkedIn.

  • Name
    followers
    Type
    string
    Description

    Followers of the company.

  • Name
    founded_year
    Type
    string
    Description

    Founded year of the company.

  • Name
    headcount
    Type
    string
    Description

    Sequenceed range of company head count.

  • Name
    hq_address
    Type
    dict
    Description

    A Company Location object

  • Name
    industry
    Type
    string
    Description

    The industry attribute, found in a LinkedIn Company profile, describes the industry in which the company operates. The value of this attribute is an enumerator.

  • Name
    location
    Type
    string
    Description

    Location of the company.

  • Name
    profile_pic_url
    Type
    string
    Description

    The URL of the company's profile picture.

  • Name
    similar_pages_data
    Type
    list
    Description

    List of Similar Company.

  • Name
    specialities
    Type
    list
    Description

    A list of specialities.

  • Name
    tagline
    Type
    string
    Description

    A short, catchy phrase that represents the company's mission or brand.

  • Name
    universal_name_id
    Type
    string
    Description

    A unique numerical identifier for the company used in the LinkedIn platform.

  • Name
    update_data
    Type
    list
    Description

    List of Company Updates.

  • Name
    website
    Type
    string
    Description

    Website of the company.