---

🌟 Facebook Transcript & Subtitle scraper – README.md

📌 Overview

Facebook Video Transcript Scraper is a powerful and easy-to-use actor designed to extract accurate transcripts and related metadata from public Facebook videos using video URLs or share links.

With just a single run, you can collect:

• Full time-synced transcripts
• Clean paragraph-style text
• One-line combined text
• Video title, description, and thumbnail

⚡ No complex setup. ⚡ No proxy required. ⚡ Just paste links and run.

---

🚀 What This Actor Does

This actor allows you to:

• Extract spoken content (transcripts) from Facebook videos
• Get time-stamped subtitles (second-by-second format)
• Convert transcripts into paragraph format
• Generate one-line clean text for quick use
• Collect basic video metadata (title, description, thumbnail)

All from public Facebook video links or share links.

---

📥 Input

🔹 Required Input Field

Field	Type	Description
videoUrls	Array	List of Facebook video URLs or share links

---

🎯 Output Formats

This actor supports 4 powerful output modes:

1. all_type
2. transcript_timesup
3. transcript_text
4. one_line_text

Each format is explained in detail below 👇

---

🟢 1. all_type (Full Data Mode)

This is the complete output mode. It returns everything in one response:

• Video metadata
• Time-stamped transcript
• Paragraph transcript
• One-line combined text

📦 Fields Returned

Field	Description
url	Original Facebook video URL
title	Video title
description	Video description
thumbnail_url	Video thumbnail image
transcript	Time-stamped transcript (second-by-second)
transcript_text	Clean paragraph transcript
one_line_text	Full transcript in one single line

🧾 Sample Output

{
  "url": "https://www.facebook.com/watch?v=1152968962664538",
  "title": "Amazing Street Interview",
  "description": "An interview with people on the street",
  "thumbnail_url": "https://example.com/thumb.jpg",
  "transcript": [
    { "start": 0.5, "end": 3.2, "text": "Hello everyone" },
    { "start": 3.3, "end": 6.1, "text": "Welcome to our show" }
  ],
  "transcript_text": [
    "Hello everyone",
    "Welcome to our show"
  ],
  "one_line_text": "Hello everyone Welcome to our show"
}

---

🟡 2. transcript_timesup (Second-by-Second Mode)

This mode returns only time-synced transcript data. Perfect for:

• Subtitle editors
• Video captioning
• Precise timing analysis

📦 Fields Returned

Field	Description
url	Video URL
title	Video title
description	Video description
thumbnail_url	Thumbnail
transcript	Time-stamped transcript only

🧾 Sample Output

{
  "url": "https://www.facebook.com/watch?v=1152968962664538",
  "title": "Amazing Street Interview",
  "description": "An interview with people on the street",
  "thumbnail_url": "https://example.com/thumb.jpg",
  "transcript": [
    { "start": 0.5, "end": 3.2, "text": "Hello everyone" },
    { "start": 3.3, "end": 6.1, "text": "Welcome to our show" }
  ]
}

---

🔵 3. transcript_text (Paragraph Mode)

This mode returns clean readable transcript text without timestamps. Best for:

• Blog posts
• Articles
• Content rewriting
• Translation

📦 Fields Returned

Field	Description
url	Video URL
title	Video title
description	Video description
thumbnail_url	Thumbnail
transcript_text	Paragraph-style transcript

🧾 Sample Output

{
  "url": "https://www.facebook.com/watch?v=1152968962664538",
  "title": "Amazing Street Interview",
  "description": "An interview with people on the street",
  "thumbnail_url": "https://example.com/thumb.jpg",
  "transcript_text": [
    "Hello everyone",
    "Welcome to our show",
    "Today we are asking people about their dreams"
  ]
}

---

🟣 4. one_line_text (Single Line Mode)

This mode returns the entire transcript merged into one clean line. Best for:

• AI training
• Keyword extraction
• Search indexing
• Quick copy-paste use

📦 Fields Returned

Field	Description
url	Video URL
title	Video title
description	Video description
thumbnail_url	Thumbnail
one_line_text	Full transcript in one line

🧾 Sample Output

