Wistia Transcript - Timestamped Speech-to-Text API

Wistia Transcript converts one publicly accessible Wistia video into detected-language text, timestamped speech segments, media metadata, and an optional translated transcript. It transcribes audible speech from the downloaded media; it does not promise Wistia captions, analytics, form data, or viewer identities.

• One accessible Wistia media or embed URL is accepted per run.
• The resolved extractor is checked as Wistia before the formal download begins.
• Every successful result follows the Actor's 22-field Dataset contract.
• Requested translation is either complete and segment-aligned or absent; partial translation is not published as success.

Run Wistia Transcript · Open the API page

Test an unlocked media URL with clear speech before automating larger workloads. A Wistia embed can be public on a website while other media in the same account remains private.

---

Why Choose This API

A narrow transcript contract for known Wistia media

Use this Actor when you already know the accessible Wistia video to process. Its input is deliberately small: one video_url and one optional translate target. The resolved URL must identify Wistia before the formal download begins.

Capability	Returned data
Speech recognition	Detected language, combined text, and ordered timestamped segments
Media context	Title, description, duration, publication time, thumbnail, creator, tags, and categories when exposed
Engagement context	Count fields when Wistia exposes them; public media commonly leaves these counts unavailable
Optional translation	Translated full text and ordered segments using the original timestamps

This Actor is not a Wistia account crawler, Channel scraper, viewer-analytics exporter, lead-form collector, live recorder, speaker-diarization system, summary generator, or video download service. A successful run creates one Dataset item. Missing source fields remain null, zero, or empty according to the Dataset schema.

Automatic speech recognition is probabilistic. Background music, room echo, overlapping speech, accents, names, and specialist vocabulary can reduce accuracy. Review quotations and business-critical text against the source media.

---

Quick Start Guide

Transcribe a Wistia video in three steps

1. Paste one accessible Wistia media, share, or embed URL.
2. Leave translate empty for the detected-language transcript, or choose one target language.
3. Start the Actor and read the resulting item from its default Dataset.

{
  "video_url": "https://fast.wistia.net/embed/iframe/h1z3uqsjal",
  "translate": "spanish"
}

Wistia's media sharing guide distinguishes public share URLs from manage URLs and explains that owners control link access, passwords, folder access, expiration, and domain restrictions. The Actor does not bypass these controls; a media URL must expose its audio without credentials at run time.

Submit one video per run. For a list of Wistia URLs, create separate Actor runs and control concurrency through your Apify client or workflow.

---

Input Parameters

Parameter	Type	Required	Description
video_url	string	Yes	One publicly accessible Wistia media or embed URL
translate	string	No	Optional translation target selected from the configured language list

The schema pre-fills https://fast.wistia.net/embed/iframe/h1z3uqsjal as an editable example. Wistia also documents public media URLs such as account-hosted /medias/{id} links and public share links. Whether a particular form works depends on the media's current access settings and public availability.

This single-platform Actor does not expose video_file. Use the universal Video Transcript Actor for uploads. Wistia account pages, manage URLs requiring authentication, locked folders, expired links, and unrelated platforms are outside this Actor's public input contract.

Translation begins only after transcription. If any translated segment ultimately fails, the result is published without translation and the translation event is not charged. Original text is never substituted as fake translated text.

---

Output Data Schema

One successful run publishes one object containing exactly 22 top-level fields:

Group	Fields
Processing	processor, processed_at, platform
Source	title, description, author, author_id, author_url, duration, published_at, thumbnail
Audio and classification	audio_title, audio_artist, categories, tags
Engagement	view_count, like_count, shares_count, dislike_count, comment_count
Speech	transcript, translation

transcript contains a language name, combined text, and timestamped segments. translation has the same shape only when the requested translation completes. The current output contract represents unavailable metadata with the existing null, zero, or empty form.

