# JustAnotherArchivist/snscrape

A social networking service scraper in Python

Repository: https://github.com/JustAnotherArchivist/snscrape
Canonical: https://ross.abutalabs.com/products/snscrape
Language: Python
License: GPL-3.0
License Family: copyleft
Topics: python, scraper, social-network, social-media
Last push: 2023-11-15T00:21:52+00:00

## Health v2 (maintenance only)
Score: 32/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 0, release rhythm 35, longevity 100
- inputs: {"age_days": 2915, "days_push": 1023, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 5444, forks 781 (observed 2026-08-28T04:09:18.329682+00:00)

## What it is
snscrape is a Python-based scraper for social networking services that extracts posts, profiles, hashtags, and search results from platforms like Twitter, Facebook, Instagram, Reddit, Mastodon, Telegram, VK, and Weibo. It works both as a command-line tool with JSONL output and as a Python library.

## Use cases
- scrape all tweets by a twitter user
- collect posts with a hashtag on twitter or instagram
- download telegram channel history
- archive reddit subreddit posts via pushshift
- export social media posts as l for analysis
- fetch a user profile from vk or weibo
- gather mastodon toots from a user or thread

## When to choose
- you need to collect public social media posts without official API keys
- you want JSONL output with rich metadata for research or archiving
- you need a lightweight CLI that pipes into other tools
- you want to use scraping as a Python library

## When to avoid
- you need authenticated or private content access
- you need guaranteed reliability — platforms frequently change and break scrapers
- you need official API compliance or terms-of-service-safe collection
- you need a maintained library — development has slowed and some scrapers (e.g. Twitter) may be broken

## Facets
- artifact type: cli-tool
- maturity: maintenance
- function: web-scraping, cli, data-generation
- domain: social-media, crawlers, developer-tools
- platform: python, cli, cross-platform
- tags: social-media-scraper, twitter, reddit, instagram, mastodon, telegram, l-output, archiving, command-line

## Member repositories
- JustAnotherArchivist/snscrape (main) score 32

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:09:18.329682+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T17:56:51.280146+00:00, confidence not recorded.
  - readme: https://github.com/JustAnotherArchivist/snscrape (fetched 2026-08-28T04:09:18.329682+00:00, sha b27507fd327b)
  - registry_pypi: https://pypi.org/pypi/snscrape/json (fetched 2026-08-29T08:51:54.786627+00:00, sha b8bd20b21fa1)
- Data as of 2026-08-30T08:39:29.467469+00:00.