slackscraperv1.4.2
Sign inAdd to Slack →
// how it works

Four steps,
five minutes.

A walkthrough of how Slackscraper actually works, from the OAuth handshake to the parquet file landing in your bucket. No magic, just plumbing.

// system diagram
YOUR SLACK WORKSPACE
OAuth · read-only · revocable
SLACKSCRAPER EDGE
stateless · processes events
YOUR DESTINATION
S3 · Snowflake · CSV · etc.
encrypted in transit never at rest with us
01

Install the Slack app

OAuth handshake with your workspace. We request the minimum read scopes Slack supports: channels:history, groups:history, im:history, mpim:history, files:read, reactions:read. A workspace admin approves and we never ask for write access — we cannot send messages, modify channels, or impersonate users.

~30 seconds
Slack Marketplace approved
OAuth 2.0
slackscraper · step 01
# Click "Add to Slack" — your workspace admin
# gets a one-time approval prompt with the exact
# scopes we're asking for. That's the whole install.
→ acme-corp.slack.com
→ requested scopes: 6 (all read-only)
→ approved: 2026-05-23T10:02Z
02

Backfill the history

Slackscraper crawls every channel you authorize, in parallel, respecting rate limits. Backfill is resumable: if the connection drops, it picks up where it left off. Idempotent: re-running it never duplicates a message.

Parallel · per-channel
Resumable on failure
Idempotent writes
slackscraper · step 02
$ slackscraper sync --workspace acme \
--since 2018-01-01
syncing #eng-platform ........... 100% · 412k
syncing #product-launch-q3 ...... 100% · 89k
syncing #incident-2026-05-14 .... 100% · 1.4k
...
✓ 8,241,902 messages · 1.6 GB · 4m 12s
03

Stream new events

After backfill, Slackscraper subscribes to your workspace's event stream over Slack's Events API. New messages, edits, deletions, reactions, and file uploads land in your warehouse within 200ms of being sent. Hourly and daily modes available if you don't want streaming.

Real-time (Team)
< 200ms message → warehouse
Includes edits + deletes
slackscraper · step 03
# Live event stream:
[10:42:18Z] message.created #eng-platform maya.chen
[10:42:19Z] reaction.added #eng-platform 👀 (3)
[10:43:04Z] message.created #eng-platform ravi.k
[10:44:55Z] message.edited #eng-platform jules
[10:45:12Z] message.created #eng-platform maya.chen
✓ 12,847 events · last 24h · 0 dropped
04

Ship to your destination

You configure where the data lands — your S3 bucket, your Snowflake account, your Postgres instance, or a flat CSV on your laptop. We hold sync state, but the data itself goes directly to you. Nothing of yours persists on our infra (on Team) past the moment it transits.

Your bucket, not ours
9 destinations
Partitioned by channel + month
slackscraper · step 04
# Configure once in slackscraper.config.yml:
destinations:
- type: s3
bucket: "acme-data"
prefix: "slack/"
format: parquet
partition: ["channel", "month"]
# Slackscraper writes:
s3://acme-data/slack/channel=eng-platform/
month=2026-05/part-0001.parquet
// the boring but important part

Security &
data handling.

Full security whitepaper →

Read-only scopes

We cannot send messages, modify channels, or impersonate users. Period.

Encrypted transit

TLS 1.3 from Slack to us. TLS 1.3 from us to your destination. Always.

No data at rest

On Team, messages stream directly to your bucket. We hold sync state only.

Revocable instantly

An admin can remove the app at any time. We stop receiving events immediately.

SOC 2 Type II

Audit in progress. Q3 2026 completion. SOC 2 Type I available on request.

GDPR + DPA

EU-region buckets and a signed Data Processing Agreement on request.

HIPAA

BAA available for Team customers. We do not process PHI on Free or Individual.

Audit log

Every sync, every config change, every API call — logged and exportable.

$ slackscraper init

Ready to try it?

Free tier, no card. Install on Slack, run one sync, see what comes out.

Add to Slack →
slackscraper

Built in Brooklyn + Lisbon.
SOC 2 in progress. EU residency available.

Product
FeaturesPricingHow it worksUse cases
Resources
DocsAPI referenceStatusSecurity
Company
AboutBlogContactCareers
© 2026 Slackscraper Inc. · Not affiliated with Slack Technologies.$ ssh status.slackscraper.io — all systems green