Reddit API - Things every developer should know
Data Integrity
Data integrity refers to the accuracy, consistency, and reliability of data over time. To guarantee the integrity of the data provided by our API, Trawlingweb implements the following practices:
- Continuous Verification: Data is continuously verified during analysis to ensure accuracy and consistency.
- Error Correction: Any inconsistency or error detected in the data is corrected immediately to maintain reliability.
- Regular Update: Data is updated regularly to reflect the most recent and relevant information, minimizing the chance of stale data.
- Source Maintenance: Periodic maintenance is performed on the indexed subreddits to ensure that the processed data is of high quality and current.
Implementing these measures helps our clients maintain the integrity and reliability of the data processed by Trawlingweb.
REST API
reddit.trawlingweb.com is a REST API, so although the data is meant to be consumed as a stream, you need to call the API continuously to receive the data batches.
Authentication
Authentication is confirmed via a unique access token passed in the API URL together with the Worker ID to ingest. You can find your access token and your Worker IDs in the dashboard.
Rate Limit
All Reddit API plans include a single primary access token along with the specific identifier of each Worker. A rate limit of one request every 5 seconds is applied. To exceed this limit, a specific request must be made.
Output Formats
We provide the data in the following output format:
| Format | Description |
|---|---|
| JSON | JavaScript Object Notation |
HTTP / HTTPS support
reddit.trawlingweb.com supports both HTTP and HTTPS (SSL) endpoint calls. HTTPS is always recommended.
GET Requests
You can call the API using GET requests. If you make very long queries, split them into shorter ones (using ts and tsi to bound the temporal range).
HTTP Status Codes
| Code | Description |
|---|---|
| 200 | Success! |
| 400 | Missing params or malformed query |
| 401 | Unauthorized user or no available tokens |
| 404 | Syntax error |
| 429 | Rate limit exceeded |
| 500 | Could not execute the query |
| 503 | Service temporarily unavailable |
NOTE: Error details explained in the response payload.
Contact
If you have any questions, need assistance, or want to subscribe or expand your services, please contact us.
SAT (Technical Support):
SAC (Administrative Support):
Sales (Sales Support):