REDDIT API

Subreddit Search

Retrieve subreddit search from Reddit with a single API request.

GET/api/data/v1/reddit/subreddit/search
1credit base cost

Request parameters

Up to 1 credit

Subreddit 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.

Try in the console

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,
  "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==",
  "credits_charged": 1,
  "credits_remaining": 1000,
  "request_id": "00000000-0000-4000-8000-000000000000"
}
Illustrative response with example values adapted for FetchGoblin. Run a request to retrieve current platform 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"
    },
    "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"
    },
    "credits_charged": {
      "type": "integer",
      "minimum": 0,
      "description": "FetchGoblin credits charged for this request."
    },
    "credits_remaining": {
      "type": "integer",
      "description": "Your FetchGoblin credit balance after this request."
    },
    "request_id": {
      "type": "string",
      "format": "uuid",
      "description": "FetchGoblin request identifier."
    }
  }
}