curl --request POST \
--url https://api.generect.com/api/v1/enrich/realtime/company/ \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
"id": 1035
}'{
"data": {
"id": "1035",
"linkedin_id": "1035",
"linkedin_urn": "microsoft",
"linkedin_link": "https://www.linkedin.com/company/microsoft/",
"name": "Microsoft",
"raw_name": "Microsoft",
"tagline": null,
"description": "Every company has a mission. What's ours? To empower every person and every organization to achieve more.",
"website": "https://news.microsoft.com/",
"domain": "microsoft.com",
"industry": "Software Development",
"specialities": [
"Business Software",
"Developer Tools",
"Home & Educational Software"
],
"hashtags": [
"microsoftlife",
"microsoft"
],
"company_type": "Public Company",
"founded_year": null,
"headcount_range": "10 000+",
"location": "Redmond, Washington, United States",
"hq_street": "1 Microsoft Way",
"hq_city": "Redmond",
"hq_state": "Washington",
"hq_postal_code": "98052",
"hq_country": "United States",
"hq_country_code": "US",
"hq_additional_info": null,
"raw_location": {
"country": "United States",
"state": "Washington",
"city": "Redmond",
"street": "1 Microsoft Way",
"postal_code": "98052",
"additional_info": null
},
"number_of_locations": 45,
"other_locations_json": [
{
"country": "Australia",
"state": "NSW",
"city": "North Sydney",
"street": "1 Denison Street",
"postal_code": "2060",
"additional_info": null,
"description": null
}
],
"phone_number": null,
"logo_url": "https://media.licdn.com/dms/image/v2/D560BAQH32RJQCl3dDQ/company-logo_100_100/B56ZYQ0mrGGoAU-/0/1744038948046/microsoft_logo",
"background_image": "https://media.licdn.com/dms/image/v2/D4E1BAQHb1Lu8fVYoHg/company-background_10000/B4EZ8ZTXy5JIAI-/0/1782835936908/microsoft_cover",
"default_locale": "en",
"groups": [],
"is_claimable": false,
"acquired_by": null,
"crunchbase_urn": null,
"showcase_pages": null,
"source": "company_by_link"
},
"meta": {
"amount_charged": 0.04
}
}{
"status": "error",
"status_code": 400,
"detail": {
"fields": "exactly one of id, domain, linkedin_url, name is required"
}
}{
"status": "error",
"status_code": 401,
"detail": "Authentication credentials were not provided."
}{
"status": "error",
"status_code": 402,
"detail": "Insufficient funds in the account."
}{
"status": "error",
"status_code": 403,
"detail": "You do not have permission to perform this action."
}{
"status": "error",
"status_code": 429,
"detail": "Request was throttled."
}Companies
Enrich company in realtime
Retrieve a fresh company profile. Provide exactly one identifier.
POST
/
api
/
v1
/
enrich
/
realtime
/
company
/
curl --request POST \
--url https://api.generect.com/api/v1/enrich/realtime/company/ \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
"id": 1035
}'{
"data": {
"id": "1035",
"linkedin_id": "1035",
"linkedin_urn": "microsoft",
"linkedin_link": "https://www.linkedin.com/company/microsoft/",
"name": "Microsoft",
"raw_name": "Microsoft",
"tagline": null,
"description": "Every company has a mission. What's ours? To empower every person and every organization to achieve more.",
"website": "https://news.microsoft.com/",
"domain": "microsoft.com",
"industry": "Software Development",
"specialities": [
"Business Software",
"Developer Tools",
"Home & Educational Software"
],
"hashtags": [
"microsoftlife",
"microsoft"
],
"company_type": "Public Company",
"founded_year": null,
"headcount_range": "10 000+",
"location": "Redmond, Washington, United States",
"hq_street": "1 Microsoft Way",
"hq_city": "Redmond",
"hq_state": "Washington",
"hq_postal_code": "98052",
"hq_country": "United States",
"hq_country_code": "US",
"hq_additional_info": null,
"raw_location": {
"country": "United States",
"state": "Washington",
"city": "Redmond",
"street": "1 Microsoft Way",
"postal_code": "98052",
"additional_info": null
},
"number_of_locations": 45,
"other_locations_json": [
{
"country": "Australia",
"state": "NSW",
"city": "North Sydney",
"street": "1 Denison Street",
"postal_code": "2060",
"additional_info": null,
"description": null
}
],
"phone_number": null,
"logo_url": "https://media.licdn.com/dms/image/v2/D560BAQH32RJQCl3dDQ/company-logo_100_100/B56ZYQ0mrGGoAU-/0/1744038948046/microsoft_logo",
"background_image": "https://media.licdn.com/dms/image/v2/D4E1BAQHb1Lu8fVYoHg/company-background_10000/B4EZ8ZTXy5JIAI-/0/1782835936908/microsoft_cover",
"default_locale": "en",
"groups": [],
"is_claimable": false,
"acquired_by": null,
"crunchbase_urn": null,
"showcase_pages": null,
"source": "company_by_link"
},
"meta": {
"amount_charged": 0.04
}
}{
"status": "error",
"status_code": 400,
"detail": {
"fields": "exactly one of id, domain, linkedin_url, name is required"
}
}{
"status": "error",
"status_code": 401,
"detail": "Authentication credentials were not provided."
}{
"status": "error",
"status_code": 402,
"detail": "Insufficient funds in the account."
}{
"status": "error",
"status_code": 403,
"detail": "You do not have permission to perform this action."
}{
"status": "error",
"status_code": 429,
"detail": "Request was throttled."
}Use Case:
Retrieve a fresh company profile by Generect ID, LinkedIn URL, domain, or company name.Optional sections
Company activity and audience lists are opt-in — each flag adds +1 credit when the section comes back with data:| Flag | Adds |
|---|---|
posts | The company page’s latest posts, up to 10, however old they are |
people_also_viewed | Companies LinkedIn lists under “People also viewed” |
people_also_follow | Companies LinkedIn lists under “People also follow” |
Pricing
This is a billable endpoint — you are charged only when a company is found and returned. If nothing is found, the request is free.Your price decreases automatically as your lifetime spend grows. Check your current tier and pricing →
Authorizations
Body
application/json
- By Generect ID
- By LinkedIn URL
- By Domain
- By Company Name
Response
Fresh full company profile
A company profile, as the realtime and the database company enrich return it for a request by linkedin_url or id. A field the company page does not have comes back null or as an empty list. A request by id also echoes the identifier back as input_id. Treat any field not listed here as optional.
Show child attributes
Show child attributes
Was this page helpful?