The sample below illustrates the stable output shape rather than promising that a third-party media item or its metadata will remain available. Titles, publication timestamps, duration metadata, authors, and engagement values can change or be absent.

{
  "processor": "https://apify.com/agentx/wistia-transcript?fpr=aiagentapi",
  "processed_at": "2026-07-21T14:03:32+00:00",
  "platform": "Wistia",
  "title": "Mike Boom Mic",
  "description": "Mike is terrible with a boom mic — we really need to find a replacement.",
  "author": null,
  "author_id": null,
  "author_url": null,
  "duration": 18,
  "audio_title": null,
  "audio_artist": null,
  "view_count": null,
  "like_count": null,
  "shares_count": null,
  "dislike_count": null,
  "comment_count": null,
  "categories": [],
  "tags": [],
  "published_at": "2016-03-28T17:16:20+00:00",
  "thumbnail": "http://embed.wistia.com/deliveries/34230e36162fed47a131426c04ddadb655e6cca5.jpg",
  "transcript": {
    "language": "English",
    "text": "You're lying about me. Sweet Jesus, Mike. Perfect. One more time. Say Anko. Jesus, Mike.",
    "segments": [
      {
        "start": "00:00:02.879",
        "end": "00:00:16.199",
        "text": "You're lying about me. Sweet Jesus, Mike. Perfect. One more time. Say Anko. Jesus, Mike."
      }
    ]
  },
  "translation": {
    "language": "Spanish",
    "text": "Estás mintiendo sobre mí. Dios mío, Mike.",
    "segments": [
      {
        "start": "00:00:02.879",
        "end": "00:00:16.199",
        "text": "Estás mintiendo sobre mí. Dios mío, Mike."
      }
    ]
  }
}

The translation shown illustrates the output shape. Source availability, metadata, counts, and ASR wording are evaluated again on every run.

---

Integration Examples

Start a run with the Apify API

curl -X POST \
  "https://api.apify.com/v2/acts/agentx~wistia-transcript/runs?token=YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"video_url":"https://fast.wistia.net/embed/iframe/h1z3uqsjal"}'

The run endpoint returns run metadata. Poll the run or attach a webhook, then read its default Dataset. Keep tokens in environment variables or a secret manager.

Python client

from apify_client import ApifyClient

client = ApifyClient("YOUR_APIFY_TOKEN")
run = client.actor("agentx/wistia-transcript").call(
    run_input={
        "video_url": "https://fast.wistia.net/embed/iframe/h1z3uqsjal",
        "translate": "spanish",
    }
)
items = client.dataset(run["defaultDatasetId"]).list_items().items
print(items[0]["transcript"]["text"])

MCP configuration

Apify's MCP server can make Actors available to compatible AI clients. Check the current client-specific instructions before deployment.

{
  "mcpServers": {
    "apify": {
      "url": "https://mcp.apify.com",
      "headers": {
        "Authorization": "Bearer YOUR_APIFY_TOKEN"
      }
    }
  }
}

Never commit a real token or paste it into public support material.

---

Pricing & Cost Calculator

The configured transcript event uses tiered pay-per-event pricing:

Apify plan tier	Transcript event	Translation event
Free	$0.38700	$0.15000
Bronze	$0.37410	$0.14500
Silver	$0.36120	$0.14000
Gold, Platinum, Diamond	$0.34830	$0.13500

A fully completed optional translation uses the same account-tier row. Actor start costs $0.001 per event with one event per allocated GB; at 8192 MB, the run produces eight start events. Runtime usage is metered at $0.00001 per configured usage event.

One successful Free-tier transcript without translation therefore starts from $0.387 + $0.008 = $0.395, plus runtime usage. A completed Free-tier translation brings the fixed subtotal to $0.545. At Gold or above, the transcript portion is $0.3483 and translation is $0.135.

Long media normally uses more runtime. Failed downloads or access restrictions can still consume startup and runtime resources before failure. Confirm the live Store pricing panel and set spending limits before batch execution.

