explaingit

hasyaapp/threads-scraper

Analysis updated 2026-06-24

18JavaScriptAudience · generalComplexity · 1/5LicenseSetup · easy

TLDR

A Tampermonkey userscript that scrapes every post from a public Threads profile in the browser and exports the result as JSON, CSV, or Markdown.

Mindmap

mindmap
  root((threads-scraper))
    Inputs
      Public Threads URL
      Scroll delay
      Deep mode toggle
    Outputs
      JSON export
      CSV export
      Markdown export
    Use Cases
      Archive your posts
      Research a creator
      Capture reply threads
    Tech Stack
      JavaScript
      Tampermonkey
      Lucide
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Archive your own Threads posts as JSON before deleting the account

USE CASE 2

Pull a public creator's posts and replies into Notion or Obsidian

USE CASE 3

Export a profile to CSV for analysis in a spreadsheet

USE CASE 4

Capture reply threads where the profile owner participated using Deep mode

What is it built with?

JavaScriptTampermonkey

How does it compare?

hasyaapp/threads-scraperchinaran0/wujing_diccyizeredev/epms
Stars181818
LanguageJavaScriptJavaScriptJavaScript
Setup difficultyeasyeasymoderate
Complexity1/52/53/5
Audiencegeneralops devopsdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Requires Tampermonkey installed in the browser, and only works on public profile pages because there is no login or network interception.

MIT license, you can use, modify, and redistribute freely as long as you keep the copyright notice.

In plain English

threads-scraper is a small browser script that downloads every post from a public profile on Threads, the social network from Meta. It is delivered as a userscript, which is a kind of mini-extension you load through a browser add-on called Tampermonkey. Once installed, you visit any Threads profile URL of the form https://www.threads.com/@username and a small panel appears in the top-right of the page. You press a button and the script scrolls through the profile, collecting posts, images, video URLs, timestamps, and like counts, and stops automatically when it stops finding new posts. There are a few options you can set before starting. A scroll delay controls how many milliseconds the script waits between scrolls (1800 by default), with slower scrolls catching more text. A checkbox includes the profile's Replies tab in addition to the main feed. A separate Deep mode opens each post on its own page after the main scrape and pulls out the comment threads, keeping only the conversations where the profile owner actually replied. Deep mode is slow because it makes one extra request per post, so 200 posts takes about five to ten minutes. When the scrape finishes you can download the result as JSON, CSV, or Markdown. The JSON output includes the username, total counts, and an array of posts, each with its code, text, timestamp, like count, image URLs, a flag for whether it has video, and any captured conversations. The CSV is a flat spreadsheet-friendly version with one row per post. The Markdown export is meant to be readable, with headers and quoted conversations, and the README suggests dropping it into Notion or Obsidian. The README is honest about how the scraper works and what it cannot do. Threads only renders the posts currently in view, so the script scrolls in small steps and re-reads the DOM, merging information as posts re-appear. Deep mode parses hidden JSON inside the post pages. There is no login and no network interception, which is why it works alongside ad blockers, but it also means private accounts cannot be scraped, like counts may sometimes come through as zero if Threads does not expose them, and the script only runs on profile pages, not the home feed. It is written in plain JavaScript with Lucide icons, has no dependencies, and is released under the MIT license.

Copy-paste prompts

Prompt 1
Install threads-scraper as a Tampermonkey userscript and walk me through scraping a public profile to Markdown
Prompt 2
Modify threads-scraper to also capture quote-post links and add a column in the CSV output
Prompt 3
Adjust the scroll delay in threads-scraper to be safer on slow connections without missing posts
Prompt 4
Write a Python script that reads threads-scraper JSON and computes top posts by like count
Prompt 5
Add a filter to threads-scraper that only exports posts within a given date range

Frequently asked questions

What is threads-scraper?

A Tampermonkey userscript that scrapes every post from a public Threads profile in the browser and exports the result as JSON, CSV, or Markdown.

What language is threads-scraper written in?

Mainly JavaScript. The stack also includes JavaScript, Tampermonkey.

What license does threads-scraper use?

MIT license, you can use, modify, and redistribute freely as long as you keep the copyright notice.

How hard is threads-scraper to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is threads-scraper for?

Mainly general.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.