GET
/
api
/
v2
/
linkedin
/
company
/
info
curl --request GET \
  --url https://piloterr.com/api/v2/linkedin/company/info \
  --header 'x-api-key: <x-api-key>'
{
    "posts": [
        {
            "post_id": "7222239188585238528",
            "post_url": "https://www.linkedin.com/posts/ferrari_ferraritour-newzealand-ferrari166inter-activity-7222239188585238528-lood"
        },
        {
            "post_id": "7241460929186385922",
            "post_url": "https://www.linkedin.com/posts/ferrari_the-unmistakable-sound-of-twelve-activity-7241460929186385922-NApf"
        },
        {
            "post_id": "7241385066130489344",
            "post_url": "https://www.linkedin.com/posts/ferrari_maranello-ferrariraces-ferrarihypercar-activity-7241385066130489344-bQt8"
        },
        {
            "post_id": "7241053168724267008",
            "post_url": "https://www.linkedin.com/posts/ferrari_ferrari296gtb-drivingferrari-switzerland-activity-7241053168724267008-amNH"
        },
        {
            "post_id": "7240686858039422976",
            "post_url": "https://www.linkedin.com/posts/ferrari_ferrarisf90stradale-assettofiorano-pistadifiorano-activity-7240686858039422976-5L8s"
        },
        {
            "post_id": "7240283094094647296",
            "post_url": "https://www.linkedin.com/posts/ferrari_ferraritailormade-ferrari812competizione-activity-7240283094094647296-9nmJ"
        },
        {
            "post_id": "7239951723086200833",
            "post_url": "https://www.linkedin.com/posts/ferrari_magical-monza-activity-7239951723086200833-ZDZY"
        },
        {
            "post_id": "7239247702687924224",
            "post_url": "https://www.linkedin.com/posts/ferrari_home-activity-7239247702687924224-A2dA"
        },
        {
            "post_id": "7238893944317595649",
            "post_url": "https://www.linkedin.com/posts/ferrari_a-special-relationship-activity-7238893944317595649-mKe8"
        },
        {
            "post_id": "7238524099059216384",
            "post_url": "https://www.linkedin.com/posts/ferrari_ferrariromaspider-lanuovadolcevita-aranya-activity-7238524099059216384-MrDD"
        }
    ],
    "founded": 1947,
    "tagline": "Ferrari, Italian excellence that makes the world dream.",
    "website": "http://www.ferrari.com",
    "industry": "Motor Vehicle Manufacturing",
    "logo_url": "https://media.licdn.com/dms/image/v2/C4E0BAQFQWtQAnYFMEA/company-logo_200_200/company-logo_200_200/0/1630655008326/ferrari_logo?e=2147483647&v=beta&t=FZyFfc6-ZOFhE715KLI-YtJBbLwDW3Zb3UYf8rNKrjs",
    "employees": [
        {
            "name": "Guido Bolognesi",
            "profile_url": "https://it.linkedin.com/in/guidob"
        },
        {
            "name": "Marco Villa",
            "profile_url": "https://ae.linkedin.com/in/marvilla"
        },
        {
            "name": "Nicola Canalini",
            "profile_url": "https://it.linkedin.com/in/nicolacanalini"
        },
        {
            "name": "Louis Colmache",
            "profile_url": "https://www.linkedin.com/in/louis-colmache-ab626a"
        }
    ],
    "locations": [
        "Abetone inferiore Maranello, MO 41053, IT",
        "via Abetone inferiore n°4 Modena, MO 41100, IT"
    ],
    "company_id": 7050,
    "company_url": "https://it.linkedin.com/company/ferrari",
    "description": "Ferrari's story officially began in 1947 when its first road car, the 125 S, emerged from the gate of no. 4 Via Abetone Inferiore in Maranello. The iconic two-seater went on to win the Rome Grand Prix later that year and shortly thereafter was developed into a refined GT roadster. The company has travelled a long way since then, but its mission has remained unaltered: to make unique sports cars that represent the finest in Italian design and craftsmanship, both on the track and on the road. \r\n\r\nThe very definition of excellence and sportiness, Ferrari needs no introduction.  Its principal calling card is the numerous Formula One titles it has won: a total of 16 constructors’ championships and 15 drivers’ championships. And of course, there is the impressive lineup of legendary GT models. Cars that are unique for their design, technology and luxurious styling and that represent the best in Italian the world over.",
    "headquarter": {
        "city": "Maranello",
        "line1": "Abetone inferiore",
        "country": "IT",
        "postal_code": "41053"
    },
    "staff_count": 10951,
    "staff_range": "over-10k",
    "company_name": "Ferrari",
    "specialities": [
        "automotive",
        "racing",
        "retail",
        "innovation",
        "luxury",
        "italy",
        "exclusivity",
        "design",
        "engineering",
        "merchandising",
        "restauration",
        "Formula 1"
    ],
    "follower_count": 2137342,
    "similar_companies": [
        {
            "company_url": "https://it.linkedin.com/company/automobili-lamborghini-s-p-a-",
            "company_logo": "https://media.licdn.com/dms/image/v2/D4D0BAQEoeIftWmk9kg/company-logo_100_100/company-logo_100_100/0/1711616998971/automobili_lamborghini_s_p_a__logo?e=2147483647&v=beta&t=ZvwkS6wVlf8kC3CkSvGEkx7aonTusnNguMf_LaZcqSo",
            "company_name": "Automobili Lamborghini S.p.A."
        },
        {
            "company_url": "https://it.linkedin.com/company/maserati",
            "company_logo": "https://media.licdn.com/dms/image/v2/D4D0BAQEurI73f3jzTg/company-logo_100_100/company-logo_100_100/0/1718890729882/maserati_logo?e=2147483647&v=beta&t=j5_H94G3KDWw_bjbHXkqtEh9fXnSwD5YkcQjzCQJprs",
            "company_name": "Maserati"
        },
        {
            "company_url": "https://uk.linkedin.com/company/mercedes-amg-petronas-formula-one-team",
            "company_logo": "https://media.licdn.com/dms/image/v2/D4E0BAQFvlRruNIWchg/company-logo_100_100/company-logo_100_100/0/1719919661671/mercedes_amg_petronas_formula_one_team_logo?e=2147483647&v=beta&t=rdSJ_-zj5RHk-3fS72y2hY-KtEnnv1GT2wFR4Cax1UM",
            "company_name": "Mercedes-AMG PETRONAS Formula One Team"
        },
        {
            "company_url": "https://uk.linkedin.com/company/red-bull-racing",
            "company_logo": "https://media.licdn.com/dms/image/v2/D4E0BAQE-CZvfDBe9Ow/company-logo_100_100/company-logo_100_100/0/1715159556111/red_bull_racing_logo?e=2147483647&v=beta&t=rYFPrDWnPmzVVx7d5X2G33o6QTt0xnXIPnzkbKYCnzg",
            "company_name": "Red Bull Racing & Red Bull Technology"
        },
        {
            "company_url": "https://uk.linkedin.com/company/mclaren-racing-ltd",
            "company_logo": "https://media.licdn.com/dms/image/v2/D4E0BAQHdtxfr5qwepA/company-logo_100_100/company-logo_100_100/0/1719256699035/mclaren_racing_ltd_logo?e=2147483647&v=beta&t=93slqq0jyQAZp_coE_kC0HWDSaK4LpvNeXgdU0yWKdg",
            "company_name": "McLaren Racing"
        },
        {
            "company_url": "https://de.linkedin.com/company/porsche-ag",
            "company_logo": "https://media.licdn.com/dms/image/v2/D4E0BAQF2AxUTFOSHVw/company-logo_100_100/company-logo_100_100/0/1686553470700/porsche_ag_logo?e=2147483647&v=beta&t=7o9Rg2bJgkQfb8-JhzNAlgoxvv8Xznmoh8mOJrDLqoM",
            "company_name": "Porsche AG"
        },
        {
            "company_url": "https://uk.linkedin.com/company/formula-one-management-ltd",
            "company_logo": "https://media.licdn.com/dms/image/v2/C4E0BAQFWSixZ1i2flA/company-logo_100_100/company-logo_100_100/0/1673277040717/formula_one_management_ltd_logo?e=2147483647&v=beta&t=l4TbvsOIIoT8Admzu1TmdCY2dXyYzxgeTMkXIsKnwOs",
            "company_name": "Formula 1"
        },
        {
            "company_url": "https://uk.linkedin.com/company/astonmartinf1",
            "company_logo": "https://media.licdn.com/dms/image/v2/C4E0BAQF25ZtO52noqA/company-logo_100_100/company-logo_100_100/0/1663691026786/astonmartinf1_logo?e=2147483647&v=beta&t=pMqVt7aQe8-3OxRoLhdpzEuKebT7DvECP5F8r_cFk8Y",
            "company_name": "Aston Martin F1 Team"
        },
        {
            "company_url": "https://de.linkedin.com/company/bmw-group",
            "company_logo": "https://media.licdn.com/dms/image/v2/D4D0BAQG-ty2ieqUafw/company-logo_100_100/company-logo_100_100/0/1719814324897/bmw_group_logo?e=2147483647&v=beta&t=vRetRwwK0dEtduLkaoSvKXUlUGzb9uchDh07bkoM6zw",
            "company_name": "BMW Group"
        },
        {
            "company_url": "https://de.linkedin.com/company/audi-ag",
            "company_logo": "https://media.licdn.com/dms/image/v2/C4D0BAQHrHaKN5CBcdA/company-logo_100_100/company-logo_100_100/0/1631313033092?e=2147483647&v=beta&t=yLqlouZMFucYjbi0D_v0ku0m4navZ1WLvBrPAWQR8hs",
            "company_name": "AUDI AG"
        }
    ],
    "affiliated_companies": [
        {
            "company_url": "https://it.linkedin.com/showcase/scuderiaferrari/",
            "company_logo": "https://media.licdn.com/dms/image/v2/C4D0BAQECpFT8H5ZWAw/company-logo_100_100/company-logo_100_100/0/1638281799373?e=2147483647&v=beta&t=HVdWHW_agPr5f8MsLkaSrBWl3WPHJfbZbewI7x8IRSA",
            "company_name": "Scuderia Ferrari"
        }
    ]
}
x-api-key
string
required