---

Use Cases & Applications

Training and enablement libraries

Turn accessible Wistia tutorials, product walkthroughs, and internal videos that you are authorized to process into searchable draft text. Keep media IDs and timestamps with indexed chunks.

Editorial reuse

Create a draft transcript for notes, summaries, articles, or caption editing. The Actor does not generate the summary or certify accessibility; downstream review remains necessary.

Multilingual review

Detect the source language first, then request translation only for workflows that need it. Store original and translated text separately so reviewers can distinguish speech recognition from machine translation.

Automation

Trigger a run when a known Wistia media URL enters your workflow. This Actor does not enumerate folders or discover new media. Use a separately authorized system for discovery, then pass one supported URL per run.

---

FAQ

Which Wistia URLs work?

Publicly accessible media, share, or embed URLs can work. Manage URLs, locked content, password gates, expired links, and domain restrictions may fail.

Does this export Wistia analytics?

No. It returns media metadata exposed during extraction plus ASR output. It does not access viewer identities, heatmaps, lead forms, account analytics, or private project data.

Does it use Wistia captions?

The production path transcribes downloaded audio. It does not promise a native caption or subtitle track.

Why are author and count fields null?

Wistia does not expose these fields for every accessible media URL. The Actor retains the common Dataset contract without inventing unavailable metadata.

How are long videos handled?

Media up to 3600 seconds is transcribed directly. Longer media is processed sequentially in 900-second core chunks with 15 seconds of context on each available side; only one temporary chunk is retained at a time. Long videos still take more time and may consume more usage events.

Is the result exact?

No. ASR and translation can contain errors. Human review is required for quotations, compliance, accessibility, legal, medical, financial, or safety-critical use.

---

SEO Keywords & Search Terms

Common discovery phrases include Wistia transcript API, Wistia video to text, Wistia speech-to-text, timestamped Wistia transcript, Wistia embed transcription, Wistia media transcript, video ASR API, training video transcription, multilingual video transcript, and Apify Wistia automation.

These search phrases do not expand the contract. The Actor processes one reachable Wistia video and returns structured metadata, AI-generated speech text, timestamps, and an optional translation.

---

Trust & Certifications

• The public input accepts one accessible Wistia media URL and rejects unrelated platform extractors before download.
• The Dataset contract exposes 22 named fields with timestamped source and optional translated segments.
• Translation is published and charged only when its complete segment-aligned structure succeeds.
• No Store rating, user count, monthly activity, bookmark total, certification, or one-off test result is presented as evidence of future performance.

These are inspectable contract properties, not a promise that Wistia access settings or media availability will remain unchanged.

---

Legal & Compliance

Process only media you are authorized to access and transcribe. A public or embedded player does not automatically grant rights to copy, translate, republish, profile, or train on its contents. Follow copyright, privacy, contractual, employment, sector-specific, and data-protection requirements.

Wistia owners can use public links, folder permissions, passwords, expiring links, and domain restrictions. This Actor does not bypass those controls. Wistia's current Terms of Service restrict robots, scraping, data mining, and automated retrieval of service materials. Use this Actor only where the account owner and content owner have authorized the workflow and the applicable agreement permits it.

Minimize personal data, define a lawful purpose and retention period, and support correction or deletion where required. Require human review before publishing transcripts or using them for consequential decisions.

---

Related Tools

• YouTube Transcript processes one public YouTube video.
• TikTok Transcript processes one public TikTok video.
• Video Transcript handles uploads and supported public video URLs.

Use All Video Scraper for broader video discovery and metadata workflows. Use Video Transcript when uploaded-file support is required.

---

Support & Community

• Actor documentation
• API reference
• Telegram support
• All AgentX APIs

For reproducible support, provide the run ID, the public media URL if safe, the approximate run time, and the failed stage. Remove access tokens, private links, and sensitive transcript content before sharing logs.