Not Reddit's official Data API
Public Reddit Data API (Independent, Read-Only)
Structured JSON for public Reddit posts, comments, search, and subreddit metadata—built for research pipelines and data warehouses. One Bearer key, Credits only on success.
What this is not
- Not Reddit's official Data API product. “Reddit Data API” on reddithelp.com refers to Reddit's own program.
- Not Reddit's official API, and not affiliated with or endorsed by Reddit Inc.
- Not a way around Reddit's Data API terms or app-registration process. If you need official access, apply through Reddit.
- Read-only public data. No posting, commenting, voting, messaging, or moderation.
- No logged-in user data: no inboxes, saved or upvoted items, private or quarantined communities.
- Not a full historical archive or deleted-content recovery tool.
- You remain responsible for how you collect, store, and use Reddit data. This page is not legal advice.
Official references: Data API Wiki · Data API Terms · App Registration
Data catalog (public reads)
Endpoint groups that exist today—field examples follow live responses; OpenAPI leaves many data objects open.
Posts
/posts, /posts/{id}, /by_id/{fullnames} for public post payloads.
Comments
Live /comments paths, per-post comments, single comment, plus async comment jobs.
Search
/search, /search/comments, /search/communities, /search/media.
Subreddit metadata
/sub/{name}/about|rules|top|wiki and subreddit directory routes.
Collection
Comment jobs and subreddit monitors for ongoing collection.
Response envelope
success / data / optional meta—confirm shapes against live samples and OpenAPI.
Official Data API vs this independent API
What it is
Official Reddit Data API: Reddit's own Data API (app registration + OAuth; see Reddit docs)
SpideyData /v1/reddit: Independent hosted public-data read REST API; not affiliated with Reddit
Auth for public reads
Official Reddit Data API: Reddit app credentials / OAuth
SpideyData /v1/reddit: SpideyData Bearer API key—no caller-built Reddit OAuth app for these public reads
Public posts / comments / search
Official Reddit Data API: Yes (via official API)
SpideyData /v1/reddit: Yes via /v1/reddit
User inbox / saved / upvoted
Official Reddit Data API: Yes with user OAuth scopes
SpideyData /v1/reddit: No
Write / vote / mod
Official Reddit Data API: Yes with appropriate scopes
SpideyData /v1/reddit: No—read-only
Collection helpers
Official Reddit Data API: —
SpideyData /v1/reddit: Async comment jobs; subreddit monitors
Minimal read
- Authenticate with a SpideyData Bearer key.
- Call the catalog route you need (posts, comments, search, …).
- Map JSON into your warehouse; confirm meters on Pricing.
$ curl -sS -G "$SPIDER_BASE_URL/v1/reddit/posts" \
-H "Authorization: Bearer $SPIDER_API_KEY" \
--data-urlencode "subreddit=datascience" \
--data-urlencode "sort=new" \
--data-urlencode "limit=25"Into your pipeline
Page with after/cursor where documented. Stored comment job pagination and job polling use free meters when billing is active. Treat payloads as JSON → warehouse inputs—not a guaranteed field-stable warehouse product beyond the documented envelope.
Meter tiers (no unit prices here)
Public reads, visibility, expanded/deep search, comment jobs, and monitors use named meters. This page does not hard-code credit unit prices—see Pricing for current rates.
Is this the right fit?
Choose this path for managed public Reddit JSON. Do not expect:
- Full historical Reddit archive or deleted-content recovery
- Keyword or brand-mention monitoring inbox
- Private, quarantined, or logged-in-only content
- Official Reddit API approval bypass or write/mod OAuth replacement
- Hard-coded credit unit prices on this page—see Pricing for meters
- Complete field-level schemas beyond OpenAPI/live samples
- Official Data API partnership or approval substitution
Credits & billing
Public reads and successful deliveries use Plan Credits. Exact meters and rates follow Pricing; failed requests on our side are not charged when billing is active. Confirm live meters in Pricing and the Reddit API docs before publishing numbers.
Frequently asked questions
Use an independent public Reddit data API
Get an API key, browse the endpoint catalog in docs, and confirm meters on Pricing.