Select records
Request /v1/search with q=search and subreddit=SideProject; start with limit=3.
Historical Reddit data · JSON API
Add Reddit discussion search to your application
Use archived Reddit records to add discussion search to a web or mobile app. This example requests one page of up to three records.
GETJSONHTTPS
Request anatomy
/v1/searchSideProject01Each successful request costs one credit, including an empty result.
100Pages and limits
$1 / 1,000Request-based billing
01 / Reddit App API
Reddit App API — 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
Keep the API key on your backend; send only the selected response data to the browser or mobile app.
Use it in your project
Retain an available permalink with your notes as a source reference; the linked page may later be unavailable.
A request you can adapt
curl --get --fail-with-body 'https://api.redditapp.com/v1/search' \
-H "Authorization: Bearer ${REDDIT_API_KEY}" \
--data-urlencode 'q=search' \
--data-urlencode 'subreddit=SideProject' \
--data-urlencode 'limit=3' \
--data-urlencode 'page=1'This example requests one page of up to three records.
API base URL
https://api.redditapp.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 App API?
Reddit App API 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 add discussion search to a web or mobile app. 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 App API 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 App API 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/search, q=search, subreddit=SideProject, 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 App API
Get API key Build the first request
Create your account, save the key, and adapt the example to your task.
Continue with a guide
Add a reading stop to the trip-planning journeyDo not make an empty list explain every outcomeA walker needs a search box, not your archive keyShow more should mean one deliberate next pageBudget what the app requests, not what the reader seesA date should explain the evidence, not decorate the cardMake each card explain the record you actually receivedSave a reference without promising it will always be thereBuild the featureGuides