{
  "url": "https://www.facebook.com/watch?v=1152968962664538",
  "title": "Amazing Street Interview",
  "description": "An interview with people on the street",
  "thumbnail_url": "https://example.com/thumb.jpg",
  "one_line_text": "Hello everyone Welcome to our show Today we are asking people about their dreams"
}

---

output after run:

🛠️ Input

The actor accepts a JSON object containing an array of video URLs or share links:

{
    "videoUrls": [
        {
            "url": "https://www.facebook.com/watch?v=1152968962664538"
        },
        {
            "url": "https://www.facebook.com/share/v/17jekeg46H/"
        },
        {
            "url": "https://www.facebook.com/100044280796927/videos/4141502542759187"
        }
    ]
}

🧾 Sample Output

[
  {
    "url": "https://www.facebook.com/watch?v=1152968962664538",
    "title": "Transformers Rise of the Beasts Scourge",
    "description": "Transformers Rise of the Beasts Scourge😉😉😉😉😉",
    "thumbnail_url": "https://scontent-iad3-2.xx.fbcdn.net/v/t15.5256-10/452280330_1284811705834229_2431065926875604156_n.jpg?_nc_cat=103&ccb=1-7&_nc_sid=be8305&_nc_ohc=hExhwV-pM0IQ7kNvwECtMNq&_nc_oc=AdnGeBjwSsrlxuzRnhjpcqIZDOHcFeMdyL19lW-5o2PYZSH6tE21hyH6IZUBtOZrsjU&_nc_zt=23&_nc_ht=scontent-iad3-2.xx&_nc_gid=HGT-8LneMS7p7qL3Zo_FUQ&oh=00_Afq7zwdD5u90ORW0ugrM03tBefoB7ikw_73h4hGSPuU4jQ&oe=6962D0BE",
    "transcript": [
      {
        "start": 6.161,
        "end": 11.421,
        "text": "But he didn't just come for our planet. He wanted our greatest"
      },
      {
        "start": 11.421,
        "end": 16.981,
        "text": "technology, the Trans War Key and he sent his most powerful"
      },
      
    ],
    "transcript_text": [
      "But he didn't just come for our planet. He wanted our greatest",
      "technology, the Trans War Key and he sent his most powerful",
      "henchmen to collect it. Scourge,",
      "More enemies are landing. We won't be safe for long. Do we",
      "have the key? Keep it hidden. It never falls into the hands",
      "of Unicron but Apelink, we can fight. No, protecting our",
      "Transworp key is all that matters. Go. Use it to escape.",
      "What will you do? I'll hold him off. Buy you some time, then",
      "I'm staying with you. This is my fight. Listen, if Yurikron",
      "were to get the key, he could open a portal through time and",
      "space with no end to the worlds he could destroy. It is now",
      "your time to lead the Maximus, Optimus, Primal",
      "So, you're this planet's great warrior. You have such a",
      "beautiful world. Filled with an abundance of life.",
      "Savory. My master grows hungry. Give me the Transworp key and",
      "he will spare your home. We'd rather die than let him reach",
      "other planets. So be it.",
      "Benefits of serving the almighty Unicron.",
      "They never learn. You're too late, Scourge. Your master will",
      "be trapped in this galaxy forever.",
      "Sacrifice will be our oath to preserve the key no matter the",
      "cost."
    ]

    "one_line_text" : "But he didn't just come for our planet. He wanted our greatest technology, the Trans War Key and he sent his m............."
  },
  {
    "url": "https://www.facebook.com/share/v/17jekeg46H/",
    "title": "Here comes the Bean!",
    "description": "Here comes the Bean! 👰 🎩",
    "thumbnail_url": "https://scontent-iad3-1.xx.fbcdn.net/v/t15.5256-10/71138839_10158233777576469_5231012459760312888_n.jpg?_nc_cat=102&ccb=1-7&_nc_sid=be8305&_nc_ohc=YyT3xM3BOcAQ7kNvwHQ6nAO&_nc_oc=AdmM5MCEWmvoMQwplzB364DuBZLdz2BRyyoyVt7u13aoy44EX_GpBBPpA1wN0c4QwHo&_nc_zt=23&_nc_ht=scontent-iad3-1.xx&_nc_gid=NHikIoNxWuxOuoka6n6wrw&oh=00_Afo6LFUj160IZqaLtY88jQiSgv1KdB4PM-_Pbne6gwinyQ&oe=6962DC39",
    "transcript": [
      {
        "start": 0.161,
        "end": 3.861,
        "text": "In the name of the father, of the son, and the Holy Spirit."
      },
      {
        "start": 3.861,
        "end": 6.661,
        "text": "We've come together today to witness the marriage of Daniel"
      },
      {
        "start": 6.661,
        "end": 10.501,
        "text": "and Kate to pray for god's blessing on them to share their"
      }.............
    ],
    "transcript_text": [
      "In the name of the father, of the son, and the Holy Spirit.",
      "We've come together today to witness the marriage of Daniel",
      "and Kate to pray for god's blessing on them to share their",
      "joy and to celebrate their love. Marriage is a way of life",
      "made holy by god and blessed by the presence of our lord Jesus",
      "Christ celebrating with those at a wedding at Cana in",
      "Galilee. Marriage is a sign of unity. Into that bond and",
      "honour. No one should enter into it lightly or selfishly",
      "but reverently and responsibly. It enriches society and",
      "strengthens community. Bless them in joy and in sorrow in",
      "life and in death. Finally, bring them to that banquet",
      "where your saints feast forever in your heavenly home. Daniel",
      "and Kate are now to enter this way of life. They will each",
      "give their sent to the other and make solemn vows and in",
      "token of this, they will each give and receive a ring. We",
      "pray with them. Holy Spirit will guide and strengthen them",
      "that they may fulfill god's purposes for the whole of their",
      "earthly lives together.",
      "First, I'm required to ask anyone present who knows a",
      "reason why these persons may not lawfully marry to declare",
      "it now.",
      "Moving on. Marriage is a gift of god in creation through",
      "which husband and wife may know the grace of it is given as the",
      "foundation of family life in which children are nurtured and",
      "in which each member of the family in good times and bad",
      "may find strength companionship and comfort and grow to",
      "maturity in love Let their love for each other be a seal upon",
      "their hearts and a crown upon their heads.",
      "Jump.",
      "The gift of marriage brings husband and wife together in",
      "the delight and the tenderness of sexual union. To the end of",
      "their lives."
    ]

    "one_line_text": "In the name of the father, of the son, and the Holy Spirit. We've come together today to witness the marriage of Daniel and Kate to pray for......"
  },
  {
    "url": "https://www.facebook.com/100044280796927/videos/4141502542759187",
    "title": "BREAKING: Judge takes AGGRESSIVE ACTION against Trump",
    "description": "BREAKING: Judge takes AGGRESSIVE ACTION against Trump\n\nPlease support my work by subscribing to my YouTube channel: www.youtube.com/briantylercohen",
    "thumbnail_url": "https://scontent-iad3-2.xx.fbcdn.net/v/t15.5256-10/566537909_2587597258285181_3058603179448813206_n.jpg?_nc_cat=111&ccb=1-7&_nc_sid=be8305&_nc_ohc=v7JAoxFYEW8Q7kNvwGjd-Lw&_nc_oc=AdmSkxHcx0jhIu4C76HUhjk1kFwdR2jr48DKkziiQ1CodhohoaoRNBXERxaBXeBysn4&_nc_zt=23&_nc_ht=scontent-iad3-2.xx&_nc_gid=sZNEZZOpzOcIsx7WJEgU4w&oh=00_AfrQj1qiFzpDeQcTsrkYMNVUELv3pvsNhUIHDDdcmZ3cuw&oe=6962DEBF",
    "transcript": [
      {
        "start": 0,
        "end": 1.841,
        "text": "You're watching the legal breakdown. Glenn we've got"
      },
      {
        "start": 1.841,
        "end": 3.921,
        "text": "breaking news here that's that's going to have major"
      },
      {
        "start": 3.921,
        "end": 6.561,
        "text": "implications, major ramifications on Donald Trump's"
      },
      {
        "start": 6.561,
        "end": 8.961,
        "text": "ability to deploy the troops. And I know it's been a little"
      },
      {
        "start": 8.961,
        "end": 11.441,
        "text": "bit of a mixed bag these last couple of days but we've"
      },
      {
        "start": 11.441,
        "end": 13.681,
        "text": "actually got some bit of a silver lining here in this"
      },
      {
        "start": 13.681,
        "end": 16.401,
        "text": "latest decision from a judge. Can you explain what just"
      },
      {
        "start": 825.021,
        "end": 827.981,
        "text": "Legal Breakdown."
      }...........................

    ],
    "transcript_text": [
      "You're watching the legal breakdown. Glenn we've got",
      "breaking news here that's that's going to have major",
      "implications, major ramifications on Donald Trump's",
      "ability to deploy the troops. And I know it's been a little",
      "bit of a mixed bag these last couple of days but we've",
      "actually got some bit of a silver lining here in this",
      "latest decision from a judge. Can you explain what just",
      "happened in court? Yeah Brian a a federal district court judge",
      "in Illinois has extended for 30 days. Her prohibition telling",
      "the Trump administration no you may not deploy National Guard",
      "troops onto the streets of Chicago or into the state of",
      "Illinois but Brian there is so much swirl there are so many",
      "different court cases in the trial courts in the courts of",
      "appeal and of course Donald Trump is trying desperately to",
      "get the Supreme Court to sort of big foot all of these you",
      "know............" 
    ]

    "one_line_text": "You're watching the legal breakdown. Glenn we've got breaking news here that's that's going................"
  }
]

