REDDIT API
Subreddit Search
Retrieve subreddit search from Reddit with a single API request.
GET
/api/data/v1/reddit/subreddit/search1credit base cost
Request parameters
Up to 1 creditSubreddit name (e.g. 'Fitness', not 'r/Fitness' or a full URL)
Search query to find matching content
Sort order. For posts/media: relevance, hot, top, new, comments. For comments: relevance, top, new
Timeframe to filter results
Cursor to get more results. Get 'cursor' from previous response.
Live requests use your prepaid balance. Cached responses cost zero where supported.
curl --request GET \
--url 'https://fetchgoblin.com/api/data/v1/reddit/subreddit/search' \
--header 'x-api-key: YOUR_FETCHGOBLIN_API_KEY'Response
Example{
"success": true,
"credits_charged": 1,
"posts": [
{
"id": "t3_8gmjrb",
"post_id": "t3_8gmjrb",
"title": "Is doing 50-100 pushups a day doing anything?",
"url": "https://www.reddit.com/r/Fitness/comments/8gmjrb/is_doing_50100_pushups_a_day_doing_anything/",
"permalink": "/r/Fitness/comments/8gmjrb/is_doing_50100_pushups_a_day_doing_anything/",
"nsfw": false,
"spoiler": false,
"is_crosspost": false,
"subreddit": {
"id": "t5_2qhx4",
"name": "Fitness",
"nsfw": false,
"quarantined": false,
"icon": "https://b.thumbs.redditmedia.com/Ted4KOMuRbaCYlDS55cTqjpVVZ2ENHKtYFbBFjI1i2o.png",
"banner": null,
"description": "A place for the pursuit of physical fitness goals.\n\nPlease see the r/Fitness Wiki and FAQ at https://thefitness.wiki for help with common questions.",
"weekly_visitors": 898726,
"weekly_contributions": 1827
},
"votes": 1414,
"num_comments": 582,
"created_at": "2018-05-03T01:09:17.620000+0000",
"created_at_iso": "2018-05-03T01:09:17.620Z",
"thumbnail": null,
"thumbnail_blurred": false,
"position": 0,
"relative_position": 0
}
],
"comments": [
{
"id": "t1_nxf7p27",
"post_id": "t3_1q2p898",
"parent_comment_id": null,
"is_reply_to_comment": false,
"author": "Philser23",
"author_avatar": null,
"author_nsfw": false,
"body": "On the 30th my girlfriend out of the blue decided her new year's resolution would be to start going to the gym. I was so excited since none of my partners ever shared the fitness hobby with me.",
"body_html": "<p>On the 30th my girlfriend out of the blue decided her new year's resolution would be to start going to the gym...</p>",
"images": [],
"votes": 123,
"url": "https://www.reddit.com/r/Fitness/comments/1q2p898/gym_story_saturday/nxf7p27/",
"permalink": "/r/Fitness/comments/1q2p898/gym_story_saturday/nxf7p27/",
"created_at": "2026-01-03T11:26:02.434000+0000",
"created_at_iso": "2026-01-03T11:26:02.434Z",
"post": {
"id": "t3_1q2p898",
"title": "Gym Story Saturday",
"url": "https://www.reddit.com/r/Fitness/comments/1q2p898/gym_story_saturday/",
"permalink": "/r/Fitness/comments/1q2p898/gym_story_saturday/",
"nsfw": false,
"spoiler": false,
"votes": 67,
"num_comments": 80,
"created_at": "2026-01-03T08:15:49.709000+0000",
"created_at_iso": "2026-01-03T08:15:49.709Z"
},
"subreddit": {
"id": "t5_2qhx4",
"name": "Fitness",
"nsfw": false,
"quarantined": false,
"icon": "https://b.thumbs.redditmedia.com/Ted4KOMuRbaCYlDS55cTqjpVVZ2ENHKtYFbBFjI1i2o.png"
},
"position": 0
}
],
"media": [
{
"id": "t3_geo4x",
"title": "Bodyweight training for really strong people. See on you're own what I mean with strong. (Not me)",
"url": "https://www.reddit.com/r/Fitness/comments/geo4x/bodyweight_training_for_really_strong_people_see/",
"permalink": "/r/Fitness/comments/geo4x/bodyweight_training_for_really_strong_people_see/",
"media_type": "image",
"video": null,
"image": {
"src": "https://external-preview.redd.it/X6lz5yGIzqVA5LcI9w-FsQJJHhXoCugDhsXgWW3I404.jpg?format=pjpg&auto=webp&s=46814b0a707a532e39e6c20851ddc1fefb0a111f",
"width": 480,
"height": 360,
"resolutions": [
{
"url": "https://external-preview.redd.it/X6lz5yGIzqVA5LcI9w-FsQJJHhXoCugDhsXgWW3I404.jpg?width=320&crop=smart&format=pjpg&auto=webp&s=144ac4171a1862e5d91d8dd90d44271e22a8273d",
"width": 320
}
]
},
"gallery_count": null,
"aspect_ratio": 1.3333333333333333,
"nsfw": false,
"spoiler": false,
"is_blurred": false,
"subreddit": {
"id": "t5_2qhx4",
"name": "Fitness",
"nsfw": false,
"quarantined": false
},
"position": 0,
"safe_search": "UNAVAILABLE"
}
],
"cursor": "eyJjYW5kaWRhdGVzX3JldHVybmVkIjoie1wic2VjdGlvbl8xX3BpcGVsaW5lXzBfZ2xvYmFsX21vZGlmaWVyc1wiOlwiM1wiLFwic2VjdGlvbl8xX3BpcGVsaW5lXzFfbG9jYWxfbW9kaWZpZXJzXCI6XCIzXCIsXCJzZWN0aW9uXzJfcGlwZWxpbmVfNl9zY29wZV9zd2l0Y2hlclwiOlwiMFwiLFwic2VjdGlvbl8yX3BpcGVsaW5lXzdfcG9zdF9zZWFyY2hcIjpcIjdcIn0ifQ=="
}Example data from the API specification. Run a request to retrieve current data.
Response shape
This schema describes the documented data shape. Some platform fields may be absent or null. The response also includes your FetchGoblin request ID and current credit balance.
View JSON Schema +
{
"type": "object",
"properties": {
"success": {
"type": "boolean"
},
"credits_remaining": {
"type": "integer"
},
"credits_charged": {
"type": "integer"
},
"posts": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"post_id": {
"type": "string"
},
"title": {
"type": "string"
},
"url": {
"type": "string"
},
"permalink": {
"type": "string"
},
"nsfw": {
"type": "boolean"
},
"spoiler": {
"type": "boolean"
},
"is_crosspost": {
"type": "boolean"
},
"subreddit": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"nsfw": {
"type": "boolean"
},
"quarantined": {
"type": "boolean"
},
"icon": {
"type": "string"
},
"banner": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"description": {
"type": "string"
},
"weekly_visitors": {
"type": "integer"
},
"weekly_contributions": {
"type": "integer"
}
}
},
"votes": {
"type": "integer"
},
"num_comments": {
"type": "integer"
},
"created_at": {
"type": "string"
},
"created_at_iso": {
"type": "string"
},
"thumbnail": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"thumbnail_blurred": {
"type": "boolean"
},
"position": {
"type": "integer"
},
"relative_position": {
"type": "integer"
}
}
}
},
"comments": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"post_id": {
"type": "string"
},
"parent_comment_id": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"is_reply_to_comment": {
"type": "boolean"
},
"author": {
"type": "string"
},
"author_avatar": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"author_nsfw": {
"type": "boolean"
},
"body": {
"type": "string"
},
"body_html": {
"type": "string"
},
"images": {
"type": "array"
},
"votes": {
"type": "integer"
},
"url": {
"type": "string"
},
"permalink": {
"type": "string"
},
"created_at": {
"type": "string"
},
"created_at_iso": {
"type": "string"
},
"post": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"title": {
"type": "string"
},
"url": {
"type": "string"
},
"permalink": {
"type": "string"
},
"nsfw": {
"type": "boolean"
},
"spoiler": {
"type": "boolean"
},
"votes": {
"type": "integer"
},
"num_comments": {
"type": "integer"
},
"created_at": {
"type": "string"
},
"created_at_iso": {
"type": "string"
}
}
},
"subreddit": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"nsfw": {
"type": "boolean"
},
"quarantined": {
"type": "boolean"
},
"icon": {
"type": "string"
}
}
},
"position": {
"type": "integer"
}
}
}
},
"media": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"title": {
"type": "string"
},
"url": {
"type": "string"
},
"permalink": {
"type": "string"
},
"media_type": {
"type": "string"
},
"video": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"image": {
"type": "object",
"properties": {
"src": {
"type": "string"
},
"width": {
"type": "integer"
},
"height": {
"type": "integer"
},
"resolutions": {
"type": "array",
"items": {
"type": "object",
"properties": {
"url": {
"type": "string"
},
"width": {
"type": "integer"
}
}
}
}
}
},
"gallery_count": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"aspect_ratio": {
"type": "number"
},
"nsfw": {
"type": "boolean"
},
"spoiler": {
"type": "boolean"
},
"is_blurred": {
"type": "boolean"
},
"subreddit": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"nsfw": {
"type": "boolean"
},
"quarantined": {
"type": "boolean"
}
}
},
"position": {
"type": "integer"
},
"safe_search": {
"type": "string"
}
}
}
},
"cursor": {
"type": "string"
}
}
}