Get Company Insights

curl --request POST \
  --url https://api.preceptai.co.uk/v1/companies/insights \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "webhookUrl": "https://your-site.com/webhook",
  "companies": [
    {
      "companyWebsite": "https://www.preceptai.co.uk",
      "customData": {
        "id": "12345"
      }
    },
    {
      "companyWebsite": "mywebsite.com",
      "companyLinkedin": "https://www.linkedin.com/company/mywebsite",
      "customData": {
        "id": "12345",
        "crm_id": "01234"
      }
    },
    {
      "companyLinkedin": "https://www.linkedin.com/company/samplecompany"
    },
    {
      "companyName": "Amazon",
      "companySocialUrl": "https://www.x.com/amazon"
    }
  ],
  "queries": [
    "What is their tech stack?",
    "Do they use HubSpot?"
  ],
  "enrichments": {
    "type": "decision_makers",
    "departments": [
      "engineering",
      "sales"
    ],
    "jobTitles": [
      "Software Engineer"
    ],
    "includeContactDetails": true,
    "limit": 10
  }
}
'

{
  "message": "Company enrichment requests accepted and are being processed.",
  "enrichment_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}

Companies

Get Company Insights

Retrieve detailed insights and enrichments for a list of companies.

This endpoint enriches a list of companies with comprehensive data. You provide a list of companies, identified by either their website or LinkedIn URL, and specify the desired enrichments. The results are delivered to the webhookUrl you provide.

Get company-level insights, such as:

Number of employees (by department)
Names and LinkedIn profiles of employees
Funding raised
Revenue
Strategic initiatives at the company
Latest news
Top problems the company is facing right now
+42 more datapoints.

You can also make custom queries about the company.

To associate your own internal identifiers with each company, use the customData field. This data will be returned to you in the webhook response, allowing you to easily map the enrichment results back to your system.

POST

companies

insights

Get Company Insights

curl --request POST \
  --url https://api.preceptai.co.uk/v1/companies/insights \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "webhookUrl": "https://your-site.com/webhook",
  "companies": [
    {
      "companyWebsite": "https://www.preceptai.co.uk",
      "customData": {
        "id": "12345"
      }
    },
    {
      "companyWebsite": "mywebsite.com",
      "companyLinkedin": "https://www.linkedin.com/company/mywebsite",
      "customData": {
        "id": "12345",
        "crm_id": "01234"
      }
    },
    {
      "companyLinkedin": "https://www.linkedin.com/company/samplecompany"
    },
    {
      "companyName": "Amazon",
      "companySocialUrl": "https://www.x.com/amazon"
    }
  ],
  "queries": [
    "What is their tech stack?",
    "Do they use HubSpot?"
  ],
  "enrichments": {
    "type": "decision_makers",
    "departments": [
      "engineering",
      "sales"
    ],
    "jobTitles": [
      "Software Engineer"
    ],
    "includeContactDetails": true,
    "limit": 10
  }
}
'

{
  "message": "Company enrichment requests accepted and are being processed.",
  "enrichment_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

webhookUrl

string<uri>

required

The URL where the enrichment results will be sent via a POST request.

companies

object[]

required

An array of company objects to enrich. You can process multiple companies in a single request. You must provide either the company website or LinkedIn URL. If providing a social URL, you must also include the company's name.

Show child attributes

companies.companyName

string

The name of the company. Required if using companySocialUrl.

companies.companyWebsite

string<uri>

The official website of the company.

companies.companyLinkedin

string<uri>

The official LinkedIn URL of the company.

A social media URL for the company (e.g., X, Facebook). Must be provided with companyName.

companies.customData

object

An object for any custom data you want to associate with the company. This data will be returned with the enrichment results. Maximum of 5 properties allowed, and values must be strings with a maximum length of 100 characters.

Show child attributes

companies.customData.{key}

string

queries

string[]

A list of natural language questions to ask about the company.

enrichments

object

An optional object to specify the desired enrichments.

Show child attributes

enrichments.type

enum<string>

The type of structured enrichment to perform. Applies to departments and jobTitles.

Available options:

decision_makers,

employee_count,

job_postings_count,

department_ratio,

employee_count_change

enrichments.departments

enum<string>[]

A list of department names to find employees or insights for. The department names are NOT case sensitive.

Available options:

Actuary,

Administrative,

C-Suite,

Claims,

Consulting,

Customer Service,

Data & Analytics,

Design,

Education,

Engineering and Technical,

Finance & Accounting,

Founder,

Governance & Quality,

Health & Safety,

Human Resources,

Innovation,

Information Technology,

Legal,

Logistics,

Marketing,

Medical,

Operations,

Pricing,

Procurement & Sourcing,

Product,

Project Management,

Quality Control & Assurance,

Real Estate,

Research,

Risk & Compliance,

Sales,

Security,

Sustainability,

Trades,

Underwriting

enrichments.jobTitles

string[]

A list of job titles to find employees for. You can use any job title (e.g., "Software Engineer", "Sales Manager").

enrichments.includeContactDetails

boolean

Whether to include contact details of the decision makers in the response. This is only applicable for the DecisionMakerEnrichment type.

enrichments.limit

integer

The maximum number of decision makers to return. Defaults to 10. This is only applicable for the DecisionMakerEnrichment type.

Response

Request accepted. The enrichment is in progress. The response will vary based on whether all companies could be processed.

Option 1
Option 2

message

string

Example:

"Company enrichment requests accepted and are being processed."

enrichment_id

string<uuid>

n8n Start Contacts Enrichment

⌘I

Getting Started

Essentials

Integrations

API Reference

Get Company Insights

Authorizations

Body

Response