This parameter specifies the private key you’ll need for Piloterr access.

Parameters

query
string

Linkedin Company URL or Username or ID of the target company like ferrari, https://it.linkedin.com/company/ferrari, 7050.

domain
string

A domain name to search for a company (reverse website lookup) like guideflow.com, https://www.guideflow.com

Either use the Query parameter or the Domain parameter. You cannot use both at the same time.

Parameters Explanation

The query parameter is used to specify the target company for which you want to retrieve information. It can take different forms:

  • LinkedIn Username: You can provide the LinkedIn username of the company. For example, ferrari.
  • LinkedIn URL: You can directly provide the LinkedIn company URL. For example, https://it.linkedin.com/company/ferrari.
  • Company ID: You can also use the LinkedIn company ID. For example, 7050.

This parameter is required and helps to accurately identify the company you are interested in.

The domain parameter allows you to perform a reverse website lookup. By providing a domain name, you can search for the company associated with that domain. This can be useful if you have the company’s website but not their LinkedIn information. For example, guideflow.com or https://www.guideflow.com.

Example Usage

  • To search for Ferrari using the LinkedIn username:

    GET /api/v2/linkedin/company/info?query=ferrari
    
  • To search for Ferrari using the company ID:

    GET /api/v2/linkedin/company/info?query=7050
    
  • To perform a reverse website lookup for guideflow.com:

    GET /api/v2/linkedin/company/info?domain=guideflow.com
    

