Reddit API endpoint
Returns Arctic Shift's native time-series values. Supply an absolute creation-time range and a precision; ranges that could exceed 1,000 points are rejected. Counts, score sums, and retrieval-delay sums are archive metrics, not current Reddit totals. Arctic Shift says time-series data may be approximate and take hours or days to update.
/reddit/archive/time-seriesQuery parameters:
metric (required): one of posts_count, comments_count, posts_score_sum, comments_score_sum, posts_retrieval_delay_seconds_sum, comments_retrieval_delay_seconds_sum, or subreddit_subscribers.subreddit (optional): scopes posts_count, comments_count, posts_score_sum, and comments_score_sum to one subreddit. It is required for subreddit_subscribers and cannot be used with either retrieval-delay metric.precision (required): one of year, quarter, month, week, day, hour, or minute.created_after, created_before (required): absolute epoch seconds/milliseconds or ISO 8601 dates/timestamps. Relative offsets are not accepted.Notable response behavior: this endpoint passes through Arctic Shift's native time-series data. Requests that could return more than 1,000 points are rejected; choose a coarser precision or shorter time range. Each point has date as Unix seconds and a numeric value. Counts and score sums describe archive data, not current Reddit totals. Arctic Shift says the series can be approximate and may take hours or days to update. Slow or throttled upstream requests return 503 with Retry-After.
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| metric | string | Yes | Archive metric Allowed values: posts_count, comments_count, posts_score_sum, comments_score_sum, posts_retrieval_delay_seconds_sum, comments_retrieval_delay_seconds_sum, subreddit_subscribers. | posts_count | |
| subreddit | string | No | Optional subreddit scope; required for subreddit_subscribers, and unsupported for retrieval-delay metrics | OpenAI | |
| precision | string | Yes | Time bucket precision Allowed values: year, quarter, month, week, day, hour, minute. | year | |
| created_after | string | Yes | Absolute start time: epoch seconds/milliseconds or ISO 8601 | 2024-01-01 | |
| created_before | string | Yes | Absolute end time: epoch seconds/milliseconds or ISO 8601 | 2025-01-01 | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/reddit/archive/time-series?metric=posts_count&precision=year&created_after=2024-01-01&created_before=2025-01-01" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"metric": "posts_count",
"subreddit": "OpenAI",
"precision": "year",
"created_after": "2024-01-01",
"created_before": "2025-01-01",
"points": [
{
"date": 1704067200,
"value": 24979
}
],
"source": {
"type": "arctic_shift",
"url": "https://arctic-shift.photon-reddit.com/api/time_series?after=2024-01-01&before=2025-01-01&key=r%2FOpenAI%2Fposts%2Fcount&precision=year"
}
}
}Request schema
No body schema
Response schema
#/definitions/reddit.archiveTimeSeriesResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | reddit.ArchiveTimeSeriesResponse | No | ||||
| data.created_after | string | No | 2024-01-01 | |||
| data.created_before | string | No | 2025-01-01 | |||
| data.metric | string | No | posts_count | |||
| data.points | array | No | ||||
| data.points[].date | integer | No | 1704067200 | |||
| data.points[].value | number | No | 24979 | |||
| data.precision | string | No | year | |||
| data.source | reddit.SourceDetail | No | ||||
| data.source.type | string | No | feed | Kind of Reddit source the data was read from. | ||
| data.source.url | string | No | https://www.reddit.com/r/OpenAI/ | Reddit URL the data was read from. | ||
| data.subreddit | string | No | OpenAI | |||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 429 | Too Many Requests | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/reddit/archive/time-series?metric=posts_count&precision=year&created_after=2024-01-01&created_before=2025-01-01" \
-H "x-api-key: $CRAWLORA_API_KEY"