> **For coding agents and LLMs:** This is one page from the Social Fetch docs (markdown export). The sections below mirror the orientation block in [`/llms.txt`](https://www.socialfetch.dev/llms.txt); use [`/llms.json`](https://www.socialfetch.dev/llms.json) when you need a structured operation inventory. The catalog covers documented operations with on-site reference pages. ## This page - **On-site (HTML):** [https://www.socialfetch.dev/docs/api/v1/reddit/subreddits/search/get](https://www.socialfetch.dev/docs/api/v1/reddit/subreddits/search/get) - **Markdown (.mdx) URL:** [https://www.socialfetch.dev/docs/api/v1/reddit/subreddits/search/get.mdx](https://www.socialfetch.dev/docs/api/v1/reddit/subreddits/search/get.mdx) ## API base URL and authentication - **API origin (from OpenAPI `servers`):** `https://api.socialfetch.dev` - **Authentication:** send `x-api-key: sfk_...` on `/v1/**` routes unless the operation is explicitly anonymous (check OpenAPI `security`, the [API reference hub](https://www.socialfetch.dev/docs/api.mdx), [`/llms.txt`](https://www.socialfetch.dev/llms.txt), or [`/llms.json`](https://www.socialfetch.dev/llms.json) for each route). - **OpenAPI JSON:** [https://www.socialfetch.dev/openapi.json](https://www.socialfetch.dev/openapi.json) ## Recommended docs entrypoints (this site) - [Documentation overview](https://www.socialfetch.dev/docs.mdx) — top-level orientation (markdown). - [Quickstart](https://www.socialfetch.dev/docs/quickstart.mdx) — authenticate with `x-api-key`, validate auth with `whoami`, and understand the JSON envelope. - [SDK](https://www.socialfetch.dev/docs/sdk.mdx) — official TypeScript SDK guide, including `SocialFetchClient`, `Result`, and `unwrap()`. - [SDK reference](https://www.socialfetch.dev/docs/sdk-reference.mdx) — exhaustive SDK method inventory and route mapping for agents, tooling, and power users. - [Choose the right endpoint](https://www.socialfetch.dev/docs/choose-endpoint.mdx) — task-oriented route selection for smoke tests, profiles, list endpoints, and single-item lookups. - [Capability matrix](https://www.socialfetch.dev/docs/capability-matrix.mdx) — fast comparison of identifiers, pagination, outcomes, media download, and SDK coverage. - [`/llms.json`](https://www.socialfetch.dev/llms.json) — structured machine-readable operation inventory with parameter names, pagination, outcomes, credits, and SDK mapping. - [API reference hub](https://www.socialfetch.dev/docs/api.mdx) — human-friendly index of operations with links into generated pages. - [Errors](https://www.socialfetch.dev/docs/errors.mdx) — shared error envelope and HTTP status guidance. - [Credits](https://www.socialfetch.dev/docs/credits.mdx) — metering, `402`, and planning batch jobs. - Outcome semantics such as `found`, `not_found`, and `private` are documented in [Errors](https://www.socialfetch.dev/docs/errors.mdx) and on operation pages when present in the OpenAPI contract. ## Markdown docs convention - Every docs page has a markdown twin: append **`.mdx`** to the docs pathname (for example `/docs/quickstart` → `/docs/quickstart.mdx`). - Agents that send `Accept: text/markdown` on `/docs/**` HTML URLs may receive markdown directly (same URL, `Vary: Accept`). --- # Search Reddit subreddit (https://www.socialfetch.dev/docs/api/v1/reddit/subreddits/search/get) ## Summary Search posts within a subreddit. **Tags:** `Reddit` ## HTTP - **Method:** GET - **Path:** `/v1/reddit/subreddits/search` - **Base URL:** `https://api.socialfetch.dev` ## Capability summary - **SDK mapping:** `client.reddit.searchSubreddit({ subreddit, query?, sort?, timeframe?, cursor? }) — subreddit is case-sensitive` - **Pagination:** cursor via `cursor`, next cursor: `data.page.nextCursor`, has more: `data.page.hasMore` ## Credits - **Base:** 1 credit per successful lookup. - **Maximum on success (200):** 1 credit. - **Normalization failure (502):** 1 credit charged. - **Authoritative field:** `meta.creditsCharged`. ## Authentication - **`x-api-key`**: API key (`sfk_...`) ## Parameters ### `subreddit` (query) - **Required:** yes - **Constraints:** type `string`; minLength: 1; maxLength: 256 - **Description:** Subreddit name, optional `r/` prefix, or Reddit subreddit URL. Must match Reddit's exact casing (for example `AskReddit`, not `askreddit`). Searches posts within this subreddit. ### `query` (query) - **Required:** no - **Constraints:** type `string`; minLength: 1; maxLength: 512 - **Description:** Search text to match against public subreddit posts. ### `sort` (query) - **Required:** no - **Constraints:** type `string`; enum: relevance, hot, top, new, comments - **Description:** Optional sort order for search results. Defaults to relevance when omitted. ### `timeframe` (query) - **Required:** no - **Constraints:** type `string`; enum: all, year, month, week, day, hour - **Description:** Optional time range filter for search results. Defaults to all when omitted. ### `cursor` (query) - **Required:** no - **Constraints:** type `string`; minLength: 1 - **Description:** Opaque pagination cursor returned by a previous response. ## Pagination This endpoint uses **cursor-based pagination** via the `cursor` query parameter. - Read **hasMore** from `data.page.hasMore`. - When that value is `true`, read **nextCursor** from `data.page.nextCursor` and pass it as the `cursor` query parameter on the **next** request (URL-encode when building a query string). - Omit `cursor` on the **first** request. - Stop when **hasMore** is `false` or **nextCursor** is null (end of list). ## Responses (status codes) - **200**: Search results for the requested subreddit. - **400**: Invalid query parameters - **401**: Missing or invalid API key - **402**: Insufficient credits - **500**: Unexpected or billing error - **502**: Lookup could not be completed from the response (unexpected or invalid data). - **503**: Service temporarily unavailable; safe to retry with backoff. ## Response body (200) Search results for the requested subreddit. ### Field outline - **data** (required) — type `object`. Endpoint-specific response payload. - **subreddit** (required) — type `string`. Subreddit name evaluated for this response. - **query** (required) — type `string`; nullable. Search query evaluated for this response. - **sort** (required) — type `string`; enum: relevance, hot, top, new, comments. Sort order applied for this response. - **timeframe** (required) — type `string`; enum: all, year, month, week, day, hour. Time range filter applied for this response. - **posts** (required) — type `array`. Matching posts for the search. - _items:_ - **id** (required) — type `string`; minLength: 1. Stable post identifier. - **postId** (required) — type `string`; minLength: 1. Post identifier when available. - **title** (required) — type `string`; minLength: 1. Post title. - **url** (required) — type `string`; minLength: 1. Canonical public URL for this post. - **permalink** (required) — type `string`; minLength: 1. Permalink path or URL for this post. - **nsfw** (required) — type `boolean`. Whether the post is marked as adult content. - **spoiler** (required) — type `boolean`. Whether the post is marked as a spoiler. - **crosspost** (required) — type `boolean`. Whether the post is a crosspost. - **subreddit** (required) — type `object`; nullable. Subreddit metadata when available. - **id** (required) — type `string`; nullable. Subreddit identifier when available. - **name** (required) — type `string`; nullable. Subreddit name when available. - **nsfw** (required) — type `boolean`; nullable. Whether the subreddit is marked as adult content. - **quarantined** (required) — type `boolean`; nullable. Whether the subreddit is quarantined. - **iconUrl** (required) — type `string`; nullable. Subreddit icon URL when available. - **bannerUrl** (required) — type `string`; nullable. Subreddit banner URL when available. - **description** (required) — type `string`; nullable. Subreddit description when available. - **weeklyVisitors** (required) — type `integer`; minimum: 0; nullable. Approximate weekly visitors when available. - **weeklyContributions** (required) — type `integer`; minimum: 0; nullable. Approximate weekly contributions when available. - **metrics** (required) — type `object`. Engagement metrics for this post. - **votes** (required) — type `integer`; minimum: 0; nullable. Vote count when available. - **comments** (required) — type `integer`; minimum: 0; nullable. Comment count when available. - **createdAt** (required) — type `string`; nullable. ISO-8601 publish timestamp when available. - **thumbnailUrl** (required) — type `string`; nullable. Thumbnail image URL when available. - **thumbnailBlurred** (required) — type `boolean`; nullable. Whether the thumbnail is blurred. - **position** (required) — type `integer`; minimum: 0; nullable. Position of this row in the current result page. - **relativePosition** (required) — type `integer`; minimum: 0; nullable. Relative position of this row in the current result page. - **totalResults** (required) — type `integer`; minimum: 0. Number of post rows returned in this response. - **page** (required) — type `object`. Pagination information for the current response. - **nextCursor** (required) — type `string`; nullable. Cursor to pass in the next request when another page exists. - **hasMore** (required) — type `boolean`. Whether another page of results is available. - **meta** (required) — type `object`. Metadata describing the request and billing outcome. - **requestId** (required) — type `string`; minLength: 1. Unique request identifier for tracing this API call. - **creditsCharged** (required) — type `integer`; minimum: 0. Credits charged for this request. - **version** (required) — type `string`; enum: v1. Public API version that served the response. ### Example JSON (results) ```json { "data": { "subreddit": "Fitness", "query": "push ups", "sort": "relevance", "timeframe": "all", "posts": [ { "id": "t3_3c3vkn", "postId": "t3_3c3vkn", "title": "Here's a video I made to help you do PUSH UPS properly", "url": "https://www.reddit.com/r/Fitness/comments/3c3vkn/heres_a_video_i_made_to_help_you_do_push_ups/", "permalink": "/r/Fitness/comments/3c3vkn/heres_a_video_i_made_to_help_you_do_push_ups/", "nsfw": false, "spoiler": false, "crosspost": false, "subreddit": { "id": "t5_2qhx4", "name": "Fitness", "nsfw": false, "quarantined": false, "iconUrl": null, "bannerUrl": null, "description": null, "weeklyVisitors": null, "weeklyContributions": null }, "metrics": { "votes": 9112, "comments": 684 }, "createdAt": "2015-07-04T14:53:20.000Z", "thumbnailUrl": null, "thumbnailBlurred": false, "position": 0, "relativePosition": 0 }, { "id": "t3_a4r12k", "postId": "t3_a4r12k", "title": "Review of Recent Fitness/Nutrition Studies: Protein and Push-Ups, Intermittent Fasting, Omega-3 Fatty Acids & More", "url": "https://www.reddit.com/r/Fitness/comments/a4r12k/review_of_recent_fitnessnutrition_studies_protein/", "permalink": "/r/Fitness/comments/a4r12k/review_of_recent_fitnessnutrition_studies_protein/", "nsfw": false, "spoiler": false, "crosspost": false, "subreddit": { "id": "t5_2qhx4", "name": "Fitness", "nsfw": false, "quarantined": false, "iconUrl": null, "bannerUrl": null, "description": null, "weeklyVisitors": null, "weeklyContributions": null }, "metrics": { "votes": 4797, "comments": 254 }, "createdAt": "2018-12-10T01:37:24.000Z", "thumbnailUrl": null, "thumbnailBlurred": false, "position": 1, "relativePosition": 1 }, { "id": "t3_237z1o", "postId": "t3_237z1o", "title": "Girl does push-ups for 100 days (video time lapse) (xpost r/getmotivated)", "url": "https://www.reddit.com/r/Fitness/comments/237z1o/girl_does_pushups_for_100_days_video_time_lapse/", "permalink": "/r/Fitness/comments/237z1o/girl_does_pushups_for_100_days_video_time_lapse/", "nsfw": false, "spoiler": false, "crosspost": false, "subreddit": { "id": "t5_2qhx4", "name": "Fitness", "nsfw": false, "quarantined": false, "iconUrl": null, "bannerUrl": null, "description": null, "weeklyVisitors": null, "weeklyContributions": null }, "metrics": { "votes": 2670, "comments": 832 }, "createdAt": "2014-04-16T22:43:02.000Z", "thumbnailUrl": null, "thumbnailBlurred": false, "position": 2, "relativePosition": 2 }, { "id": "t3_40dbfq", "postId": "t3_40dbfq", "title": "Is there any point doing a 100 push ups a day in sets of 25 ?", "url": "https://www.reddit.com/r/Fitness/comments/40dbfq/is_there_any_point_doing_a_100_push_ups_a_day_in/", "permalink": "/r/Fitness/comments/40dbfq/is_there_any_point_doing_a_100_push_ups_a_day_in/", "nsfw": false, "spoiler": false, "crosspost": false, "subreddit": { "id": "t5_2qhx4", "name": "Fitness", "nsfw": false, "quarantined": false, "iconUrl": null, "bannerUrl": null, "description": null, "weeklyVisitors": null, "weeklyContributions": null }, "metrics": { "votes": 1789, "comments": 903 }, "createdAt": "2016-01-10T21:30:07.000Z", "thumbnailUrl": null, "thumbnailBlurred": false, "position": 3, "relativePosition": 3 }, { "id": "t3_992kw9", "postId": "t3_992kw9", "title": "How far can push-ups and a pull-up bar take you for putting on some muscle?", "url": "https://www.reddit.com/r/Fitness/comments/992kw9/how_far_can_pushups_and_a_pullup_bar_take_you_for/", "permalink": "/r/Fitness/comments/992kw9/how_far_can_pushups_and_a_pullup_bar_take_you_for/", "nsfw": false, "spoiler": false, "crosspost": false, "subreddit": { "id": "t5_2qhx4", "name": "Fitness", "nsfw": false, "quarantined": false, "iconUrl": null, "bannerUrl": null, "description": null, "weeklyVisitors": null, "weeklyContributions": null }, "metrics": { "votes": 1587, "comments": 592 }, "createdAt": "2018-08-21T12:00:08.000Z", "thumbnailUrl": null, "thumbnailBlurred": false, "position": 4, "relativePosition": 4 }, { "id": "t3_32cksu", "postId": "t3_32cksu", "title": "How much will push-ups help my chest?", "url": "https://www.reddit.com/r/Fitness/comments/32cksu/how_much_will_pushups_help_my_chest/", "permalink": "/r/Fitness/comments/32cksu/how_much_will_pushups_help_my_chest/", "nsfw": false, "spoiler": false, "crosspost": false, "subreddit": { "id": "t5_2qhx4", "name": "Fitness", "nsfw": false, "quarantined": false, "iconUrl": null, "bannerUrl": null, "description": null, "weeklyVisitors": null, "weeklyContributions": null }, "metrics": { "votes": 2003, "comments": 528 }, "createdAt": "2015-04-12T17:25:19.000Z", "thumbnailUrl": null, "thumbnailBlurred": false, "position": 5, "relativePosition": 5 }, { "id": "t3_2z1nuu", "postId": "t3_2z1nuu", "title": "If I do 1 set of 20 push-ups, or 2 sets of 10 push-ups, do I build the same amount of muscle either way?", "url": "https://www.reddit.com/r/Fitness/comments/2z1nuu/if_i_do_1_set_of_20_pushups_or_2_sets_of_10/", "permalink": "/r/Fitness/comments/2z1nuu/if_i_do_1_set_of_20_pushups_or_2_sets_of_10/", "nsfw": false, "spoiler": false, "crosspost": false, "subreddit": { "id": "t5_2qhx4", "name": "Fitness", "nsfw": false, "quarantined": false, "iconUrl": null, "bannerUrl": null, "description": null, "weeklyVisitors": null, "weeklyContributions": null }, "metrics": { "votes": 1872, "comments": 508 }, "createdAt": "2015-03-14T19:10:55.000Z", "thumbnailUrl": null, "thumbnailBlurred": false, "position": 6, "relativePosition": 6 }, { "id": "t3_2ogqxy", "postId": "t3_2ogqxy", "title": "Where does a 17 year old who can't do more than 2 push-ups start?", "url": "https://www.reddit.com/r/Fitness/comments/2ogqxy/where_does_a_17_year_old_who_cant_do_more_than_2/", "permalink": "/r/Fitness/comments/2ogqxy/where_does_a_17_year_old_who_cant_do_more_than_2/", "nsfw": false, "spoiler": false, "crosspost": false, "subreddit": { "id": "t5_2qhx4", "name": "Fitness", "nsfw": false, "quarantined": false, "iconUrl": null, "bannerUrl": null, "description": null, "weeklyVisitors": null, "weeklyContributions": null }, "metrics": { "votes": 1426, "comments": 868 }, "createdAt": "2014-12-06T15:37:57.000Z", "thumbnailUrl": null, "thumbnailBlurred": false, "position": 7, "relativePosition": 7 }, { "id": "t3_5wvmeb", "postId": "t3_5wvmeb", "title": "Archer Push Ups are a great chest and triceps exercise, so i've made a tutorial for you. You'll learn them today!", "url": "https://www.reddit.com/r/Fitness/comments/5wvmeb/archer_push_ups_are_a_great_chest_and_triceps/", "permalink": "/r/Fitness/comments/5wvmeb/archer_push_ups_are_a_great_chest_and_triceps/", "nsfw": false, "spoiler": false, "crosspost": false, "subreddit": { "id": "t5_2qhx4", "name": "Fitness", "nsfw": false, "quarantined": false, "iconUrl": null, "bannerUrl": null, "description": null, "weeklyVisitors": null, "weeklyContributions": null }, "metrics": { "votes": 2920, "comments": 213 }, "createdAt": "2017-03-01T13:04:53.000Z", "thumbnailUrl": null, "thumbnailBlurred": false, "position": 8, "relativePosition": 8 }, { "id": "t3_6x3nml", "postId": "t3_6x3nml", "title": "Push-ups for a big chest?", "url": "https://www.reddit.com/r/Fitness/comments/6x3nml/pushups_for_a_big_chest/", "permalink": "/r/Fitness/comments/6x3nml/pushups_for_a_big_chest/", "nsfw": false, "spoiler": false, "crosspost": false, "subreddit": { "id": "t5_2qhx4", "name": "Fitness", "nsfw": false, "quarantined": false, "iconUrl": null, "bannerUrl": null, "description": null, "weeklyVisitors": null, "weeklyContributions": null }, "metrics": { "votes": 1435, "comments": 446 }, "createdAt": "2017-08-31T00:59:24.000Z", "thumbnailUrl": null, "thumbnailBlurred": false, "position": 9, "relativePosition": 9 }, { "id": "t3_9oks6z", "postId": "t3_9oks6z", "title": "What Effect does doing just 50 Situps and 50 Push-ups have?", "url": "https://www.reddit.com/r/Fitness/comments/9oks6z/what_effect_does_doing_just_50_situps_and_50/", "permalink": "/r/Fitness/comments/9oks6z/what_effect_does_doing_just_50_situps_and_50/", "nsfw": false, "spoiler": false, "crosspost": false, "subreddit": { "id": "t5_2qhx4", "name": "Fitness", "nsfw": false, "quarantined": false, "iconUrl": null, "bannerUrl": null, "description": null, "weeklyVisitors": null, "weeklyContributions": null }, "metrics": { "votes": 1055, "comments": 536 }, "createdAt": "2018-10-16T05:47:36.000Z", "thumbnailUrl": null, "thumbnailBlurred": false, "position": 10, "relativePosition": 10 }, { "id": "t3_2hiv3r", "postId": "t3_2hiv3r", "title": "100 push-ups for Jack", "url": "https://www.reddit.com/r/Fitness/comments/2hiv3r/100_pushups_for_jack/", "permalink": "/r/Fitness/comments/2hiv3r/100_pushups_for_jack/", "nsfw": false, "spoiler": false, "crosspost": false, "subreddit": { "id": "t5_2qhx4", "name": "Fitness", "nsfw": false, "quarantined": false, "iconUrl": null, "bannerUrl": null, "description": null, "weeklyVisitors": null, "weeklyContributions": null }, "metrics": { "votes": 1354, "comments": 305 }, "createdAt": "2014-09-26T12:57:46.000Z", "thumbnailUrl": null, "thumbnailBlurred": false, "position": 11, "relativePosition": 11 }, { "id": "t3_au7o4g", "postId": "t3_au7o4g", "title": "Review of Recent Fitness Studies V: Exercise Tempo, Push-Ups & Eccentrics", "url": "https://www.reddit.com/r/Fitness/comments/au7o4g/review_of_recent_fitness_studies_v_exercise_tempo/", "permalink": "/r/Fitness/comments/au7o4g/review_of_recent_fitness_studies_v_exercise_tempo/", "nsfw": false, "spoiler": false, "crosspost": false, "subreddit": { "id": "t5_2qhx4", "name": "Fitness", "nsfw": false, "quarantined": false, "iconUrl": null, "bannerUrl": null, "description": null, "weeklyVisitors": null, "weeklyContributions": null }, "metrics": { "votes": 1743, "comments": 160 }, "createdAt": "2019-02-24T12:49:50.000Z", "thumbnailUrl": null, "thumbnailBlurred": false, "position": 12, "relativePosition": 12 }, { "id": "t3_9x0r10", "postId": "t3_9x0r10", "title": "Push-ups are getting harder.", "url": "https://www.reddit.com/r/Fitness/comments/9x0r10/pushups_are_getting_harder/", "permalink": "/r/Fitness/comments/9x0r10/pushups_are_getting_harder/", "nsfw": false, "spoiler": false, "crosspost": false, "subreddit": { "id": "t5_2qhx4", "name": "Fitness", "nsfw": false, "quarantined": false, "iconUrl": null, "bannerUrl": null, "description": null, "weeklyVisitors": null, "weeklyContributions": null }, "metrics": { "votes": 1072, "comments": 157 }, "createdAt": "2018-11-14T14:53:00.000Z", "thumbnailUrl": null, "thumbnailBlurred": false, "position": 13, "relativePosition": 13 }, { "id": "t3_2wain0", "postId": "t3_2wain0", "title": "Instead of just hammering out a bunch push-ups to impress myself, I started doing them very slow and controlled, noticed my abs engaging.", "url": "https://www.reddit.com/r/Fitness/comments/2wain0/instead_of_just_hammering_out_a_bunch_pushups_to/", "permalink": "/r/Fitness/comments/2wain0/instead_of_just_hammering_out_a_bunch_pushups_to/", "nsfw": false, "spoiler": false, "crosspost": false, "subreddit": { "id": "t5_2qhx4", "name": "Fitness", "nsfw": false, "quarantined": false, "iconUrl": null, "bannerUrl": null, "description": null, "weeklyVisitors": null, "weeklyContributions": null }, "metrics": { "votes": 1084, "comments": 182 }, "createdAt": "2015-02-18T07:45:31.000Z", "thumbnailUrl": null, "thumbnailBlurred": false, "position": 14, "relativePosition": 14 }, { "id": "t3_cqskaq", "postId": "t3_cqskaq", "title": "Learning proper push-up form in /r/eruditeclub. We'd love a hand from you guys.", "url": "https://www.reddit.com/r/Fitness/comments/cqskaq/learning_proper_pushup_form_in_reruditeclub_wed/", "permalink": "/r/Fitness/comments/cqskaq/learning_proper_pushup_form_in_reruditeclub_wed/", "nsfw": false, "spoiler": false, "crosspost": false, "subreddit": { "id": "t5_2qhx4", "name": "Fitness", "nsfw": false, "quarantined": false, "iconUrl": null, "bannerUrl": null, "description": null, "weeklyVisitors": null, "weeklyContributions": null }, "metrics": { "votes": 1287, "comments": 83 }, "createdAt": "2019-08-15T16:56:22.000Z", "thumbnailUrl": null, "thumbnailBlurred": false, "position": 15, "relativePosition": 15 }, { "id": "t3_3ulh9f", "postId": "t3_3ulh9f", "title": "Remember Yaad's Awesome Handstand Push Up Video Tutorial? Well, I created a detailed outline of it, complete with weekly schedules for every stage so you know EXACTLY what you need to do each day!", "url": "https://www.reddit.com/r/Fitness/comments/3ulh9f/remember_yaads_awesome_handstand_push_up_video/", "permalink": "/r/Fitness/comments/3ulh9f/remember_yaads_awesome_handstand_push_up_video/", "nsfw": false, "spoiler": false, "crosspost": false, "subreddit": { "id": "t5_2qhx4", "name": "Fitness", "nsfw": false, "quarantined": false, "iconUrl": null, "bannerUrl": null, "description": null, "weeklyVisitors": null, "weeklyContributions": null }, "metrics": { "votes": 1598, "comments": 74 }, "createdAt": "2015-11-28T16:01:19.000Z", "thumbnailUrl": null, "thumbnailBlurred": false, "position": 16, "relativePosition": 16 }, { "id": "t3_4yphv3", "postId": "t3_4yphv3", "title": "Why do I find push ups so much harder than pull ups?", "url": "https://www.reddit.com/r/Fitness/comments/4yphv3/why_do_i_find_push_ups_so_much_harder_than_pull/", "permalink": "/r/Fitness/comments/4yphv3/why_do_i_find_push_ups_so_much_harder_than_pull/", "nsfw": false, "spoiler": false, "crosspost": false, "subreddit": { "id": "t5_2qhx4", "name": "Fitness", "nsfw": false, "quarantined": false, "iconUrl": null, "bannerUrl": null, "description": null, "weeklyVisitors": null, "weeklyContributions": null }, "metrics": { "votes": 326, "comments": 302 }, "createdAt": "2016-08-20T15:16:06.000Z", "thumbnailUrl": null, "thumbnailBlurred": false, "position": 17, "relativePosition": 17 }, { "id": "t3_3ltm0o", "postId": "t3_3ltm0o", "title": "Check out the most thorough video tutorial ever created for achieving Freestanding Handstand Push-Ups! It's chock full of progression exercises, proper form cues and the programming to help you achieve them with confidence!", "url": "https://www.reddit.com/r/Fitness/comments/3ltm0o/check_out_the_most_thorough_video_tutorial_ever/", "permalink": "/r/Fitness/comments/3ltm0o/check_out_the_most_thorough_video_tutorial_ever/", "nsfw": false, "spoiler": false, "crosspost": false, "subreddit": { "id": "t5_2qhx4", "name": "Fitness", "nsfw": false, "quarantined": false, "iconUrl": null, "bannerUrl": null, "description": null, "weeklyVisitors": null, "weeklyContributions": null }, "metrics": { "votes": 1465, "comments": 62 }, "createdAt": "2015-09-21T16:31:17.000Z", "thumbnailUrl": null, "thumbnailBlurred": false, "position": 18, "relativePosition": 18 }, { "id": "t3_471g48", "postId": "t3_471g48", "title": "I have two weeks to be able to do 47 push ups. Is it possible", "url": "https://www.reddit.com/r/Fitness/comments/471g48/i_have_two_weeks_to_be_able_to_do_47_push_ups_is/", "permalink": "/r/Fitness/comments/471g48/i_have_two_weeks_to_be_able_to_do_47_push_ups_is/", "nsfw": false, "spoiler": false, "crosspost": false, "subreddit": { "id": "t5_2qhx4", "name": "Fitness", "nsfw": false, "quarantined": false, "iconUrl": null, "bannerUrl": null, "description": null, "weeklyVisitors": null, "weeklyContributions": null }, "metrics": { "votes": 153, "comments": 225 }, "createdAt": "2016-02-22T16:00:52.000Z", "thumbnailUrl": null, "thumbnailBlurred": false, "position": 19, "relativePosition": 19 }, { "id": "t3_4pl3yc", "postId": "t3_4pl3yc", "title": "Things I Wish I Knew 8 Years Ago", "url": "https://www.reddit.com/r/Fitness/comments/4pl3yc/things_i_wish_i_knew_8_years_ago/", "permalink": "/r/Fitness/comments/4pl3yc/things_i_wish_i_knew_8_years_ago/", "nsfw": false, "spoiler": false, "crosspost": false, "subreddit": { "id": "t5_2qhx4", "name": "Fitness", "nsfw": false, "quarantined": false, "iconUrl": null, "bannerUrl": null, "description": null, "weeklyVisitors": null, "weeklyContributions": null }, "metrics": { "votes": 19488, "comments": 653 }, "createdAt": "2016-06-24T04:52:45.000Z", "thumbnailUrl": null, "thumbnailBlurred": false, "position": 20, "relativePosition": 20 }, { "id": "t3_8ogzss", "postId": "t3_8ogzss", "title": "26/M/5’10 - How Fitness Transformed me from an Obese, Narrow-Minded Gamer into a Wildly Different Person", "url": "https://www.reddit.com/r/Fitness/comments/8ogzss/26m510_how_fitness_transformed_me_from_an_obese/", "permalink": "/r/Fitness/comments/8ogzss/26m510_how_fitness_transformed_me_from_an_obese/", "nsfw": false, "spoiler": false, "crosspost": false, "subreddit": { "id": "t5_2qhx4", "name": "Fitness", "nsfw": false, "quarantined": false, "iconUrl": null, "bannerUrl": null, "description": null, "weeklyVisitors": null, "weeklyContributions": null }, "metrics": { "votes": 10030, "comments": 644 }, "createdAt": "2018-06-04T12:48:47.000Z", "thumbnailUrl": null, "thumbnailBlurred": false, "position": 21, "relativePosition": 21 }, { "id": "t3_7nrqkz", "postId": "t3_7nrqkz", "title": "Finally hit 213lbs lost, then got under 200lbs, then 244 square inches of skin was removed, 4 months of recovery. It's a year I won't ever forget.", "url": "https://www.reddit.com/r/Fitness/comments/7nrqkz/finally_hit_213lbs_lost_then_got_under_200lbs/", "permalink": "/r/Fitness/comments/7nrqkz/finally_hit_213lbs_lost_then_got_under_200lbs/", "nsfw": false, "spoiler": false, "crosspost": false, "subreddit": { "id": "t5_2qhx4", "name": "Fitness", "nsfw": false, "quarantined": false, "iconUrl": null, "bannerUrl": null, "description": null, "weeklyVisitors": null, "weeklyContributions": null }, "metrics": { "votes": 12986, "comments": 539 }, "createdAt": "2018-01-03T03:01:21.000Z", "thumbnailUrl": null, "thumbnailBlurred": false, "position": 22, "relativePosition": 22 }, { "id": "t3_2ny75f", "postId": "t3_2ny75f", "title": "This week, I turn 30. As a personal celebration, here's my two year transformation from 220-157 pounds.", "url": "https://www.reddit.com/r/Fitness/comments/2ny75f/this_week_i_turn_30_as_a_personal_celebration/", "permalink": "/r/Fitness/comments/2ny75f/this_week_i_turn_30_as_a_personal_celebration/", "nsfw": false, "spoiler": false, "crosspost": false, "subreddit": { "id": "t5_2qhx4", "name": "Fitness", "nsfw": false, "quarantined": false, "iconUrl": null, "bannerUrl": null, "description": null, "weeklyVisitors": null, "weeklyContributions": null }, "metrics": { "votes": 6871, "comments": 1119 }, "createdAt": "2014-12-01T16:12:01.000Z", "thumbnailUrl": null, "thumbnailBlurred": false, "position": 23, "relativePosition": 23 }, { "id": "t3_84rceg", "postId": "t3_84rceg", "title": "2 Year Transformation: 20 Yo College Student from Freshman Year to Junior year (pics)", "url": "https://www.reddit.com/r/Fitness/comments/84rceg/2_year_transformation_20_yo_college_student_from/", "permalink": "/r/Fitness/comments/84rceg/2_year_transformation_20_yo_college_student_from/", "nsfw": false, "spoiler": false, "crosspost": false, "subreddit": { "id": "t5_2qhx4", "name": "Fitness", "nsfw": false, "quarantined": false, "iconUrl": null, "bannerUrl": null, "description": null, "weeklyVisitors": null, "weeklyContributions": null }, "metrics": { "votes": 5927, "comments": 715 }, "createdAt": "2018-03-16T00:14:42.000Z", "thumbnailUrl": null, "thumbnailBlurred": false, "position": 24, "relativePosition": 24 } ], "totalResults": 25, "page": { "nextCursor": "t3_84rceg", "hasMore": true } }, "meta": { "requestId": "req_01example", "creditsCharged": 1, "version": "v1" } } ``` ### Example JSON (empty) ```json { "data": { "subreddit": "Fitness", "query": "zzzzzzzzzzzzzzzzzzzz_no_match_99999", "sort": "relevance", "timeframe": "all", "posts": [], "totalResults": 0, "page": { "nextCursor": null, "hasMore": false } }, "meta": { "requestId": "req_01example_empty", "creditsCharged": 1, "version": "v1" } } ``` ### Example JSON (paginated) ```json { "data": { "subreddit": "Fitness", "query": "push ups", "sort": "relevance", "timeframe": "all", "posts": [ { "id": "t3_4gc6p8", "postId": "t3_4gc6p8", "title": "30 Kinds of Push-Ups - Including Basic, Plyometric, Handstand/Vertical Pushing Based, Ring Based and Other Variations!", "url": "https://www.reddit.com/r/Fitness/comments/4gc6p8/30_kinds_of_pushups_including_basic_plyometric/", "permalink": "/r/Fitness/comments/4gc6p8/30_kinds_of_pushups_including_basic_plyometric/", "nsfw": false, "spoiler": false, "crosspost": false, "subreddit": { "id": "t5_2qhx4", "name": "Fitness", "nsfw": false, "quarantined": false, "iconUrl": null, "bannerUrl": null, "description": null, "weeklyVisitors": null, "weeklyContributions": null }, "metrics": { "votes": 742, "comments": 51 }, "createdAt": "2016-04-25T07:00:05.000Z", "thumbnailUrl": null, "thumbnailBlurred": false, "position": 0, "relativePosition": 0 }, { "id": "t3_bze0g8", "postId": "t3_bze0g8", "title": "Weight Loss Update: 438 lbs to 260 lbs. ~ 180 pounds down in 1 year naturally with diet and exercise!", "url": "https://www.reddit.com/r/Fitness/comments/bze0g8/weight_loss_update_438_lbs_to_260_lbs_180_pounds/", "permalink": "/r/Fitness/comments/bze0g8/weight_loss_update_438_lbs_to_260_lbs_180_pounds/", "nsfw": false, "spoiler": false, "crosspost": false, "subreddit": { "id": "t5_2qhx4", "name": "Fitness", "nsfw": false, "quarantined": false, "iconUrl": null, "bannerUrl": null, "description": null, "weeklyVisitors": null, "weeklyContributions": null }, "metrics": { "votes": 7836, "comments": 439 }, "createdAt": "2019-06-11T15:38:07.000Z", "thumbnailUrl": null, "thumbnailBlurred": false, "position": 1, "relativePosition": 1 }, { "id": "t3_8406h6", "postId": "t3_8406h6", "title": "Ok, so you're supposed to balance out your pushing and pulling right? Opposite Vertical Press is Pull-Ups. Opposite Bench Press/Push-Ups is Horizontal Row. Opposite Dips is...?", "url": "https://www.reddit.com/r/Fitness/comments/8406h6/ok_so_youre_supposed_to_balance_out_your_pushing/", "permalink": "/r/Fitness/comments/8406h6/ok_so_youre_supposed_to_balance_out_your_pushing/", "nsfw": false, "spoiler": false, "crosspost": false, "subreddit": { "id": "t5_2qhx4", "name": "Fitness", "nsfw": false, "quarantined": false, "iconUrl": null, "bannerUrl": null, "description": null, "weeklyVisitors": null, "weeklyContributions": null }, "metrics": { "votes": 227, "comments": 115 }, "createdAt": "2018-03-13T00:49:57.000Z", "thumbnailUrl": null, "thumbnailBlurred": false, "position": 2, "relativePosition": 2 }, { "id": "t3_abwgs5", "postId": "t3_abwgs5", "title": "Each New Year I post here for those of you taking up swimming for improvement, exercise or weight management. This year I am sharing swimming secrets of long time swimmers like myself that you never see written elsewhere and no-one explains", "url": "https://www.reddit.com/r/Fitness/comments/abwgs5/each_new_year_i_post_here_for_those_of_you_taking/", "permalink": "/r/Fitness/comments/abwgs5/each_new_year_i_post_here_for_those_of_you_taking/", "nsfw": false, "spoiler": false, "crosspost": false, "subreddit": { "id": "t5_2qhx4", "name": "Fitness", "nsfw": false, "quarantined": false, "iconUrl": null, "bannerUrl": null, "description": null, "weeklyVisitors": null, "weeklyContributions": null }, "metrics": { "votes": 6423, "comments": 496 }, "createdAt": "2019-01-02T19:06:02.000Z", "thumbnailUrl": null, "thumbnailBlurred": false, "position": 3, "relativePosition": 3 }, { "id": "t3_bmp3q0", "postId": "t3_bmp3q0", "title": "My transformation after sobering up and working out in a small gym without real equipment: 6 month update", "url": "https://www.reddit.com/r/Fitness/comments/bmp3q0/my_transformation_after_sobering_up_and_working/", "permalink": "/r/Fitness/comments/bmp3q0/my_transformation_after_sobering_up_and_working/", "nsfw": false, "spoiler": false, "crosspost": false, "subreddit": { "id": "t5_2qhx4", "name": "Fitness", "nsfw": false, "quarantined": false, "iconUrl": null, "bannerUrl": null, "description": null, "weeklyVisitors": null, "weeklyContributions": null }, "metrics": { "votes": 5915, "comments": 496 }, "createdAt": "2019-05-09T20:51:16.000Z", "thumbnailUrl": null, "thumbnailBlurred": false, "position": 4, "relativePosition": 4 }, { "id": "t3_j8uo2", "postId": "t3_j8uo2", "title": "If you weigh 165lbs and do push ups, is that the equivalent of benching around that weight?", "url": "https://www.reddit.com/r/Fitness/comments/j8uo2/if_you_weigh_165lbs_and_do_push_ups_is_that_the/", "permalink": "/r/Fitness/comments/j8uo2/if_you_weigh_165lbs_and_do_push_ups_is_that_the/", "nsfw": false, "spoiler": false, "crosspost": false, "subreddit": { "id": "t5_2qhx4", "name": "Fitness", "nsfw": false, "quarantined": false, "iconUrl": null, "bannerUrl": null, "description": null, "weeklyVisitors": null, "weeklyContributions": null }, "metrics": { "votes": 98, "comments": 231 }, "createdAt": "2011-08-04T15:02:50.000Z", "thumbnailUrl": null, "thumbnailBlurred": false, "position": 5, "relativePosition": 5 }, { "id": "t3_3394cx", "postId": "t3_3394cx", "title": "Is it okay to do sit ups and push ups everyday?", "url": "https://www.reddit.com/r/Fitness/comments/3394cx/is_it_okay_to_do_sit_ups_and_push_ups_everyday/", "permalink": "/r/Fitness/comments/3394cx/is_it_okay_to_do_sit_ups_and_push_ups_everyday/", "nsfw": false, "spoiler": false, "crosspost": false, "subreddit": { "id": "t5_2qhx4", "name": "Fitness", "nsfw": false, "quarantined": false, "iconUrl": null, "bannerUrl": null, "description": null, "weeklyVisitors": null, "weeklyContributions": null }, "metrics": { "votes": 184, "comments": 148 }, "createdAt": "2015-04-20T17:10:11.000Z", "thumbnailUrl": null, "thumbnailBlurred": false, "position": 6, "relativePosition": 6 }, { "id": "t3_92bhaj", "postId": "t3_92bhaj", "title": "We over at r/flexibility created a new full-body stretching routine. Takes 30 minutes and we've included a follow-along video, cheat sheets and pictures of each exercise. Try it out!", "url": "https://www.reddit.com/r/Fitness/comments/92bhaj/we_over_at_rflexibility_created_a_new_fullbody/", "permalink": "/r/Fitness/comments/92bhaj/we_over_at_rflexibility_created_a_new_fullbody/", "nsfw": false, "spoiler": false, "crosspost": false, "subreddit": { "id": "t5_2qhx4", "name": "Fitness", "nsfw": false, "quarantined": false, "iconUrl": null, "bannerUrl": null, "description": null, "weeklyVisitors": null, "weeklyContributions": null }, "metrics": { "votes": 14066, "comments": 325 }, "createdAt": "2018-07-27T10:49:54.000Z", "thumbnailUrl": null, "thumbnailBlurred": false, "position": 7, "relativePosition": 7 }, { "id": "t3_5gpc6l", "postId": "t3_5gpc6l", "title": "My 2 yr. transformation 24y.o male.", "url": "https://www.reddit.com/r/Fitness/comments/5gpc6l/my_2_yr_transformation_24yo_male/", "permalink": "/r/Fitness/comments/5gpc6l/my_2_yr_transformation_24yo_male/", "nsfw": false, "spoiler": false, "crosspost": false, "subreddit": { "id": "t5_2qhx4", "name": "Fitness", "nsfw": false, "quarantined": false, "iconUrl": null, "bannerUrl": null, "description": null, "weeklyVisitors": null, "weeklyContributions": null }, "metrics": { "votes": 5985, "comments": 654 }, "createdAt": "2016-12-05T23:27:23.000Z", "thumbnailUrl": null, "thumbnailBlurred": false, "position": 8, "relativePosition": 8 }, { "id": "t3_bcvvsk", "postId": "t3_bcvvsk", "title": "Exercises for hugging strength?", "url": "https://www.reddit.com/r/Fitness/comments/bcvvsk/exercises_for_hugging_strength/", "permalink": "/r/Fitness/comments/bcvvsk/exercises_for_hugging_strength/", "nsfw": false, "spoiler": false, "crosspost": false, "subreddit": { "id": "t5_2qhx4", "name": "Fitness", "nsfw": false, "quarantined": false, "iconUrl": null, "bannerUrl": null, "description": null, "weeklyVisitors": null, "weeklyContributions": null }, "metrics": { "votes": 4535, "comments": 597 }, "createdAt": "2019-04-13T22:07:51.000Z", "thumbnailUrl": null, "thumbnailBlurred": false, "position": 9, "relativePosition": 9 }, { "id": "t3_h9ewhw", "postId": "t3_h9ewhw", "title": "How to train while gaining/lose weight, why lean bulking sets you up for failure, and how I gain/lose without counting calories or macros", "url": "https://www.reddit.com/r/Fitness/comments/h9ewhw/how_to_train_while_gaininglose_weight_why_lean/", "permalink": "/r/Fitness/comments/h9ewhw/how_to_train_while_gaininglose_weight_why_lean/", "nsfw": false, "spoiler": false, "crosspost": false, "subreddit": { "id": "t5_2qhx4", "name": "Fitness", "nsfw": false, "quarantined": false, "iconUrl": null, "bannerUrl": null, "description": null, "weeklyVisitors": null, "weeklyContributions": null }, "metrics": { "votes": 3218, "comments": 709 }, "createdAt": "2020-06-15T11:58:03.000Z", "thumbnailUrl": null, "thumbnailBlurred": false, "position": 10, "relativePosition": 10 }, { "id": "t3_cwg1el", "postId": "t3_cwg1el", "title": "25/M/5'8\" 150lb to 172lb - My 4 year \"Powerbuilding\" Journey", "url": "https://www.reddit.com/r/Fitness/comments/cwg1el/25m58_150lb_to_172lb_my_4_year_powerbuilding/", "permalink": "/r/Fitness/comments/cwg1el/25m58_150lb_to_172lb_my_4_year_powerbuilding/", "nsfw": false, "spoiler": false, "crosspost": false, "subreddit": { "id": "t5_2qhx4", "name": "Fitness", "nsfw": false, "quarantined": false, "iconUrl": null, "bannerUrl": null, "description": null, "weeklyVisitors": null, "weeklyContributions": null }, "metrics": { "votes": 4710, "comments": 516 }, "createdAt": "2019-08-28T04:46:46.000Z", "thumbnailUrl": null, "thumbnailBlurred": false, "position": 11, "relativePosition": 11 }, { "id": "t3_bu8b05", "postId": "t3_bu8b05", "title": "Can I get decently fit by just doing pull-ups, push-ups, planks, and squats?", "url": "https://www.reddit.com/r/Fitness/comments/bu8b05/can_i_get_decently_fit_by_just_doing_pullups/", "permalink": "/r/Fitness/comments/bu8b05/can_i_get_decently_fit_by_just_doing_pullups/", "nsfw": false, "spoiler": false, "crosspost": false, "subreddit": { "id": "t5_2qhx4", "name": "Fitness", "nsfw": false, "quarantined": false, "iconUrl": null, "bannerUrl": null, "description": null, "weeklyVisitors": null, "weeklyContributions": null }, "metrics": { "votes": 202, "comments": 95 }, "createdAt": "2019-05-29T01:11:22.000Z", "thumbnailUrl": null, "thumbnailBlurred": false, "position": 12, "relativePosition": 12 }, { "id": "t3_3awmhc", "postId": "t3_3awmhc", "title": "(27/M/170) Transormation WoW nerd to exercise nerd", "url": "https://www.reddit.com/r/Fitness/comments/3awmhc/27m170_transormation_wow_nerd_to_exercise_nerd/", "permalink": "/r/Fitness/comments/3awmhc/27m170_transormation_wow_nerd_to_exercise_nerd/", "nsfw": false, "spoiler": false, "crosspost": false, "subreddit": { "id": "t5_2qhx4", "name": "Fitness", "nsfw": false, "quarantined": false, "iconUrl": null, "bannerUrl": null, "description": null, "weeklyVisitors": null, "weeklyContributions": null }, "metrics": { "votes": 3677, "comments": 1401 }, "createdAt": "2015-06-24T02:24:25.000Z", "thumbnailUrl": null, "thumbnailBlurred": false, "position": 13, "relativePosition": 13 }, { "id": "t3_43vm7n", "postId": "t3_43vm7n", "title": "How far can push-ups and sit-ups take you?", "url": "https://www.reddit.com/r/Fitness/comments/43vm7n/how_far_can_pushups_and_situps_take_you/", "permalink": "/r/Fitness/comments/43vm7n/how_far_can_pushups_and_situps_take_you/", "nsfw": false, "spoiler": false, "crosspost": false, "subreddit": { "id": "t5_2qhx4", "name": "Fitness", "nsfw": false, "quarantined": false, "iconUrl": null, "bannerUrl": null, "description": null, "weeklyVisitors": null, "weeklyContributions": null }, "metrics": { "votes": 182, "comments": 119 }, "createdAt": "2016-02-02T18:45:34.000Z", "thumbnailUrl": null, "thumbnailBlurred": false, "position": 14, "relativePosition": 14 }, { "id": "t3_2zh7ah", "postId": "t3_2zh7ah", "title": "Chest 101: An Anatomical Guide to Training", "url": "https://www.reddit.com/r/Fitness/comments/2zh7ah/chest_101_an_anatomical_guide_to_training/", "permalink": "/r/Fitness/comments/2zh7ah/chest_101_an_anatomical_guide_to_training/", "nsfw": false, "spoiler": false, "crosspost": false, "subreddit": { "id": "t5_2qhx4", "name": "Fitness", "nsfw": false, "quarantined": false, "iconUrl": null, "bannerUrl": null, "description": null, "weeklyVisitors": null, "weeklyContributions": null }, "metrics": { "votes": 5081, "comments": 721 }, "createdAt": "2015-03-18T15:48:19.000Z", "thumbnailUrl": null, "thumbnailBlurred": false, "position": 15, "relativePosition": 15 }, { "id": "t3_6mvakz", "postId": "t3_6mvakz", "title": "From fat to fit.", "url": "https://www.reddit.com/r/Fitness/comments/6mvakz/from_fat_to_fit/", "permalink": "/r/Fitness/comments/6mvakz/from_fat_to_fit/", "nsfw": false, "spoiler": false, "crosspost": false, "subreddit": { "id": "t5_2qhx4", "name": "Fitness", "nsfw": false, "quarantined": false, "iconUrl": null, "bannerUrl": null, "description": null, "weeklyVisitors": null, "weeklyContributions": null }, "metrics": { "votes": 5761, "comments": 446 }, "createdAt": "2017-07-12T17:01:42.000Z", "thumbnailUrl": null, "thumbnailBlurred": false, "position": 16, "relativePosition": 16 }, { "id": "t3_c0ga1d", "postId": "t3_c0ga1d", "title": "M 5'9\" 185 -> 190, 13 month transformation", "url": "https://www.reddit.com/r/Fitness/comments/c0ga1d/m_59_185_190_13_month_transformation/", "permalink": "/r/Fitness/comments/c0ga1d/m_59_185_190_13_month_transformation/", "nsfw": false, "spoiler": false, "crosspost": false, "subreddit": { "id": "t5_2qhx4", "name": "Fitness", "nsfw": false, "quarantined": false, "iconUrl": null, "bannerUrl": null, "description": null, "weeklyVisitors": null, "weeklyContributions": null }, "metrics": { "votes": 3697, "comments": 524 }, "createdAt": "2019-06-14T05:20:36.000Z", "thumbnailUrl": null, "thumbnailBlurred": false, "position": 17, "relativePosition": 17 }, { "id": "t3_1zjnc7", "postId": "t3_1zjnc7", "title": "If you want to get big, eat big. Really big.", "url": "https://www.reddit.com/r/Fitness/comments/1zjnc7/if_you_want_to_get_big_eat_big_really_big/", "permalink": "/r/Fitness/comments/1zjnc7/if_you_want_to_get_big_eat_big_really_big/", "nsfw": false, "spoiler": false, "crosspost": false, "subreddit": { "id": "t5_2qhx4", "name": "Fitness", "nsfw": false, "quarantined": false, "iconUrl": null, "bannerUrl": null, "description": null, "weeklyVisitors": null, "weeklyContributions": null }, "metrics": { "votes": 4614, "comments": 788 }, "createdAt": "2014-03-04T17:38:08.000Z", "thumbnailUrl": null, "thumbnailBlurred": false, "position": 18, "relativePosition": 18 }, { "id": "t3_3yssrf", "postId": "t3_3yssrf", "title": "My 2016 100,000 push-up challenge", "url": "https://www.reddit.com/r/Fitness/comments/3yssrf/my_2016_100000_pushup_challenge/", "permalink": "/r/Fitness/comments/3yssrf/my_2016_100000_pushup_challenge/", "nsfw": false, "spoiler": false, "crosspost": false, "subreddit": { "id": "t5_2qhx4", "name": "Fitness", "nsfw": false, "quarantined": false, "iconUrl": null, "bannerUrl": null, "description": null, "weeklyVisitors": null, "weeklyContributions": null }, "metrics": { "votes": 92, "comments": 152 }, "createdAt": "2015-12-30T16:40:15.000Z", "thumbnailUrl": null, "thumbnailBlurred": false, "position": 19, "relativePosition": 19 }, { "id": "t3_yaw8qa", "postId": "t3_yaw8qa", "title": "No Rest Days", "url": "https://www.reddit.com/r/Fitness/comments/yaw8qa/no_rest_days/", "permalink": "/r/Fitness/comments/yaw8qa/no_rest_days/", "nsfw": false, "spoiler": false, "crosspost": false, "subreddit": { "id": "t5_2qhx4", "name": "Fitness", "nsfw": false, "quarantined": false, "iconUrl": null, "bannerUrl": null, "description": null, "weeklyVisitors": null, "weeklyContributions": null }, "metrics": { "votes": 1590, "comments": 667 }, "createdAt": "2022-10-22T19:23:48.000Z", "thumbnailUrl": null, "thumbnailBlurred": false, "position": 20, "relativePosition": 20 }, { "id": "t3_2r1dzs", "postId": "t3_2r1dzs", "title": "[Progress] My 4 Month Transformation, 19 year old male. Hope this inspires you!", "url": "https://www.reddit.com/r/Fitness/comments/2r1dzs/progress_my_4_month_transformation_19_year_old/", "permalink": "/r/Fitness/comments/2r1dzs/progress_my_4_month_transformation_19_year_old/", "nsfw": false, "spoiler": false, "crosspost": false, "subreddit": { "id": "t5_2qhx4", "name": "Fitness", "nsfw": false, "quarantined": false, "iconUrl": null, "bannerUrl": null, "description": null, "weeklyVisitors": null, "weeklyContributions": null }, "metrics": { "votes": 4455, "comments": 696 }, "createdAt": "2015-01-01T21:40:19.000Z", "thumbnailUrl": null, "thumbnailBlurred": false, "position": 21, "relativePosition": 21 }, { "id": "t3_9r59vs", "postId": "t3_9r59vs", "title": "Advice on my push-up form?", "url": "https://www.reddit.com/r/Fitness/comments/9r59vs/advice_on_my_pushup_form/", "permalink": "/r/Fitness/comments/9r59vs/advice_on_my_pushup_form/", "nsfw": false, "spoiler": false, "crosspost": false, "subreddit": { "id": "t5_2qhx4", "name": "Fitness", "nsfw": false, "quarantined": false, "iconUrl": null, "bannerUrl": null, "description": null, "weeklyVisitors": null, "weeklyContributions": null }, "metrics": { "votes": 170, "comments": 92 }, "createdAt": "2018-10-25T00:17:53.000Z", "thumbnailUrl": null, "thumbnailBlurred": false, "position": 22, "relativePosition": 22 }, { "id": "t3_sb7tbh", "postId": "t3_sb7tbh", "title": "1,000 Workouts Without a Rest Day", "url": "https://www.reddit.com/r/Fitness/comments/sb7tbh/1000_workouts_without_a_rest_day/", "permalink": "/r/Fitness/comments/sb7tbh/1000_workouts_without_a_rest_day/", "nsfw": false, "spoiler": false, "crosspost": false, "subreddit": { "id": "t5_2qhx4", "name": "Fitness", "nsfw": false, "quarantined": false, "iconUrl": null, "bannerUrl": null, "description": null, "weeklyVisitors": null, "weeklyContributions": null }, "metrics": { "votes": 2699, "comments": 378 }, "createdAt": "2022-01-23T23:58:53.000Z", "thumbnailUrl": null, "thumbnailBlurred": false, "position": 23, "relativePosition": 23 }, { "id": "t3_8jrdsm", "postId": "t3_8jrdsm", "title": "Fellow introverts, how did you convince yourself to go to a gym?", "url": "https://www.reddit.com/r/Fitness/comments/8jrdsm/fellow_introverts_how_did_you_convince_yourself/", "permalink": "/r/Fitness/comments/8jrdsm/fellow_introverts_how_did_you_convince_yourself/", "nsfw": false, "spoiler": false, "crosspost": false, "subreddit": { "id": "t5_2qhx4", "name": "Fitness", "nsfw": false, "quarantined": false, "iconUrl": null, "bannerUrl": null, "description": null, "weeklyVisitors": null, "weeklyContributions": null }, "metrics": { "votes": 2411, "comments": 1368 }, "createdAt": "2018-05-16T02:17:33.000Z", "thumbnailUrl": null, "thumbnailBlurred": false, "position": 24, "relativePosition": 24 } ], "totalResults": 25, "page": { "nextCursor": "t3_8jrdsm", "hasMore": true } }, "meta": { "requestId": "req_01example_paginated", "creditsCharged": 1, "version": "v1" } } ``` ### Example JSON (withThumbnails) ```json { "data": { "subreddit": "pics", "query": "cat", "sort": "relevance", "timeframe": "all", "posts": [ { "id": "t3_1rbyffx", "postId": "t3_1rbyffx", "title": "[OC] One of Ernest Hemingway’s polydactyl cats ignoring museum rules to curl up in his bed", "url": "https://www.reddit.com/gallery/1rbyffx", "permalink": "/r/pics/comments/1rbyffx/oc_one_of_ernest_hemingways_polydactyl_cats/", "nsfw": false, "spoiler": false, "crosspost": false, "subreddit": { "id": "t5_2qh0u", "name": "pics", "nsfw": false, "quarantined": false, "iconUrl": null, "bannerUrl": null, "description": null, "weeklyVisitors": null, "weeklyContributions": null }, "metrics": { "votes": 36578, "comments": 608 }, "createdAt": "2026-02-22T21:35:47.000Z", "thumbnailUrl": "https://preview.redd.it/wcyvtm1l74lg1.jpg?width=140&height=140&crop=1:1,smart&auto=webp&s=b65fbb68f6c3e3a9c5f9275ce760372fc3981b9e", "thumbnailBlurred": false, "position": 0, "relativePosition": 0 }, { "id": "t3_1rgdxt7", "postId": "t3_1rgdxt7", "title": "[OC] My cat does this anytime I leave any bag and then walks around like this", "url": "https://i.redd.it/n1zolprpt2mg1.jpeg", "permalink": "/r/pics/comments/1rgdxt7/oc_my_cat_does_this_anytime_i_leave_any_bag_and/", "nsfw": false, "spoiler": false, "crosspost": false, "subreddit": { "id": "t5_2qh0u", "name": "pics", "nsfw": false, "quarantined": false, "iconUrl": null, "bannerUrl": null, "description": null, "weeklyVisitors": null, "weeklyContributions": null }, "metrics": { "votes": 15142, "comments": 418 }, "createdAt": "2026-02-27T18:00:15.000Z", "thumbnailUrl": "https://preview.redd.it/n1zolprpt2mg1.jpeg?width=140&height=105&auto=webp&s=02645d98ae1c34fa72f43b9b0f1aa739e811c8f0", "thumbnailBlurred": false, "position": 1, "relativePosition": 1 }, { "id": "t3_1tc2m16", "postId": "t3_1tc2m16", "title": "My client asked me to paint her elderly cat in the place he would dream about(OC)", "url": "https://i.redd.it/752pxhek8x0h1.jpeg", "permalink": "/r/pics/comments/1tc2m16/my_client_asked_me_to_paint_her_elderly_cat_in/", "nsfw": false, "spoiler": false, "crosspost": false, "subreddit": { "id": "t5_2qh0u", "name": "pics", "nsfw": false, "quarantined": false, "iconUrl": null, "bannerUrl": null, "description": null, "weeklyVisitors": null, "weeklyContributions": null }, "metrics": { "votes": 9731, "comments": 182 }, "createdAt": "2026-05-13T15:14:50.000Z", "thumbnailUrl": "https://preview.redd.it/752pxhek8x0h1.jpeg?width=140&height=140&crop=1:1,smart&auto=webp&s=8249d8dc21a0212a8a23fe6e6fcaa5ab5286340b", "thumbnailBlurred": false, "position": 2, "relativePosition": 2 }, { "id": "t3_1sjb6ws", "postId": "t3_1sjb6ws", "title": "[OC] This cat I photographed while drunk in Amsterdam 12 years ago.", "url": "https://i.redd.it/ypwbevxxnqug1.jpeg", "permalink": "/r/pics/comments/1sjb6ws/oc_this_cat_i_photographed_while_drunk_in/", "nsfw": false, "spoiler": false, "crosspost": false, "subreddit": { "id": "t5_2qh0u", "name": "pics", "nsfw": false, "quarantined": false, "iconUrl": null, "bannerUrl": null, "description": null, "weeklyVisitors": null, "weeklyContributions": null }, "metrics": { "votes": 27757, "comments": 166 }, "createdAt": "2026-04-12T10:44:10.000Z", "thumbnailUrl": "https://preview.redd.it/ypwbevxxnqug1.jpeg?width=140&height=140&crop=1:1,smart&auto=webp&s=1b78735379cd5b26f84d6d3b574e27e83e7f2f27", "thumbnailBlurred": false, "position": 3, "relativePosition": 3 }, { "id": "t3_1ftrryk", "postId": "t3_1ftrryk", "title": "I’ve felt a void in my life ever since my cat passed so I adopted the saddest cat at the shelter", "url": "https://i.redd.it/614j61bv46sd1.jpeg", "permalink": "/r/pics/comments/1ftrryk/ive_felt_a_void_in_my_life_ever_since_my_cat/", "nsfw": false, "spoiler": false, "crosspost": false, "subreddit": { "id": "t5_2qh0u", "name": "pics", "nsfw": false, "quarantined": false, "iconUrl": null, "bannerUrl": null, "description": null, "weeklyVisitors": null, "weeklyContributions": null }, "metrics": { "votes": 170266, "comments": 1566 }, "createdAt": "2024-10-01T16:06:35.000Z", "thumbnailUrl": "https://a.thumbs.redditmedia.com/bTKxb7Gxss4Az0tZUssHKW2apiacFGZUQW1A9kjGAj0.jpg", "thumbnailBlurred": false, "position": 4, "relativePosition": 4 }, { "id": "t3_1jkpf5a", "postId": "t3_1jkpf5a", "title": "[oc] I tried a touchless ink pad on my cat and dog", "url": "https://i.redd.it/n0foq3sn74re1.jpeg", "permalink": "/r/pics/comments/1jkpf5a/oc_i_tried_a_touchless_ink_pad_on_my_cat_and_dog/", "nsfw": false, "spoiler": false, "crosspost": false, "subreddit": { "id": "t5_2qh0u", "name": "pics", "nsfw": false, "quarantined": false, "iconUrl": null, "bannerUrl": null, "description": null, "weeklyVisitors": null, "weeklyContributions": null }, "metrics": { "votes": 53405, "comments": 639 }, "createdAt": "2025-03-26T23:03:12.000Z", "thumbnailUrl": "https://b.thumbs.redditmedia.com/Z1CS046yCzD5ixwGInwa1dZN_92_afiqbrJsVmmuTtw.jpg", "thumbnailBlurred": false, "position": 5, "relativePosition": 5 }, { "id": "t3_1fvaru1", "postId": "t3_1fvaru1", "title": "Went looking for my cat after I hadn’t seen her for w couple hours and this is how I found her.", "url": "https://i.imgur.com/2m9KSmQ.jpeg", "permalink": "/r/pics/comments/1fvaru1/went_looking_for_my_cat_after_i_hadnt_seen_her/", "nsfw": false, "spoiler": false, "crosspost": false, "subreddit": { "id": "t5_2qh0u", "name": "pics", "nsfw": false, "quarantined": false, "iconUrl": null, "bannerUrl": null, "description": null, "weeklyVisitors": null, "weeklyContributions": null }, "metrics": { "votes": 68336, "comments": 912 }, "createdAt": "2024-10-03T15:41:06.000Z", "thumbnailUrl": "https://a.thumbs.redditmedia.com/UdF1ayDsN4s1MdiWUra2VXdL0biA5t3QtByDwB-_JH4.jpg", "thumbnailBlurred": false, "position": 6, "relativePosition": 6 }, { "id": "t3_1brxga4", "postId": "t3_1brxga4", "title": "My cat just turned me in to a Bond villain", "url": "https://i.redd.it/fkh2iuihhkrc1.jpeg", "permalink": "/r/pics/comments/1brxga4/my_cat_just_turned_me_in_to_a_bond_villain/", "nsfw": false, "spoiler": false, "crosspost": false, "subreddit": { "id": "t5_2qh0u", "name": "pics", "nsfw": false, "quarantined": false, "iconUrl": null, "bannerUrl": null, "description": null, "weeklyVisitors": null, "weeklyContributions": null }, "metrics": { "votes": 79729, "comments": 2744 }, "createdAt": "2024-03-31T00:49:09.000Z", "thumbnailUrl": "https://b.thumbs.redditmedia.com/j2Ey9kwuxlc2sM2-yuXt6cNNvpn09Cogw_sqlQjIaaw.jpg", "thumbnailBlurred": false, "position": 7, "relativePosition": 7 }, { "id": "t3_1fe08nd", "postId": "t3_1fe08nd", "title": "Illegal alien eating a cat on TV.", "url": "https://i.redd.it/7hymp83yi3od1.jpeg", "permalink": "/r/pics/comments/1fe08nd/illegal_alien_eating_a_cat_on_tv/", "nsfw": false, "spoiler": false, "crosspost": false, "subreddit": { "id": "t5_2qh0u", "name": "pics", "nsfw": false, "quarantined": false, "iconUrl": null, "bannerUrl": null, "description": null, "weeklyVisitors": null, "weeklyContributions": null }, "metrics": { "votes": 85127, "comments": 899 }, "createdAt": "2024-09-11T03:03:26.000Z", "thumbnailUrl": "https://b.thumbs.redditmedia.com/cOUwicocfGg9uIDA6QkVPZ5U7IU1IWbjFXg5oAxkPdQ.jpg", "thumbnailBlurred": false, "position": 8, "relativePosition": 8 }, { "id": "t3_1h3jjky", "postId": "t3_1h3jjky", "title": "A family with their cat wearing masks during the Spanish Flu", "url": "https://i.redd.it/3661etuy534e1.png", "permalink": "/r/pics/comments/1h3jjky/a_family_with_their_cat_wearing_masks_during_the/", "nsfw": false, "spoiler": false, "crosspost": false, "subreddit": { "id": "t5_2qh0u", "name": "pics", "nsfw": false, "quarantined": false, "iconUrl": null, "bannerUrl": null, "description": null, "weeklyVisitors": null, "weeklyContributions": null }, "metrics": { "votes": 79500, "comments": 565 }, "createdAt": "2024-11-30T18:56:51.000Z", "thumbnailUrl": "https://b.thumbs.redditmedia.com/3JWf7zVo6AgLNhjH0HKuAYeLtOn-YEeS34aJpdPWvrU.jpg", "thumbnailBlurred": false, "position": 9, "relativePosition": 9 }, { "id": "t3_17xjfyu", "postId": "t3_17xjfyu", "title": "Left the office & found the neighbors cat in my car.", "url": "https://i.redd.it/6mmhc93lux0c1.jpg", "permalink": "/r/pics/comments/17xjfyu/left_the_office_found_the_neighbors_cat_in_my_car/", "nsfw": false, "spoiler": false, "crosspost": false, "subreddit": { "id": "t5_2qh0u", "name": "pics", "nsfw": false, "quarantined": false, "iconUrl": null, "bannerUrl": null, "description": null, "weeklyVisitors": null, "weeklyContributions": null }, "metrics": { "votes": 220606, "comments": 3452 }, "createdAt": "2023-11-17T16:54:07.000Z", "thumbnailUrl": "https://a.thumbs.redditmedia.com/Ld3S_-S6BzLvZEYj7Luv-zHzelmpNwPpfa04vUwSIf4.jpg", "thumbnailBlurred": false, "position": 10, "relativePosition": 10 }, { "id": "t3_1ewrrgi", "postId": "t3_1ewrrgi", "title": "Kursk Offensive: Ukraine's Childless Cat Ladies Brigade is in Sudzha.", "url": "https://i.redd.it/5uaj3o3dmsjd1.jpeg", "permalink": "/r/pics/comments/1ewrrgi/kursk_offensive_ukraines_childless_cat_ladies/", "nsfw": false, "spoiler": false, "crosspost": false, "subreddit": { "id": "t5_2qh0u", "name": "pics", "nsfw": false, "quarantined": false, "iconUrl": null, "bannerUrl": null, "description": null, "weeklyVisitors": null, "weeklyContributions": null }, "metrics": { "votes": 19937, "comments": 991 }, "createdAt": "2024-08-20T10:06:28.000Z", "thumbnailUrl": "https://b.thumbs.redditmedia.com/buJGhxJF6SJdWnET3qR6TF3YraQCDs1S2xWwYa0wtUI.jpg", "thumbnailBlurred": false, "position": 11, "relativePosition": 11 }, { "id": "t3_1cxrevq", "postId": "t3_1cxrevq", "title": "Someone left these two in a cat carrier two feet from the river", "url": "https://www.reddit.com/gallery/1cxrevq", "permalink": "/r/pics/comments/1cxrevq/someone_left_these_two_in_a_cat_carrier_two_feet/", "nsfw": false, "spoiler": false, "crosspost": false, "subreddit": { "id": "t5_2qh0u", "name": "pics", "nsfw": false, "quarantined": false, "iconUrl": null, "bannerUrl": null, "description": null, "weeklyVisitors": null, "weeklyContributions": null }, "metrics": { "votes": 46250, "comments": 786 }, "createdAt": "2024-05-22T04:07:03.000Z", "thumbnailUrl": "https://b.thumbs.redditmedia.com/xBp9PYvMQGnsoXsqpZJQ1KycrTB99k4-3cGnuMaepEU.jpg", "thumbnailBlurred": false, "position": 12, "relativePosition": 12 }, { "id": "t3_1ffsxyv", "postId": "t3_1ffsxyv", "title": "Before anyone starts, this is my cat, not my dinner.", "url": "https://i.redd.it/z88sc0jjgkod1.jpeg", "permalink": "/r/pics/comments/1ffsxyv/before_anyone_starts_this_is_my_cat_not_my_dinner/", "nsfw": false, "spoiler": false, "crosspost": false, "subreddit": { "id": "t5_2qh0u", "name": "pics", "nsfw": false, "quarantined": false, "iconUrl": null, "bannerUrl": null, "description": null, "weeklyVisitors": null, "weeklyContributions": null }, "metrics": { "votes": 31607, "comments": 486 }, "createdAt": "2024-09-13T12:00:15.000Z", "thumbnailUrl": "https://a.thumbs.redditmedia.com/1wY6IWnWfLFshg9D6ECGt0hKYS3GjzSQ_8iSyQ_3dl4.jpg", "thumbnailBlurred": false, "position": 13, "relativePosition": 13 }, { "id": "t3_10jhnbc", "postId": "t3_10jhnbc", "title": "Doja Cat covered in 30,000 Swarovski crystals applied by hand at the Schiaparelli Haute Couture show", "url": "https://i.redd.it/vx484gv9avda1.jpg", "permalink": "/r/pics/comments/10jhnbc/doja_cat_covered_in_30000_swarovski_crystals/", "nsfw": false, "spoiler": false, "crosspost": false, "subreddit": { "id": "t5_2qh0u", "name": "pics", "nsfw": false, "quarantined": false, "iconUrl": null, "bannerUrl": null, "description": null, "weeklyVisitors": null, "weeklyContributions": null }, "metrics": { "votes": 44528, "comments": 5809 }, "createdAt": "2023-01-23T17:12:46.000Z", "thumbnailUrl": "https://b.thumbs.redditmedia.com/0GQE935ryaDh9SMKhK0Ipb1WjhPYszdg-gaX78wEKqk.jpg", "thumbnailBlurred": false, "position": 14, "relativePosition": 14 }, { "id": "t3_1czexys", "postId": "t3_1czexys", "title": "James Corden on his phone on the set of Cats", "url": "https://i.redd.it/igubj0qdrb2d1.jpeg", "permalink": "/r/pics/comments/1czexys/james_corden_on_his_phone_on_the_set_of_cats/", "nsfw": false, "spoiler": false, "crosspost": false, "subreddit": { "id": "t5_2qh0u", "name": "pics", "nsfw": false, "quarantined": false, "iconUrl": null, "bannerUrl": null, "description": null, "weeklyVisitors": null, "weeklyContributions": null }, "metrics": { "votes": 22912, "comments": 686 }, "createdAt": "2024-05-24T07:14:01.000Z", "thumbnailUrl": "https://b.thumbs.redditmedia.com/cWB9qmH1d3HsI3uYavypwYstybGwcHHH-GIA0zw63jQ.jpg", "thumbnailBlurred": false, "position": 15, "relativePosition": 15 }, { "id": "t3_1hnezxx", "postId": "t3_1hnezxx", "title": "Black bengal cats exist", "url": "https://i.redd.it/k38xh8n99e9e1.jpeg", "permalink": "/r/pics/comments/1hnezxx/black_bengal_cats_exist/", "nsfw": false, "spoiler": false, "crosspost": false, "subreddit": { "id": "t5_2qh0u", "name": "pics", "nsfw": false, "quarantined": false, "iconUrl": null, "bannerUrl": null, "description": null, "weeklyVisitors": null, "weeklyContributions": null }, "metrics": { "votes": 62118, "comments": 276 }, "createdAt": "2024-12-27T13:35:37.000Z", "thumbnailUrl": "https://b.thumbs.redditmedia.com/w9In5V194wO2Dept3R6E3QH0w7E4nkW4hsZlKICcuPo.jpg", "thumbnailBlurred": false, "position": 16, "relativePosition": 16 }, { "id": "t3_1703des", "postId": "t3_1703des", "title": "Father-in-law got this pic of a cat saved from a fire in SE Michigan", "url": "https://i.redd.it/927gd8pf1asb1.jpg", "permalink": "/r/pics/comments/1703des/fatherinlaw_got_this_pic_of_a_cat_saved_from_a/", "nsfw": false, "spoiler": false, "crosspost": false, "subreddit": { "id": "t5_2qh0u", "name": "pics", "nsfw": false, "quarantined": false, "iconUrl": null, "bannerUrl": null, "description": null, "weeklyVisitors": null, "weeklyContributions": null }, "metrics": { "votes": 34789, "comments": 922 }, "createdAt": "2023-10-05T00:16:39.000Z", "thumbnailUrl": "https://b.thumbs.redditmedia.com/HIPWl98uKjk3KkVl8tpU5hbsCmCaV1HbW98_9qc_cOQ.jpg", "thumbnailBlurred": false, "position": 17, "relativePosition": 17 }, { "id": "t3_1jmpjfa", "postId": "t3_1jmpjfa", "title": "Freddie Mercury eating soup in bed with his cats, 1987", "url": "https://i.redd.it/k4336lrhjnre1.png", "permalink": "/r/pics/comments/1jmpjfa/freddie_mercury_eating_soup_in_bed_with_his_cats/", "nsfw": false, "spoiler": false, "crosspost": false, "subreddit": { "id": "t5_2qh0u", "name": "pics", "nsfw": false, "quarantined": false, "iconUrl": null, "bannerUrl": null, "description": null, "weeklyVisitors": null, "weeklyContributions": null }, "metrics": { "votes": 40149, "comments": 214 }, "createdAt": "2025-03-29T16:03:23.000Z", "thumbnailUrl": "https://a.thumbs.redditmedia.com/Fup8_Q03o3kvyAC8XaxHmLfOnTeycg5JiIkWtCn6QV8.jpg", "thumbnailBlurred": false, "position": 18, "relativePosition": 18 }, { "id": "t3_1bl1wvp", "postId": "t3_1bl1wvp", "title": "Ukrainian refugee with her dog and two cats crosses the border into Poland", "url": "https://i.redd.it/4g8g15cnlwpc1.png", "permalink": "/r/pics/comments/1bl1wvp/ukrainian_refugee_with_her_dog_and_two_cats/", "nsfw": false, "spoiler": false, "crosspost": false, "subreddit": { "id": "t5_2qh0u", "name": "pics", "nsfw": false, "quarantined": false, "iconUrl": null, "bannerUrl": null, "description": null, "weeklyVisitors": null, "weeklyContributions": null }, "metrics": { "votes": 35585, "comments": 493 }, "createdAt": "2024-03-22T15:25:44.000Z", "thumbnailUrl": "https://b.thumbs.redditmedia.com/yPB8vNwBxLFGiiPRnZK9PNtkxQ2xe3vNIkAgxWpaxUk.jpg", "thumbnailBlurred": false, "position": 19, "relativePosition": 19 }, { "id": "t3_13c881c", "postId": "t3_13c881c", "title": "Hanging out with some of the coolest cats out there.", "url": "https://i.redd.it/ecyqaqznwoya1.jpg", "permalink": "/r/pics/comments/13c881c/hanging_out_with_some_of_the_coolest_cats_out/", "nsfw": false, "spoiler": false, "crosspost": false, "subreddit": { "id": "t5_2qh0u", "name": "pics", "nsfw": false, "quarantined": false, "iconUrl": null, "bannerUrl": null, "description": null, "weeklyVisitors": null, "weeklyContributions": null }, "metrics": { "votes": 40514, "comments": 939 }, "createdAt": "2023-05-08T23:13:26.000Z", "thumbnailUrl": "https://a.thumbs.redditmedia.com/YJC8FD_s4HKpoZrLeYCnVR3lFcZTN5BJbwyYU7NHHU0.jpg", "thumbnailBlurred": false, "position": 20, "relativePosition": 20 }, { "id": "t3_1czrg77", "postId": "t3_1czrg77", "title": "Mask mandates during WWI in 1918 were taken so seriously that they even made tiny cat masks.", "url": "https://i.redd.it/v6kpe3dx1f2d1.jpeg", "permalink": "/r/pics/comments/1czrg77/mask_mandates_during_wwi_in_1918_were_taken_so/", "nsfw": false, "spoiler": false, "crosspost": false, "subreddit": { "id": "t5_2qh0u", "name": "pics", "nsfw": false, "quarantined": false, "iconUrl": null, "bannerUrl": null, "description": null, "weeklyVisitors": null, "weeklyContributions": null }, "metrics": { "votes": 15377, "comments": 411 }, "createdAt": "2024-05-24T18:18:28.000Z", "thumbnailUrl": "https://b.thumbs.redditmedia.com/XgQIhRg71dALQlCwAJJLJD7pOGq1M66VtrQFwMTPE4Q.jpg", "thumbnailBlurred": false, "position": 21, "relativePosition": 21 }, { "id": "t3_1pgf8u9", "postId": "t3_1pgf8u9", "title": "My cat had been acting skittish and I couldn't work out why.", "url": "https://i.redd.it/4p4g8k27er5g1.jpeg", "permalink": "/r/pics/comments/1pgf8u9/my_cat_had_been_acting_skittish_and_i_couldnt/", "nsfw": false, "spoiler": false, "crosspost": false, "subreddit": { "id": "t5_2qh0u", "name": "pics", "nsfw": false, "quarantined": false, "iconUrl": null, "bannerUrl": null, "description": null, "weeklyVisitors": null, "weeklyContributions": null }, "metrics": { "votes": 4080, "comments": 168 }, "createdAt": "2025-12-07T10:28:03.000Z", "thumbnailUrl": "https://b.thumbs.redditmedia.com/rMGWcx1S0TGMtQmj1tbWk6t6yIYVrB_CBWLmNeRdKkc.jpg", "thumbnailBlurred": false, "position": 22, "relativePosition": 22 }, { "id": "t3_195xt9j", "postId": "t3_195xt9j", "title": "Same picture of my cat, 1 year apart", "url": "https://i.redd.it/k36qnsnis9cc1.png", "permalink": "/r/pics/comments/195xt9j/same_picture_of_my_cat_1_year_apart/", "nsfw": false, "spoiler": false, "crosspost": false, "subreddit": { "id": "t5_2qh0u", "name": "pics", "nsfw": false, "quarantined": false, "iconUrl": null, "bannerUrl": null, "description": null, "weeklyVisitors": null, "weeklyContributions": null }, "metrics": { "votes": 31237, "comments": 428 }, "createdAt": "2024-01-13T20:49:53.000Z", "thumbnailUrl": "https://a.thumbs.redditmedia.com/GgBzXFf_3oTAj7zL1mfD_j6HRgK3AXepiAF0BprbZo0.jpg", "thumbnailBlurred": false, "position": 23, "relativePosition": 23 }, { "id": "t3_zjz15r", "postId": "t3_zjz15r", "title": "I created an oil painting series about a cat exploring the cosmos", "url": "https://www.reddit.com/gallery/zjz15r", "permalink": "/r/pics/comments/zjz15r/i_created_an_oil_painting_series_about_a_cat/", "nsfw": false, "spoiler": false, "crosspost": false, "subreddit": { "id": "t5_2qh0u", "name": "pics", "nsfw": false, "quarantined": false, "iconUrl": null, "bannerUrl": null, "description": null, "weeklyVisitors": null, "weeklyContributions": null }, "metrics": { "votes": 51271, "comments": 774 }, "createdAt": "2022-12-12T13:24:41.000Z", "thumbnailUrl": "https://b.thumbs.redditmedia.com/RIQObwHHTC1gPgpAIwDrIm5Fk2fM-wh0B_XjKzkeOSE.jpg", "thumbnailBlurred": false, "position": 24, "relativePosition": 24 } ], "totalResults": 25, "page": { "nextCursor": "t3_zjz15r", "hasMore": true } }, "meta": { "requestId": "req_01example_thumbnails", "creditsCharged": 1, "version": "v1" } } ``` ### Machine-readable error codes When an error JSON body is returned, it may include one of these `error.code` values (derived from the OpenAPI schemas for this operation; additional codes may exist at runtime): - `bad_request` ## Error handling & retries Interpret HTTP status codes using the descriptions below. Do not assume a JSON body unless the OpenAPI schema defines one for that status. - **400**: Invalid query parameters **Retry:** Fix the request; retrying the same invalid payload will not help. - **401**: Missing or invalid API key **Retry:** Fix the API key first; retrying without changes will not help. - **402**: Insufficient credits **Retry:** Do not retry without resolving billing/credits (retrying the same request will not help). - **500**: Unexpected or billing error - **502**: Lookup could not be completed from the response (unexpected or invalid data). **Retry:** May be transient; a few retries with backoff are reasonable. - **503**: Service temporarily unavailable; safe to retry with backoff. **Retry:** Usually safe to retry with exponential backoff and jitter. ### Suggested client defaults - Send the API key using the `x-api-key` header on every request. - On `503` (and sometimes `502`), retry with backoff; cap retries and surface a clear error to the user. - On `402`, surface an actionable billing message rather than blind retries. ## Examples ### TypeScript SDK ```typescript import { SocialFetchClient } from "@socialfetch/sdk"; const client = new SocialFetchClient({ apiKey: process.env.SOCIALFETCH_API_KEY!, }); const result = await client.reddit.searchSubreddit({ subreddit: "Fitness", }); if (!result.ok) { console.error(result.error); } else { console.log(result.value.data); } ``` ### Node.js ```javascript const response = await fetch( "https://api.socialfetch.dev/v1/reddit/subreddits/search?subreddit=Fitness", { headers: { "x-api-key": "YOUR_API_KEY", } } ); const data = await response.json(); console.log(data); ``` ### cURL ```bash curl "https://api.socialfetch.dev/v1/reddit/subreddits/search?subreddit=Fitness" \ -H "x-api-key: YOUR_API_KEY" ``` ### Python ```python import requests response = requests.get( "https://api.socialfetch.dev/v1/reddit/subreddits/search?subreddit=Fitness", headers={"x-api-key": "YOUR_API_KEY"}, ) data = response.json() print(data) ``` ### Example: next page (pagination) After a successful response, if pagination is not finished, request the next page using `cursor` (URL-encode when composing the query string): ```javascript const previous = await response.json(); const nextCursor = previous?.data?.page?.nextCursor; const hasMore = previous?.data?.page?.hasMore; if (!hasMore || nextCursor == null) { // no more pages } else { const nextUrl = new URL("https://api.socialfetch.dev/v1/reddit/subreddits/search"); nextUrl.searchParams.set("cursor", nextCursor); // optionally preserve sort: nextUrl.searchParams.set("sortBy", "latest"); const nextResponse = await fetch(nextUrl.toString(), { headers: { "x-api-key": "YOUR_API_KEY" }, }); const nextData = await nextResponse.json(); } ```