> ## Documentation Index > Fetch the complete documentation index at: https://docs.sigmora.org/llms.txt > Use this file to discover all available pages before exploring further. # List trends > List evidence-backed trend signals with explicit freshness. Aggregates recently observed viral content into theme momentum, recurring topic clusters, news and controversy signals. Freshness is calculated from collection timestamps, and coverage states its sample limit; this endpoint never labels stale or partial data as complete real-time coverage. ## OpenAPI ````yaml /openapi.json get /v1/trends openapi: 3.1.0 info: title: Sigmora API version: 1.0.0 description: >- The priced, versioned public API. Every call authenticates with a workspace API key (`Authorization: Bearer sk_live_…`), names the project it files its output under, and reports what it cost. `GET /v1/capabilities` answers what this deployment can serve right now and at what price; anything it reports as unavailable answers 503 `capability_unavailable` rather than 404. servers: - url: https://api.sigmora.org security: - bearerAuth: [] tags: - name: Meta description: What this deployment serves, what it costs, and what you have spent. - name: Projects description: The container every capability files its output under. - name: Jobs description: Where every asynchronous capability is collected, whatever produced it. - name: Text description: Scripts, research, articles, translation and question sets. - name: Video description: Narrated renders, footage edits, shorts and moment selection. - name: 3D description: Animated 3D renders from a description or a photograph. - name: Image description: Thumbnails, sized for the platform they are posted to. - name: Audio description: Generated music. - name: Themes description: The canonical content taxonomy, and the niche profiles built on it. - name: Signals description: Evidence-backed trends and scored viral content. - name: Discovery description: Compiled watch plans, their runs, and source freshness. - name: Autopilot description: The durable trend-to-distribution workflow and its checkpoints. - name: Campaigns description: Distribution records shared by the API, the dashboard and autopilot. - name: Channels description: The destinations content is made for. - name: Products description: What a campaign promotes. paths: /v1/trends: get: tags: - Signals summary: List trends description: >- List evidence-backed trend signals with explicit freshness. Aggregates recently observed viral content into theme momentum, recurring topic clusters, news and controversy signals. Freshness is calculated from collection timestamps, and coverage states its sample limit; this endpoint never labels stale or partial data as complete real-time coverage. parameters: - name: platform in: query required: false description: Restrict to one platform. schema: description: Restrict to one platform. type: string enum: - youtube_shorts - instagram_reels - tiktok - twitter - reddit - news - name: themeId in: query required: false description: Restrict to one canonical theme. GET /v1/themes lists them. schema: description: Restrict to one canonical theme. GET /v1/themes lists them. examples: - iab:3.1:391 type: string minLength: 1 maxLength: 160 - name: windowHours in: query required: false description: How far back to look. 1 hour to 30 days; defaults to 72 hours. schema: default: 72 description: How far back to look. 1 hour to 30 days; defaults to 72 hours. type: integer minimum: 1 maximum: 720 - name: minScore in: query required: false description: Drop signals scoring below this. 0–100. schema: description: Drop signals scoring below this. 0–100. examples: - 60 type: number minimum: 0 maximum: 100 - name: minEvidence in: query required: false description: >- How many independent observations a signal needs before it is returned. schema: default: 1 description: >- How many independent observations a signal needs before it is returned. type: integer minimum: 1 maximum: 20 - name: limit in: query required: false description: How many signals to return. Between 1 and 50; defaults to 20. schema: default: 20 description: How many signals to return. Between 1 and 50; defaults to 20. type: integer minimum: 1 maximum: 50 responses: '200': description: Success. content: application/json: schema: $schema: https://json-schema.org/draft/2020-12/schema type: object properties: success: type: boolean const: true required: - success additionalProperties: {} '400': description: 'Failure. `code` is one of: invalid_request.' content: application/json: schema: $ref: '#/components/schemas/Error' '401': description: 'Failure. `code` is one of: unauthorized.' content: application/json: schema: $ref: '#/components/schemas/Error' '402': description: 'Failure. `code` is one of: insufficient_credits, budget_capped.' content: application/json: schema: $ref: '#/components/schemas/Error' '403': description: 'Failure. `code` is one of: forbidden, origin_not_allowed.' content: application/json: schema: $ref: '#/components/schemas/Error' '404': description: 'Failure. `code` is one of: not_found.' content: application/json: schema: $ref: '#/components/schemas/Error' '409': description: 'Failure. `code` is one of: conflict.' content: application/json: schema: $ref: '#/components/schemas/Error' '413': description: 'Failure. `code` is one of: payload_too_large.' content: application/json: schema: $ref: '#/components/schemas/Error' '429': description: 'Failure. `code` is one of: rate_limited.' content: application/json: schema: $ref: '#/components/schemas/Error' '500': description: 'Failure. `code` is one of: internal_error.' content: application/json: schema: $ref: '#/components/schemas/Error' '502': description: 'Failure. `code` is one of: upstream_error.' content: application/json: schema: $ref: '#/components/schemas/Error' '503': description: >- Failure. `code` is one of: capability_unavailable, upstream_unavailable. content: application/json: schema: $ref: '#/components/schemas/Error' components: schemas: Error: type: object required: - success - error - code properties: success: const: false error: type: string description: >- Human-readable. Copy may change between releases — do not match on it. code: type: string enum: - invalid_request - unauthorized - forbidden - origin_not_allowed - not_found - conflict - payload_too_large - insufficient_credits - budget_capped - rate_limited - capability_unavailable - upstream_unavailable - upstream_error - internal_error description: Stable machine-readable cause. Branch on this. details: description: Optional structured context, e.g. the credits shortfall. securitySchemes: bearerAuth: type: http scheme: bearer description: A workspace API key. ````