Company Data
Enrich company data from a LinkedIn URL or Id.
This endpoint will consume 1 company daily usage for each request.
Request
Method: POST
URL:
https://api.tripleqleads.com/v1/enricher/company
Headers
X-API-KEY
string required
An API Key is required for this endpoint. Don't know where your key is?
Body
company_linkedin_url
string required
The
description can be set as prop or in the default slot with full markdown support.company_linkedin_id
string required
The
description can be set as prop or in the default slot with full markdown support.If both fields are present
company_linkedin_id will take priority.Responses
Successful Response
Status: 200 OK
{
"status": "OK",
"data":{
"company": {
"linkedin_id": "string",
"urn": "string",
"name": "string",
"public_id": "string",
"description": "string",
"linkedin_url": "string",
"hashtags": ["string"],
"follow_count": 0,
"locations": [
{
"is_hq": true,
"country": "string",
"city": "string",
"postal_code": "string",
"street": ["string"],
"description": "string",
"area": "string"
}
],
"tagline": "string",
"website_url": "string",
"phone": "string",
"founded_year": "string",
"estimated_employee_count": 0,
"employee_count_range": {
"from": 0,
"to": 0
},
"industry": ["string"]
}
}
}
Error Responses
| Status Code | Example Response |
|---|---|
| 400 | { "status": "ERROR", "error": "Invalid request payload." } |
| 400 | { "status": "ERROR", "error": "company_linkedin_url or company_linkedin_id is required." } |
| 400 | { "status": "ERROR", "error": "Invalid company_linkedin_url provided." } |
| 400 | { "status": "ERROR", "error": "Invalid company_linkedin_url provided." } |
| 400 | { "status": "ERROR", "error": "LinkedIn URL is missing company identifier." } |
| 400 | { "status": "ERROR", "error": "LinkedIn URL contains extra path segments after the company identifier." } |
| 400 | { "status": "ERROR", "error": "Invalid input." } |
| 404 | { "status": "ERROR", "error": "Company couldn't be found with the provided identifier." } |
| 500 | { "status": "ERROR", "error": "Internal server error." } |
API Key Authentication Error Responses
Company Data Object
Below is the structure of the company object returned upon a successful response.
linkedin_id
string
LinkedIn numeric ID of the company.
urn
string
LinkedIn URN identifier for the company.
name
string
Company’s name.
public_id
string
LinkedIn public identifier (slug).
description
string
Company description.
linkedin_url
string
Full LinkedIn URL for the company.
hashtags
array<string>
Related hashtags associated with the company.
follow_count
number
Number of followers on LinkedIn.
locations
array<object>
List of company locations. See Location Object.
tagline
string
Company tagline.
website_url
string
Company website URL.
phone
string
Company phone number.
founded_year
string
Company founding year (e.g.
"2005").estimated_employee_count
integer
Estimated number of employees.
employee_count_range
object
Range of employee count.
industry
array<string>
Industries the company operates in.
Location Object
Each entry in the locations array contains:
is_hq
boolean
Whether this location is the headquarters.
country
string
Country of the location.
city
string
City of the location.
postal_code
string
Postal code.
street
array<string>
Street address lines.
description
string
Additional description.
area
string
Area or region name.