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
window
object
required

The recency window used to reserve sample slots for recent uploads.

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.