Skip to main content
POST
Detect a niche

Authorizations

Authorization
string
header
required

A workspace API key.

Body

application/json
businessDescription
string
required

What the business makes, teaches, or sells. This is the only required field.

Required string length: 3 - 10000
businessName
string

Business or creator name.

Required string length: 1 - 300
products
string[]

Plain-language product names or descriptions; no product ids are required.

Maximum array length: 100
Required string length: 1 - 500
services
string[]

Plain-language services the business provides.

Maximum array length: 100
Required string length: 1 - 500
audience
string

Who the business serves.

Required string length: 1 - 2000
channelBio
string

Existing public channel or profile bio.

Required string length: 1 - 5000
keywords
string[]

Terms the business wants to be found for.

Maximum array length: 100
Required string length: 1 - 200
sourceCategories
object[]

Provider categories already associated with the business or channel.

Maximum array length: 20

Response

Success.

success
boolean
required
niche
object
required

Reusable canonical niche profile.

classification
object
required

Deterministic canonical-theme classification with its evidence.

{key}
any