---

📊 Explanation of Each Output Field

Field	Meaning
url	The Facebook video link you provided
title	The official title of the video
description	The description written by the uploader
thumbnail_url	Preview image of the video
transcript	Array of objects containing start time, end time, and spoken text
transcript_text	Simple readable transcript lines without timing
one_line_text	All transcript text merged into one single sentence

---

🌟 Features

• ✅ Supports multiple video URLs at once
• ✅ Works with video links & share links
• ✅ Extracts accurate spoken content
• ✅ Provides four different output styles
• ✅ Clean, structured, and ready-to-use data
• ✅ No setup complexity – just paste & run
• ✅ Ideal for content creators, marketers, researchers, and developers

---

💎 Benefits & Advantages

• Save Time – no manual transcription
• High Accuracy – clean readable text
• Flexible Formats – choose exactly what you need
• Bulk Processing – scrape many videos in one run
• Content Repurposing – turn videos into blogs, posts, captions
• SEO Friendly – perfect for keyword and content analysis
• AI Ready – usable for training data and NLP tasks

---

🧠 Best Practices

• ✔ Always use public Facebook video links
• ✔ Add multiple URLs in one run to save time
• ✔ Use transcript_timesup for subtitles & editing
• ✔ Use transcript_text for articles & rewriting
• ✔ Use one_line_text for AI, SEO, and search use
• ✔ If something fails, simply rerun the actor

---

⚠️ Possible Errors & How to Avoid Them

1. ❌ No transcript returned

Reason: Video may not have spoken content or captions Solution: Try another video

---

2. ❌ Empty output

Reason: Invalid or private video link Solution: Make sure the video is public and accessible

---

3. ❌ Partial transcript

Reason: Some parts of the video may not contain speech Solution: This is normal – use full videos for best results

---

4. ❌ Actor stopped or failed

Reason: Temporary issue or network interruption Solution: Just rerun the actor – it will work normally

---

👑 Why Use This Actor?

This actor is built for speed, simplicity, and accuracy.

Whether you are:

• a content creator
• a marketer
• an SEO expert
• a developer
• a researcher

This tool helps you turn Facebook videos into usable text data in seconds.

---

📞 Support

If you face any issues or need help:

📧 Contact: alphascraper69@gmail.com

---

🏁 Final Note

Just:

1. Paste your Facebook video links
2. Choose your preferred output format
3. Run the actor
4. Get clean, structured transcript data 🎯

No complications. No headache. Just results. 💪

---