Skip to main content
POST
Industry Deep Intelligence

Overview

The Industry Insights API generates structured insights for a given industry topic (e.g., “Warehouse automation”). Optionally, you can refine the output by specifying sections, keywords, geography, a custom industry definition, and sample companies. Returns a request_id as a response.

Endpoint Details

  • Method: POST
  • Endpoint: /api/enterprise/industry/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

string
required
JWT token obtained from the Authentication request

Body Parameters

string
required
The industry topic to generate insights for (e.g. "Enterprise SaaS security")
string[]
Sections to include in the report. Select one or more values.Supported values: market_size, quant_insights, trends_and_innovations, transactions_mna, transactions_fundraising, transactions_ipo, partnerships, tier1_intelligence, case_studies, industry_regulations
object
Optional filter parameters. All fields inside are optional.
string[]
Keywords to focus the analysis on (e.g. "zero trust", "SIEM")
string[]
Geographic scope as ISO country codes (e.g. ["USA", "GBR"])
string
A custom definition of the industry to guide report generation
string[]
Permalinks of representative companies in the industry

Response

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

Successful Response Fields

string
Unique identifier for the request posted. Use this with the /api/enterprise/request/status/ endpoint to check the status
string
Status of the request (e.g. "PENDING")

Authorizations

Authorization
string
header
required

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

Body

application/json
topic
string
required

The industry topic to generate insights for.

Example:

"Enterprise SaaS security"

sections
enum<string>[]

Sections to include in the report. Select one or more values.

Available options:
market_size,
quant_insights,
trends_and_innovations,
transactions_mna,
transactions_fundraising,
transactions_ipo,
partnerships,
tier1_intelligence,
case_studies,
industry_regulations
Example:
parameters
object

Optional filter parameters.

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"