Skip to main content
GET
Calculate public trend signals for a topic

Authorizations

Authorization
string
header
required

Permanent personal API key created in the dashboard. Example: curl -H "Authorization: Bearer aty_…" https://your-host/v1/projects

Path Parameters

provider
enum<string>
required

External video provider.

Available options:
youtube
Example:

"youtube"

Query Parameters

q
string
required

Topic to research.

Maximum string length: 200
Example:

"AI agents"

limit
integer
default:20

Number of diversified videos to enrich; clamped to 8–30.

Required range: 8 <= x <= 30
insights
enum<string>
default:ai

AI insight mode. Use deterministic to skip GLM analysis.

Available options:
ai,
deterministic

Response

Topic trend report.

provider
enum<string>
required
Available options:
youtube
query
string
required
generatedAt
string<date-time>
required
sampleSize
integer
required
Required range: x >= 0
methodologyVersion
any
required
methodology
string
required
sample
object
required
confidence
object
required
summary
object
required
videos
object[]
required
hashtags
object[]
required
titlePatterns
object[]
required
durationMix
object[]
required
plan
object
required
warnings
string[]
required
insights
object

Optional GLM-generated analysis. Omitted when deterministic mode is requested or model inference fails.