Lookup LinkedIn company

POST

lookup

curl --request POST \
  --url https://api.kernel.ai/rest/v1/lookup/linkedin \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "linkedin_url": "https://www.linkedin.com/company/stripe"
}
'

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "processing"
}

{
  "error": "Entity not found"
}

Async. Poll with the returned id, or pass webhook_url for a callback.

Not Kernel-verified. provenance.kernel_approved is always false. Profile fields use the linkedin_* prefix — not Kernel firmographics.

Examples

By website

curl

curl -X POST https://api.kernel.ai/rest/v1/lookup/linkedin \
  -H "x-api-key: $KERNEL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"website": "stripe.com"}'

Response (202)

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "processing"
}

By LinkedIn URL

curl

curl -X POST https://api.kernel.ai/rest/v1/lookup/linkedin \
  -H "x-api-key: $KERNEL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"linkedin_url": "https://www.linkedin.com/company/stripe"}'

Request body

Field	Type	Required	Description
`name`	`string`	No*	Company name (low confidence alone)
`website`	`string`	No*	Website or domain
`linkedin_url`	`string`	No*	LinkedIn company URL
`webhook_url`	`string`	No	HTTPS callback URL

*At least one of name, website, or linkedin_url.

Authorizations

x-api-key

string

header

required

Include your API key in the x-api-key header.

Body

application/json

At least one of name, website, or linkedin_url is required.

name

string

Company name. Name-only matches are low confidence.

Minimum string length: 1

Example:

"Stripe"

website

string

Company website or domain.

Minimum string length: 1

Example:

"https://stripe.com"

linkedin_url

string

LinkedIn company URL.

Minimum string length: 1

Example:

"https://www.linkedin.com/company/stripe"

webhook_url

string<uri>

HTTPS URL to receive webhook callbacks when the job completes or fails. Kernel will POST the job result to this URL with an X-Kernel-Signature header for verification.

Pattern: ^https://

Example:

"https://example.com/webhooks/kernel"

Response

Job accepted

string

required

Unique identifier for the created job.

Example:

"550e8400-e29b-41d4-a716-446655440000"

status

enum<string>

required

Initial status of the job.

Available options:

processing

Get LinkedIn lookup resultPoll the status and result of a LinkedIn lookup job submitted via Lookup LinkedIn company.

curl --request POST \
  --url https://api.kernel.ai/rest/v1/lookup/linkedin \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "linkedin_url": "https://www.linkedin.com/company/stripe"
}
'

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "processing"
}

{
  "error": "Entity not found"
}

Getting started

API reference

API keys & Webhooks

Lookup LinkedIn company

Examples

By website

By LinkedIn URL

Request body

Authorizations

Body

Response

​Examples

​By website

​By LinkedIn URL

​Request body

​Related endpoints

Authorizations

Body

Response

Examples

By website

By LinkedIn URL

Request body

Related endpoints