Fathom Quote Extractor

An Apify Actor that extracts video chunk download URLs for specific quotes from Fathom meeting recordings.

Features

• Extract video chunk URLs for exact quotes from Fathom transcripts
• Batch processing of multiple quotes in a single run
• Fuzzy matching to handle transcription variations (filler words, punctuation)
• Structured JSON output with download URLs and metadata

Input

The Actor accepts the following input:

{
  "fathomShareUrl": "https://fathom.video/share/ABC123",
  "quotes": [
    "This is the first quote to find",
    "This is another quote to extract"
  ],
  "delayBetweenQuotes": 1.0,
  "pageLoadTimeout": 30
}

Field	Type	Required	Description
fathomShareUrl	string	Yes	Fathom share URL (must start with https://fathom.video/share/)
quotes	array	Yes	Array of quote strings to find in the transcript
delayBetweenQuotes	number	No	Delay in seconds between processing quotes (default: 1.0)
pageLoadTimeout	number	No	Page load timeout in seconds (default: 30)

Output

The Actor outputs a dataset with the following structure:

{
  "fathomShareUrl": "https://fathom.video/share/ABC123",
  "results": [
    {
      "quote": "This is the first quote to find",
      "downloadURL": "https://fathom-recording-data.storage.googleapis.com/chunk/...",
      "found": true,
      "chunkId": "12345678_1_00042"
    },
    {
      "quote": "This is another quote to extract",
      "downloadURL": "",
      "found": false,
      "chunkId": null
    }
  ],
  "processedAt": "2024-01-15T10:30:00.000Z",
  "totalQuotes": 2,
  "quotesFound": 1,
  "quotesNotFound": 1
}

Local Development

Prerequisites

• Python 3.10+
• Chrome browser (for local testing)
• Apify CLI

Setup

1. Clone the repository
2. Create a virtual environment:

   python -m venv .venv
   source .venv/bin/activate  # On Windows: .venv\Scripts\activate
   

3. Install dependencies:

   $pip install -r requirements.txt
   

Running Locally

1. Create input file at storage/key_value_stores/default/INPUT.json:

   {
     "fathomShareUrl": "https://fathom.video/share/YOUR_SHARE_ID",
     "quotes": ["Your quote to find"]
   }
   

2. Run the Actor:

   $apify run
   

3. Check output in storage/datasets/default/

Deployment

Deploy to Apify

apify login
apify push

CI/CD

This repository includes GitHub Actions workflows for:

• Lint & Test: Runs on every push and PR
• Deploy to Apify: Automatically deploys on push to main branch

Required secrets for deployment:

• APIFY_TOKEN: Your Apify API token

How It Works

1. Navigate: Opens the Fathom share URL in a headless Chrome browser
2. Load Transcript: Clicks the TRANSCRIPT tab and waits for content
3. Find Quote: Searches transcript segments using:
   • Exact text matching
   • Fuzzy matching (ignoring filler words like "uh", "um")
   • Word overlap matching (70% threshold)
4. Capture URL: Clicks the matching segment and captures the video chunk URL from network requests
5. Output: Returns structured results with download URLs

Limitations

• Requires a valid, non-expired Fathom share URL
• Quote must exist in the transcript (verbatim or with minor variations)
• Download URLs are time-limited (typically 6 hours)

License

MIT