Skip to main content
POST
/
api
/
enterprise
/
company
/
enrich
Company Instant Enrichment (Batch)
curl --request POST \
  --url https://api.wokelo.ai/api/enterprise/company/enrich/ \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "companies": [
    "tesla-motors",
    "stripe"
  ],
  "sections": [
    "firmographics"
  ]
}
'
{
    "request_id": "3c945250-a3e8-4673-b342-2ceb03af5b02",
    "status": "PENDING"
}

Documentation Index

Fetch the complete documentation index at: https://docs.wokelo.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
Overview

The Company Insights API delivers structured insights for one or more companies across sections such as products & services, product launches, strategic initiatives, partnerships, and more. Optionally, you can customize the output by specifying which sections to include and defining custom fields with your own prompts. Returns a request_id as a response.

​
Endpoint Details

  • Method: POST
  • Endpoint: /api/enterprise/company/enrich/

​
Authentication Requirements

  • Include a valid JWT token in your request header
  • If you don’t have a token yet, you can get one from the /auth/token/ endpoint first.

​
Request

​
Header Parameters

​
Authorization
string
required
JWT token obtained from the Authentication request

​
Body Parameters

​
companies
string[]
required
List of permalinks or URLs of the companies to enrich (e.g. "tesla-motors", "stripe" or "https://tesla.com")
​
sections
string[]
required
Sections of data to include in the output. Select one or more values.Supported values: products_and_services, product_launches, strategic_initiatives, partnerships, business_model, key_customers, management_profiles, employee_sentiment, product_sentiment
​
parameters
object
Optional parameters to customize the output.
​
custom_fields
object[]
List of custom fields to compute for each company.
​
field_name
string
required
Name of the custom field (e.g. "AI Readiness")
​
type
string
required
Data type of the field. Supported value: text
​
prompt
string
required
Prompt used to generate the custom field value (e.g. "Rate this company's AI readiness on a scale of 1-10 with reasoning")

​
Response

A successful response returns a request_id that can be used to track the status of the request.

​
Successful Response Fields

​
request_id
string
Unique identifier for the request posted. Use this with the /api/enterprise/request/status/ endpoint to check the status
​
status
string
Status of the request (e.g. "PENDING")
{
    "request_id": "3c945250-a3e8-4673-b342-2ceb03af5b02",
    "status": "PENDING"
}

Authorizations

​
Authorization
string
header
required

JWT token obtained from the /auth/token/ endpoint.

Body

application/json
​
companies
string[]
required

List of company permalinks or URLs to enrich.

Example:
["tesla-motors", "stripe"]
​
sections
enum<string>[]
required

Sections of data to include in the enrichment response. Select one or more values.

Available options:
firmographics,
gtm_and_business_model,
headcount,
funding,
public_company_financials,
uk_private_company_financials,
acquisitions,
investments,
website_traffic,
products_and_services,
product_launches,
strategic_initiatives,
partnerships,
business_model,
key_customers,
management_profiles,
employee_sentiment,
product_sentiment
Example:
["firmographics"]
​
parameters
object

Optional parameters to customize the output.

Response

202 - application/json

Request accepted

​
request_id
string<uuid>
Example:

"931643e9-b6c7-45d4-9ba9-bd3b534221e7"

​
status
enum<string>
Available options:
PENDING,
PROCESSING,
COMPLETED,
FAILED
Example:

"PENDING"