Select records
Request /v1/posts with q=scraping and subreddit=webscraping; start with limit=3.
Historical Reddit data · JSON API
Replace Reddit HTML collection with API requests
Use archived Reddit records to replace HTML collection with documented requests. This example requests one page of up to three records.
GETJSONHTTPS
Request anatomy
/v1/postswebscraping01Each successful request costs one credit, including an empty result.
100Pages and limits
$1 / 1,000Request-based billing
01 / Reddit Scraping
Reddit Scraping — From query to usable records
Start with a small selection. Keep the fields and request settings your next step needs, then handle the result in your own application.
Prepare the response
Map the old collector’s read operations to documented routes; keep HTML parsing out of the new JSON path.
Use it in your project
Inspect which fields are present before requiring title or text in your destination schema.
A request you can adapt
curl --get --fail-with-body 'https://api.redditscraping.com/v1/posts' \
-H "Authorization: Bearer ${REDDIT_API_KEY}" \
--data-urlencode 'q=scraping' \
--data-urlencode 'subreddit=webscraping' \
--data-urlencode 'limit=3' \
--data-urlencode 'page=1'This example requests one page of up to three records.
API base URL
https://api.redditscraping.com/v1Control the scope of each request
Text and community
Combine q with subreddit or author to narrow the selection.
UTC date range
Use from and to as YYYY-MM-DD dates. The end date includes the whole UTC day.
Pages and limits
Set limit and page, then keep the pagination metadata with your saved results.
Pay per successful request
Each successful request costs one credit, including an empty result.
$1 / 1,000 successful requests
Minimum top-up: $50 · 50,000 credits
FAQ / 08
Before you integrate
What is Reddit Scraping?
Reddit Scraping is an independent JSON API for historical Reddit records. It provides read-only routes for search, posts, comments, individual items and subreddit discovery. It is not operated by or affiliated with Reddit. Use archived Reddit records to replace HTML collection with documented requests. This example requests one page of up to three records.
How do I get an API key?
Create an account with email and password on this site. The key is shown immediately after signup, before a payment is required; save it securely because it is shown once. Send it from your server using X-API-Key or Authorization: Bearer. Regenerating the key invalidates the previous one.
How much does Reddit Scraping cost?
The price is $1 per 1,000 successful requests. The minimum top-up is $50 for 50,000 credits. Each successful request uses one credit, even when it returns no matching records. Invalid requests are not charged; upstream failures trigger a refund, which can require reconciliation. A timeout alone does not establish the final billing outcome.
Which filters can I use to search Reddit records?
Use q for analyzed text search and combine it with subreddit, author, kind, from, to or min_score. Multiple search words use AND semantics; this is not a semantic-search or arbitrary-query-DSL endpoint. Dates use YYYY-MM-DD in UTC, with the to date including the whole day. Start with documented parameters in the reference.
Does Reddit Scraping provide live Reddit access?
No. This service reads a historical archive, not a live Reddit feed. It cannot publish posts, vote, send private messages or perform Reddit OAuth actions. The public /v1/status route describes the service scope; it does not prove archive health, complete coverage or current availability of an original Reddit page.
Can I export every record that matches a search?
Not necessarily. A request returns up to 100 records, and page ranges from 1 to 100. Read total together with pagination.relation: exact, lower bound or unknown. Results follow archive order rather than guaranteed chronological or relevance order. Reaching the last accessible page does not prove that a saved sample is exhaustive.
Can I reuse the same key on another domain?
No. Accounts, API keys and credit balances are separated by site. Use the key issued for this domain with its own HTTPS API hostname. Keep that key in server-side configuration, not in browser JavaScript, public repositories or shared logs. A key from another site is not a substitute for a local account.
Which request should I try first?
Start with /v1/posts, q=scraping, subreddit=webscraping, limit=3 and page=1. This small request lets you inspect available fields before writing import or interface logic. It still costs one credit when successful, including an empty result. Adjust the topic and community for your task; the example is not a promise of a fixed record count.
API / Reddit Scraping
Get API key Build the first request
Create your account, save the key, and adapt the example to your task.