These parameters ensure flexibility in how you can identify and retrieve information about companies from LinkedIn, either through direct LinkedIn identifiers or by leveraging the company’s domain.

Response

company
Company Object
company_id
number

The ID of the company

company_url
string

The URL of the company’s LinkedIn page

company_name
string

The name of the company

logo_url
string

The URL of the company’s logo image

website
string

The company’s website URL

specialities
array

The specialities or areas of expertise of the company

industry
string

The company’s industry sector

tagline
string

The company’s tagline or slogan

description
string

The company’s description or summary

founded
number

The year the company was founded

staff_range
string

The range of staff count: 1-10, 10-50, 50-200, 200-500, 1k-5k, 5k-10k, over-10k

staff_count
number

The number of staff members in the company

follower_count
number

The number of followers of the company

headquarter
object

The company’s headquarter address information

locations
array

The company’s various locations

affiliated_companies
array

The affiliated companies associated with the company

similar_companies
array

The similar companies associated with the company

employees
array

The employees of the company

posts
array

The last 10 posts of the company

{
    "posts": [
        {
            "post_id": "7222239188585238528",
            "post_url": "https://www.linkedin.com/posts/ferrari_ferraritour-newzealand-ferrari166inter-activity-7222239188585238528-lood"
        },
        {
            "post_id": "7241460929186385922",
            "post_url": "https://www.linkedin.com/posts/ferrari_the-unmistakable-sound-of-twelve-activity-7241460929186385922-NApf"
        },
        {
            "post_id": "7241385066130489344",
            "post_url": "https://www.linkedin.com/posts/ferrari_maranello-ferrariraces-ferrarihypercar-activity-7241385066130489344-bQt8"
        },
        {
            "post_id": "7241053168724267008",
            "post_url": "https://www.linkedin.com/posts/ferrari_ferrari296gtb-drivingferrari-switzerland-activity-7241053168724267008-amNH"
        },
        {
            "post_id": "7240686858039422976",
            "post_url": "https://www.linkedin.com/posts/ferrari_ferrarisf90stradale-assettofiorano-pistadifiorano-activity-7240686858039422976-5L8s"
        },
        {
            "post_id": "7240283094094647296",
            "post_url": "https://www.linkedin.com/posts/ferrari_ferraritailormade-ferrari812competizione-activity-7240283094094647296-9nmJ"
        },
        {
            "post_id": "7239951723086200833",
            "post_url": "https://www.linkedin.com/posts/ferrari_magical-monza-activity-7239951723086200833-ZDZY"
        },
        {
            "post_id": "7239247702687924224",
            "post_url": "https://www.linkedin.com/posts/ferrari_home-activity-7239247702687924224-A2dA"
        },
        {
            "post_id": "7238893944317595649",
            "post_url": "https://www.linkedin.com/posts/ferrari_a-special-relationship-activity-7238893944317595649-mKe8"
        },
        {
            "post_id": "7238524099059216384",
            "post_url": "https://www.linkedin.com/posts/ferrari_ferrariromaspider-lanuovadolcevita-aranya-activity-7238524099059216384-MrDD"
        }
    ],
    "founded": 1947,
    "tagline": "Ferrari, Italian excellence that makes the world dream.",
    "website": "http://www.ferrari.com",
    "industry": "Motor Vehicle Manufacturing",
    "logo_url": "https://media.licdn.com/dms/image/v2/C4E0BAQFQWtQAnYFMEA/company-logo_200_200/company-logo_200_200/0/1630655008326/ferrari_logo?e=2147483647&v=beta&t=FZyFfc6-ZOFhE715KLI-YtJBbLwDW3Zb3UYf8rNKrjs",
    "employees": [
        {
            "name": "Guido Bolognesi",
            "profile_url": "https://it.linkedin.com/in/guidob"
        },
        {
            "name": "Marco Villa",
            "profile_url": "https://ae.linkedin.com/in/marvilla"
        },
        {
            "name": "Nicola Canalini",
            "profile_url": "https://it.linkedin.com/in/nicolacanalini"
        },
        {
            "name": "Louis Colmache",
            "profile_url": "https://www.linkedin.com/in/louis-colmache-ab626a"
        }
    ],
    "locations": [
        "Abetone inferiore Maranello, MO 41053, IT",
        "via Abetone inferiore n°4 Modena, MO 41100, IT"
    ],
    "company_id": 7050,
    "company_url": "https://it.linkedin.com/company/ferrari",
    "description": "Ferrari's story officially began in 1947 when its first road car, the 125 S, emerged from the gate of no. 4 Via Abetone Inferiore in Maranello. The iconic two-seater went on to win the Rome Grand Prix later that year and shortly thereafter was developed into a refined GT roadster. The company has travelled a long way since then, but its mission has remained unaltered: to make unique sports cars that represent the finest in Italian design and craftsmanship, both on the track and on the road. \r\n\r\nThe very definition of excellence and sportiness, Ferrari needs no introduction.  Its principal calling card is the numerous Formula One titles it has won: a total of 16 constructors’ championships and 15 drivers’ championships. And of course, there is the impressive lineup of legendary GT models. Cars that are unique for their design, technology and luxurious styling and that represent the best in Italian the world over.",
    "headquarter": {
        "city": "Maranello",
        "line1": "Abetone inferiore",
        "country": "IT",
        "postal_code": "41053"
    },
    "staff_count": 10951,
    "staff_range": "over-10k",
    "company_name": "Ferrari",
    "specialities": [
        "automotive",
        "racing",
        "retail",
        "innovation",
        "luxury",
        "italy",
        "exclusivity",
        "design",
        "engineering",
        "merchandising",
        "restauration",
        "Formula 1"
    ],
    "follower_count": 2137342,
    "similar_companies": [
        {
            "company_url": "https://it.linkedin.com/company/automobili-lamborghini-s-p-a-",
            "company_logo": "https://media.licdn.com/dms/image/v2/D4D0BAQEoeIftWmk9kg/company-logo_100_100/company-logo_100_100/0/1711616998971/automobili_lamborghini_s_p_a__logo?e=2147483647&v=beta&t=ZvwkS6wVlf8kC3CkSvGEkx7aonTusnNguMf_LaZcqSo",
            "company_name": "Automobili Lamborghini S.p.A."
        },
        {
            "company_url": "https://it.linkedin.com/company/maserati",
            "company_logo": "https://media.licdn.com/dms/image/v2/D4D0BAQEurI73f3jzTg/company-logo_100_100/company-logo_100_100/0/1718890729882/maserati_logo?e=2147483647&v=beta&t=j5_H94G3KDWw_bjbHXkqtEh9fXnSwD5YkcQjzCQJprs",
            "company_name": "Maserati"
        },
        {
            "company_url": "https://uk.linkedin.com/company/mercedes-amg-petronas-formula-one-team",
            "company_logo": "https://media.licdn.com/dms/image/v2/D4E0BAQFvlRruNIWchg/company-logo_100_100/company-logo_100_100/0/1719919661671/mercedes_amg_petronas_formula_one_team_logo?e=2147483647&v=beta&t=rdSJ_-zj5RHk-3fS72y2hY-KtEnnv1GT2wFR4Cax1UM",
            "company_name": "Mercedes-AMG PETRONAS Formula One Team"
        },
        {
            "company_url": "https://uk.linkedin.com/company/red-bull-racing",
            "company_logo": "https://media.licdn.com/dms/image/v2/D4E0BAQE-CZvfDBe9Ow/company-logo_100_100/company-logo_100_100/0/1715159556111/red_bull_racing_logo?e=2147483647&v=beta&t=rYFPrDWnPmzVVx7d5X2G33o6QTt0xnXIPnzkbKYCnzg",
            "company_name": "Red Bull Racing & Red Bull Technology"
        },
        {
            "company_url": "https://uk.linkedin.com/company/mclaren-racing-ltd",
            "company_logo": "https://media.licdn.com/dms/image/v2/D4E0BAQHdtxfr5qwepA/company-logo_100_100/company-logo_100_100/0/1719256699035/mclaren_racing_ltd_logo?e=2147483647&v=beta&t=93slqq0jyQAZp_coE_kC0HWDSaK4LpvNeXgdU0yWKdg",
            "company_name": "McLaren Racing"
        },
        {
            "company_url": "https://de.linkedin.com/company/porsche-ag",
            "company_logo": "https://media.licdn.com/dms/image/v2/D4E0BAQF2AxUTFOSHVw/company-logo_100_100/company-logo_100_100/0/1686553470700/porsche_ag_logo?e=2147483647&v=beta&t=7o9Rg2bJgkQfb8-JhzNAlgoxvv8Xznmoh8mOJrDLqoM",
            "company_name": "Porsche AG"
        },
        {
            "company_url": "https://uk.linkedin.com/company/formula-one-management-ltd",
            "company_logo": "https://media.licdn.com/dms/image/v2/C4E0BAQFWSixZ1i2flA/company-logo_100_100/company-logo_100_100/0/1673277040717/formula_one_management_ltd_logo?e=2147483647&v=beta&t=l4TbvsOIIoT8Admzu1TmdCY2dXyYzxgeTMkXIsKnwOs",
            "company_name": "Formula 1"
        },
        {
            "company_url": "https://uk.linkedin.com/company/astonmartinf1",
            "company_logo": "https://media.licdn.com/dms/image/v2/C4E0BAQF25ZtO52noqA/company-logo_100_100/company-logo_100_100/0/1663691026786/astonmartinf1_logo?e=2147483647&v=beta&t=pMqVt7aQe8-3OxRoLhdpzEuKebT7DvECP5F8r_cFk8Y",
            "company_name": "Aston Martin F1 Team"
        },
        {
            "company_url": "https://de.linkedin.com/company/bmw-group",
            "company_logo": "https://media.licdn.com/dms/image/v2/D4D0BAQG-ty2ieqUafw/company-logo_100_100/company-logo_100_100/0/1719814324897/bmw_group_logo?e=2147483647&v=beta&t=vRetRwwK0dEtduLkaoSvKXUlUGzb9uchDh07bkoM6zw",
            "company_name": "BMW Group"
        },
        {
            "company_url": "https://de.linkedin.com/company/audi-ag",
            "company_logo": "https://media.licdn.com/dms/image/v2/C4D0BAQHrHaKN5CBcdA/company-logo_100_100/company-logo_100_100/0/1631313033092?e=2147483647&v=beta&t=yLqlouZMFucYjbi0D_v0ku0m4navZ1WLvBrPAWQR8hs",
            "company_name": "AUDI AG"
        }
    ],
    "affiliated_companies": [
        {
            "company_url": "https://it.linkedin.com/showcase/scuderiaferrari/",
            "company_logo": "https://media.licdn.com/dms/image/v2/C4D0BAQECpFT8H5ZWAw/company-logo_100_100/company-logo_100_100/0/1638281799373?e=2147483647&v=beta&t=HVdWHW_agPr5f8MsLkaSrBWl3WPHJfbZbewI7x8IRSA",
            "company_name": "Scuderia Ferrari"
        }
    ]
}