Companies Linkedin API

Description

Lookup the linkedin account with all of its associated metadata for over 24M+ international businesses.

Bulk Data Download:

If you need a complete data dump of our entire Companies Linkedin database, reach out to us. We offer that as a separate service option. Trying to scrape our APIs is not recommended as you'll end up consuming your monthly request allowance.

Endpoint

> GET https://api.jsonrepo.com/v1/knowledge/social/companieslinkedin

Headers

Field	Description
api_key	`Required` Your API Key

Parameters

Field	Type	Description
name	String	`Optional` The name of the company (case insensitive)
size	String	`Optional` The number of employees in the company Accepted values: `micro` => 10 employees or less `small` => 50 employees or less `medium` => 250 employees or less `large` => 250 employees or more
country	String	`Optional` The country of origin (case insensitive) Accepts: `ISO a-2` Example: `US`
limit	Integer	`Optional` Number of results `Default: 20` `Range: 1 <= limit <= 50`

Random Lookup:

If none of the optional search parameters are provided, the endpoint will return limit number of random companies.

Parameter Interaction:

If multiple optional fields are provided, an AND operation will be executed which substantially reduces the search space.

Search Strictness:

Our Companies database is very large. Aggregated from a variety of public domain sources and contains 24M+ records. For search to be effective and return appropriate results rather than unexpected hits that just might happen to match your search term partially, we've decided to implement a strict search policy for the name parameter. That means when providing a name parameter, only the records that start with your input will be searched for.

Title Encoding:

The name parameter is UTF-8 ready. Any non-english characters can be sent as is without any pre-processing or conversions on your end. Example: characters like "åäö" will be accepted as a name by this endpoint as long as the parameter was provided with the correct URL-encoding.

Response

A successful request will result in a populated payload field with the expected output.

A failed request will result in an error output as detailed in Error Rules. If the endpoint validation fails due to missing, badly formatted or invalid parameters, the endpoint will return HTTP code 400 along with a message detailing the error.

See the examples section for more information.

A Lorenum.com product

Twitter Discord Email

Request

Curl

// Search for `3` `micro` companies named `Alien` in the `US`

curl -G \
https://api.jsonrepo.com/v1/knowledge/social/companieslinkedin \
-H "api_key: {YOUR_API_KEY_HERE}" \
--data-urlencode "name=alien" \
--data-urlencode "size=micro" \
--data-urlencode "country=US" \
--data-urlencode "limit=3"

Success Response

{
    "http_code": 200,
    "http_message": "Ok",
    "message": "Successful execution",
    "payload": {
        "companies": [
            {
                "id": 23634853,
                "name": "Alien & co",
                "linkedin": "linkedin.com/company/alien-&-co",
                "website": "alienandco.com",
                "founded": "",
                "size": "Micro",
                "size_min": 1,
                "size_max": 10,
                "country": "United states",
                "country_code_2": "US",
                "region": "South dakota",
                "locale": "Sioux falls",
                "industry": "Outsourcing/offshoring",
                "db_entry_last_updated_at": "2024-08-11 17:47:34"
            },
            {
                "id": 15478370,
                "name": "Alien amp records",
                "linkedin": "linkedin.com/company/alien-amp-records",
                "website": "alienamprecords.com",
                "founded": 2016,
                "size": "Micro",
                "size_min": 1,
                "size_max": 10,
                "country": "United states",
                "country_code_2": "US",
                "region": "New york",
                "locale": "Jackson heights",
                "industry": "",
                "db_entry_last_updated_at": "2024-08-11 17:31:51"
            },
            {
                "id": 19105314,
                "name": "Alien apparatus company, incorporated",
                "linkedin": "linkedin.com/company/alien-apparatus-company-incorporated",
                "website": "alienapparatus.com",
                "founded": "",
                "size": "Micro",
                "size_min": 1,
                "size_max": 10,
                "country": "United states",
                "country_code_2": "US",
                "region": "California",
                "locale": "San leandro",
                "industry": "",
                "db_entry_last_updated_at": "2024-08-11 17:38:44"
            }
        ]
    }
}

Error Response Examples

// Request with invalid `limit` parameter

{
    "http_code": 400,
    "http_message": "Bad Request",
    "message": "Malformed request: `limit` parameter must be between 1 (min) and 50 (max). Default is 20.",
    "payload": []
}

// Request with invalid `size` parameter

{
    "http_code": 400,
    "http_message": "Bad Request",
    "message": "Malformed request: `size` parameter must be one of the following values: `micro`, `small`, `medium` or `large`.",
    "payload": []
}