Endpoint Playground
Searches public Reddit content and returns public post entries. A `503` with a `Retry-After` header means Reddit is temporarily throttling the request; wait that many seconds and retry. If source.type is redlib, public fields and credit weights are preserved.
14 Oct 2026: 20 posts; 11 fields had a value in every checked item.
Sample value profiles: created_utc: 2025-05-04 to 2026-10-04; url: reddit.com; permalink: reddit.com.
curl 'https://api.crawlora.net/api/v1/reddit/search?q=gpt&sort=relevance&time=hour' \
-H "x-api-key: $CRAWLORA_API_KEY"| Parameter | Type | Required | Prefilled value | Description |
|---|---|---|---|---|
| q | string | Yes | gpt | Search keywords |
| subreddit | string | No | Restrict search to a subreddit name, without r/ | |
| sort | string | No | relevance | Sort: relevance, hot, new, top, or comments |
| time | string | No | hour | Time window for top/comments sorts: hour, day, week, month, year, or all |
| limit | integer | No | Maximum posts, defaults to 25 and clamps to 100 | |
| after | string | No | Reddit pagination token |
{
"code": 200,
"msg": "OK",
"data": {
"query": "gpt",
"subreddit": "OpenAI",
"sort": "relevance",
"posts": [
{
"id": "1abcxyz",
"name": "t3_1abcxyz",
"subreddit": "OpenAI",
"title": "OpenAI discussion thread",
"url": "https://www.reddit.com/r/OpenAI/comments/1abcxyz/openai_discussion_thread/",
"author": {
"name": "sample_user",
"profile_url": "https://www.reddit.com/user/sample_user/"
},
"created": "2024-04-19T00:00:00Z",
"selftext": "Discussion body",
"source_feed_url": "https://www.reddit.com/r/OpenAI/search?q=gpt&restrict_sr=on&sort=relevance"
}
],
"pagination": {
"limit": 25,
"after": "t3_1abcxyz"
},
"source": {
"type": "feed",
"url": "https://www.reddit.com/r/OpenAI/search?q=gpt&restrict_sr=on&sort=relevance"
}
}
}The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.