# Reddit Engagement API. Send a handle or profile link. Upvotes per post, posting cadence and top posts. We handle the proxies, blocks and platform changes. [Get API key](https://socialtap.dev/signup/?next=%2Fplayground%2F%3Fendpoint%3Dreddit.engagement) ## Reddit Engagement API at a glance Returns a public Reddit user's profile and latest posts, with upvotes and comments per post, posting cadence and top posts computed over them. It also has the comment-to-upvote ratio, the mix of text, link, image and video posts, the bottom post, and how each post compares with the user's typical post. Engagement rates are null, because Reddit shows no follower or view counts. One request, from a username or profile link. GET `/v1/reddit/engagement` [Read the API reference](https://socialtap.dev/docs/reference/reddit/engagement/index.md) - **1 credit** per request, $0.75–$1.97 per 1,000 requests - **12 typed fields** null when unknown - **`handle`** is all it needs, e.g. `GallowBoob` - **100 credits** free when you sign up, no card, so you can build before you spend ## Send one request. Get 12 fields back. Copy the request in your language, or hand it to your agent. Sign up for an API key and your first 100 credits are free. `$ npm install socialtap` `handle = GallowBoob` [Open in playground](https://socialtap.dev/playground/?endpoint=reddit.engagement) cURL: ```shell curl 'https://socialtap.dev/v1/reddit/engagement?handle=GallowBoob' \ -H "x-api-key: $SOCIALTAP_API_KEY" ``` TypeScript SDK: ```typescript import { SocialTap } from "socialtap"; const client = new SocialTap(); // apiKey defaults to process.env.SOCIALTAP_API_KEY const res = await client.reddit.engagement.get({ handle: "GallowBoob" }); console.log(res.data); console.log(res.credits.charged, res.meta.request_id); ``` Node.js (fetch): ```javascript const params = new URLSearchParams({ handle: "GallowBoob", }); const res = await fetch(`https://socialtap.dev/v1/reddit/engagement?${params}`, { headers: { "x-api-key": process.env.SOCIALTAP_API_KEY ?? "" }, }); const body = await res.json(); if (!res.ok) throw new Error(`${body.error.code}: ${body.error.message}`); const { data, meta } = body; console.log(data, meta.credits_charged); ``` Python (requests): ```python import os import requests res = requests.get( "https://socialtap.dev/v1/reddit/engagement", params={"handle": "GallowBoob"}, headers={"x-api-key": os.environ["SOCIALTAP_API_KEY"]}, ) body = res.json() if not res.ok: raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}") data, meta = body["data"], body["meta"] print(data, meta["credits_charged"]) ``` Go (net/http): ```go package main import ( "encoding/json" "fmt" "log" "net/http" "net/url" "os" ) func main() { q := url.Values{} q.Set("handle", "GallowBoob") req, err := http.NewRequest("GET", "https://socialtap.dev/v1/reddit/engagement?"+q.Encode(), nil) if err != nil { log.Fatal(err) } req.Header.Set("x-api-key", os.Getenv("SOCIALTAP_API_KEY")) res, err := http.DefaultClient.Do(req) if err != nil { log.Fatal(err) } defer res.Body.Close() var body struct { Data json.RawMessage `json:"data"` Meta map[string]any `json:"meta"` Error *struct { Code string `json:"code"` Message string `json:"message"` } `json:"error"` } if err := json.NewDecoder(res.Body).Decode(&body); err != nil { log.Fatal(err) } if body.Error != nil { log.Fatalf("%s: %s", body.Error.Code, body.Error.Message) } fmt.Println(string(body.Data), body.Meta["credits_charged"]) } ``` 200 OK: ```json { "data": { "approximate_fields": [], "bottom_post_id": "t3_1m2sh2k", "id": "t2_iqsg6", "metrics": { "comment_to_like_ratio": 0.044405, "comments_per_post": 99.88, "counted_post_count": 24, "engagement_rate": null, "engagement_rate_stddev": null, "formats": [ { "counted_post_count": 15, "engagement_rate": null, "interactions_per_post": 3098.47, "type": "image", "views_per_post": null }, { "counted_post_count": 8, "engagement_rate": null, "interactions_per_post": 1212.63, "type": "video", "views_per_post": null }, { "counted_post_count": 1, "engagement_rate": null, "interactions_per_post": 200, "type": "carousel", "views_per_post": null } ], "interactions_per_post": 2349.08, "likes_per_post": 2249.21, "median_engagement_rate": null, "median_views_per_post": null, "posts_per_week": 0.11, "quotes_per_post": null, "rated_post_count": 24, "reposts_per_post": null, "sampled_post_count": 25, "saves_per_post": null, "shares_per_post": null, "view_engagement_rate": null, "views_per_post": null }, "newest_post_at": "2026-10-09T16:14:29Z", "oldest_post_at": "2022-12-09T02:55:52Z", "platform": "reddit", "platform_specific": {}, "posts": [ { "engagement_rate": null, "engagement_vs_median": 33.33, "is_counted": false, "post": { "approximate_fields": [], "author": { "avatar_url": "https://styles.redditmedia.com/t5_3kl0d/styles/profileIcon_c4zmya3oel6h1.png?width=48&height=48&frame=1&auto=webp&crop=48%3A48%2Csmart&s=d4c3218b2ab8994e02e897782f5c6522d0c0d47e", "display_name": null, "id": "t2_iqsg6", "is_verified": null, "url": "https://www.reddit.com/user/GallowBoob/", "username": "GallowBoob" }, "coauthors": [], "duration_ms": null, "hashtags": [], "id": "t3_fgghrs", "is_nsfw": false, "is_pinned": true, "is_sponsored": false, "language": null, "media": [ { "alt_text": null, "duration_ms": null, "expires_at": null, "height": null, "thumbnail_url": null, "type": "image", "url": "https://i.redd.it/41i4qishgvl41.jpg", "width": null } ], "mentions": [], "metrics": { "comment_count": 66, "like_count": 7949, "quote_count": null, "repost_count": null, "save_count": null, "share_count": null, "view_count": null }, "platform": "reddit", "platform_specific": { "reddit": { "award_count": null, "crosspost_of": null, "domain": "i.redd.it", "flair": null, "is_archived": false, "is_locked": true, "is_spoiler": false, "link_url": null, "score": 7949, "subreddit": { "id": "t5_3kl0d", "name": "u_GallowBoob", "url": "https://www.reddit.com/r/u_GallowBoob/" }, "upvote_ratio": 0.9687462863933453 } }, "platform_type": "image", "published_at": "2020-03-10T16:27:45Z", "text": null, "thumbnail_url": "https://i.redd.it/41i4qishgvl41.jpg", "title": "‪Everything in balance.‬ ‪Except karma ⬆️‬⬆️⬆️", "type": "image", "unknown_fields": [], "url": "https://www.reddit.com/user/GallowBoob/comments/fgghrs/everything_in_balance_except_karma/" }, "view_engagement_rate": null, "views_vs_median": null }, { "engagement_rate": null, "engagement_vs_median": 1.07, "is_counted": true, "post": { "approximate_fields": [], "author": { "avatar_url": "https://styles.redditmedia.com/t5_3kl0d/styles/profileIcon_c4zmya3oel6h1.png?width=64&height=64&frame=1&auto=webp&crop=64%3A64%2Csmart&s=622fbbf4e9da2b328d998f838980358e9848839b", "display_name": null, "id": "t2_iqsg6", "is_verified": null, "url": "https://www.reddit.com/user/GallowBoob/", "username": "GallowBoob" }, "coauthors": [], "duration_ms": null, "hashtags": [], "id": "t3_1x1pjzw", "is_nsfw": false, "is_pinned": false, "is_sponsored": false, "language": null, "media": [ { "alt_text": null, "duration_ms": null, "expires_at": null, "height": null, "thumbnail_url": null, "type": "image", "url": "https://i.redd.it/tbq8zdb1vguh1.jpeg", "width": null } ], "mentions": [], "metrics": { "comment_count": 15, "like_count": 242, "quote_count": null, "repost_count": null, "save_count": null, "share_count": null, "view_count": null }, "platform": "reddit", "platform_specific": { "reddit": { "award_count": 0, "crosspost_of": null, "domain": "i.redd.it", "flair": null, "is_archived": false, "is_locked": false, "is_spoiler": false, "link_url": null, "score": 242, "subreddit": { "id": "t5_2qh1o", "name": "aww", "url": "https://www.reddit.com/r/aww/" }, "upvote_ratio": 0.9801587301587301 } }, "platform_type": "image", "published_at": "2026-10-09T16:14:29Z", "text": null, "thumbnail_url": "https://i.redd.it/tbq8zdb1vguh1.jpeg", "title": "She’s 2 years old! 🎉", "type": "image", "unknown_fields": [], "url": "https://www.reddit.com/r/aww/comments/1x1pjzw/shes_2_years_old/" }, "view_engagement_rate": null, "views_vs_median": null }, { "engagement_rate": null, "engagement_vs_median": 0.33, "is_counted": true, "post": { "approximate_fields": [], "author": { "avatar_url": "https://styles.redditmedia.com/t5_3kl0d/styles/profileIcon_c4zmya3oel6h1.png?width=64&height=64&frame=1&auto=webp&crop=64%3A64%2Csmart&s=622fbbf4e9da2b328d998f838980358e9848839b", "display_name": null, "id": "t2_iqsg6", "is_verified": null, "url": "https://www.reddit.com/user/GallowBoob/", "username": "GallowBoob" }, "coauthors": [], "duration_ms": 40000, "hashtags": [], "id": "t3_1uz79k3", "is_nsfw": false, "is_pinned": false, "is_sponsored": false, "language": null, "media": [ { "alt_text": null, "duration_ms": 40000, "expires_at": "2026-11-03T01:00:00Z", "height": 1920, "thumbnail_url": "https://external-preview.redd.it/shes-enjoying-the-summer-breeze-v0-NG4wNjBpcnV4dGRoMdQqmHkdc8VnKxXpXRKk_w_FM2SWI08gkBzSPUTOCnDs.png?width=640&crop=smart&format=pjpg&auto=webp&s=852591d0e96218504c059b335546bb9a5719cfdd", "type": "video", "url": "https://packaged-media.redd.it/8u59jcvuxtdh1/pb/m2-res_1920p.mp4?m=DASHPlaylist.mpd&var=sgpssan&v=1&e=1793667600&s=4618cb794fbb1602a0442b562fb1609f2b60c096", "width": 1080 } ], "mentions": [], "metrics": { "comment_count": 10, "like_count": 69, "quote_count": null, "repost_count": null, "save_count": null, "share_count": null, "view_count": null }, "platform": "reddit", "platform_specific": { "reddit": { "award_count": 0, "crosspost_of": null, "domain": "v.redd.it", "flair": null, "is_archived": false, "is_locked": false, "is_spoiler": false, "link_url": null, "score": 69, "subreddit": { "id": "t5_2qh1o", "name": "aww", "url": "https://www.reddit.com/r/aww/" }, "upvote_ratio": 0.9722222222222222 } }, "platform_type": "video", "published_at": "2026-07-17T18:03:16Z", "text": null, "thumbnail_url": "https://external-preview.redd.it/shes-enjoying-the-summer-breeze-v0-NG4wNjBpcnV4dGRoMdQqmHkdc8VnKxXpXRKk_w_FM2SWI08gkBzSPUTOCnDs.png?width=640&crop=smart&format=pjpg&auto=webp&s=852591d0e96218504c059b335546bb9a5719cfdd", "title": "She’s enjoying the summer breeze [OC]", "type": "video", "unknown_fields": [], "url": "https://www.reddit.com/r/aww/comments/1uz79k3/shes_enjoying_the_summer_breeze_oc/" }, "view_engagement_rate": null, "views_vs_median": null } ], "profile": { "approximate_fields": [ "created_at", "platform_specific.reddit.moderated_subreddits" ], "avatar_url": "https://styles.redditmedia.com/t5_3kl0d/styles/profileIcon_c4zmya3oel6h1.png", "banner_url": "https://styles.redditmedia.com/t5_3kl0d/styles/profileBanner_74ugoeyr5nif1.png", "bio": "The internet was a mistake 🌍 Always remember the human.", "category": null, "country_code": null, "created_at": "2014-10-07T00:00:00Z", "display_name": "Rob", "external_links": [ { "title": "thegallowboob", "url": "https://twitter.com/thegallowboob" } ], "id": "t2_iqsg6", "is_private": false, "is_verified": false, "location": null, "metrics": { "follower_count": null, "following_count": null, "post_count": null, "total_like_count": null, "total_view_count": null }, "platform": "reddit", "platform_specific": { "reddit": { "comment_karma": 1110838, "contribution_count": 27374, "is_admin": false, "is_nsfw": false, "is_premium": true, "karma": 36838255, "moderated_subreddits": [ { "id": "t5_2x93b", "name": "oddlysatisfying", "url": "https://www.reddit.com/r/oddlysatisfying/" }, { "id": "t5_m0bnr", "name": "nextfuckinglevel", "url": "https://www.reddit.com/r/nextfuckinglevel/" }, { "id": "t5_37xo2", "name": "RoastMe", "url": "https://www.reddit.com/r/RoastMe/" } ], "post_karma": 35727417, "trophies": [ { "description": null, "granted_at": null, "image_url": "https://i.redd.it/cms/1a51152004126674_trophy_image_for_12_year_club.png", "name": "12-Year Club", "url": null }, { "description": null, "granted_at": "2023-01-01T00:00:00Z", "image_url": "https://i.redd.it/cms/0ff4a7db3bca21f7_trophy_image_for_wellrounded.png", "name": "Well-Rounded", "url": null }, { "description": null, "granted_at": "2023-01-01T00:00:00Z", "image_url": "https://i.redd.it/cms/0ff4a7db3bca21f7_trophy_image_for_wellrounded.png", "name": "Well-Rounded", "url": null } ] } }, "type": "unknown", "unknown_fields": [], "url": "https://www.reddit.com/user/GallowBoob/", "username": "GallowBoob" }, "top_post_id": "t3_16y770f", "unknown_fields": [], "url": "https://www.reddit.com/user/GallowBoob/" }, "meta": { "request_id": "req_3f9c2a7d1e8b4c6a9f0e2d4b6a8c0e1f", "platform": "reddit", "source": "page", "is_cached": false, "credits_charged": 1, "latency_ms": 1677, "fetched_at": "2026-10-25T12:00:00Z", "input": { "kind": "profile", "id": "t2_iqsg6", "url": "https://www.reddit.com/user/GallowBoob/" }, "credits_remaining": 9999, "client_request_id": null, "warnings": [] } } ``` Long arrays and strings are shortened here. Real responses are complete. ## One schema on 6 platforms. The [response reference](https://socialtap.dev/docs/reference/reddit/engagement/index.md#response) lists every field, its type and when it is `null`. [See the full schema](https://socialtap.dev/resources/engagement/index.md). - ### Null means unknown A field Reddit doesn't show is null, never zero or an empty string, so a real zero always means zero. - ### What it accepts Reddit username, with or without u/ (spez, u/spez, /u/spez), or a profile link on any reddit.com host (www, old, new, np, m: reddit.com/user/spez, reddit.com/u/spez, with a tab such as /submitted or /comments), or the user's profile subreddit (reddit.com/r/u_spez). - ### Write one parser Reddit, TikTok, Instagram and 3 more platforms answer in these fields, so the code that reads one reads them all. - **`platform`string**: Platform ID (tiktok, instagram, …). - **`id`string**: Platform-native account ID (equals profile.id). - **`url`string**: Canonical profile URL (equals profile.url). - **`profile`object**: The account, as its profile endpoint returns it; its metrics.follower_count divides every engagement_rate. - **`posts`object\[\]**: The sampled recent posts in the profile's order, each with its own figures. \[\] when none; \[\] and in unknown_fields when unreadable (a private account, a failed posts request). - **`metrics`object**: Figures over the counted posts (by the account, not pinned); each null when no counted post has its inputs. - **`oldest_post_at`string**: Publish time of the oldest counted post, RFC 3339 UTC: where the sample starts. - **`newest_post_at`string**: Publish time of the newest counted post, RFC 3339 UTC: when the account last posted. Live data from 33 platforms. [TikTok](https://socialtap.dev/apis/tiktok/index.md) · [Instagram](https://socialtap.dev/apis/instagram/index.md) · [Facebook](https://socialtap.dev/apis/facebook/index.md) · [YouTube](https://socialtap.dev/apis/youtube/index.md) · [Reddit](https://socialtap.dev/apis/reddit/index.md) · [Threads](https://socialtap.dev/apis/threads/index.md) · [Spotify](https://socialtap.dev/apis/spotify/index.md) · [Amazon](https://socialtap.dev/apis/amazon/index.md) · [Apple Music](https://socialtap.dev/apis/applemusic/index.md) · [Pinterest](https://socialtap.dev/apis/pinterest/index.md) · [Rumble](https://socialtap.dev/apis/rumble/index.md) · [X](https://socialtap.dev/apis/x/index.md) · [Bluesky](https://socialtap.dev/apis/bluesky/index.md) · [Twitch](https://socialtap.dev/apis/twitch/index.md) · [LinkedIn](https://socialtap.dev/apis/linkedin/index.md) · [Telegram](https://socialtap.dev/apis/telegram/index.md) · [TikTok Shop](https://socialtap.dev/apis/tiktokshop/index.md) · [Kwai](https://socialtap.dev/apis/kwai/index.md) · [Snapchat](https://socialtap.dev/apis/snapchat/index.md) · [SoundCloud](https://socialtap.dev/apis/soundcloud/index.md) · [Truth Social](https://socialtap.dev/apis/truthsocial/index.md) · [Kick](https://socialtap.dev/apis/kick/index.md) · [Komi](https://socialtap.dev/apis/komi/index.md) · [Lnk.Bio](https://socialtap.dev/apis/linkbio/index.md) · [Linkme](https://socialtap.dev/apis/linkme/index.md) · [Linktree](https://socialtap.dev/apis/linktree/index.md) · [Pillar](https://socialtap.dev/apis/pillar/index.md) · [TikTok Ad Library](https://socialtap.dev/apis/tiktok-ad-library/index.md) · [Facebook Ad Library](https://socialtap.dev/apis/facebook-ad-library/index.md) · [Facebook Events](https://socialtap.dev/apis/facebook-events/index.md) · [Facebook Marketplace](https://socialtap.dev/apis/facebook-marketplace/index.md) · [Google Ads Transparency Center](https://socialtap.dev/apis/google-ads-transparency/index.md) · [LinkedIn Ad Library](https://socialtap.dev/apis/linkedin-ad-library/index.md) ## What teams build with the Reddit Engagement API. - ### Audit a creator before a sponsorship - ### Compare how a shortlist of accounts perform - ### Track a user's posting cadence - ### Spot a user's outlier posts ## Good to know before you build. - Reddit doesn't show follower or view counts, so engagement rates are always null. Upvotes, comments, posting cadence and top posts are still computed. - The figures cover the user's latest posts, the first page of the Reddit User Posts API newest first. The profile and each post are exactly what the Reddit Profile API and the Reddit User Posts API return. Posts pinned to the profile are flagged (is_pinned) and left out of the figures. - Upvotes are the post's score (upvotes minus downvotes, the number beside the arrows; metrics.like_count). A post whose score is below zero has like_count null and is left out of the upvote averages. - A user who hides their posts returns the profile with posts unknown (posts \[\] in unknown_fields, every figure null) and a partial_data warning. A user with no posts returns the profile with posts \[\]. A suspended account returns private_or_unavailable, and a deleted account or a name nobody has returns not_found. ## 1 credit per request. Failed requests are free. Buy credits once and spend them on any endpoint, on any platform. [Plans and packs](https://socialtap.dev/pricing/index.md) · [How this endpoint is priced](https://socialtap.dev/docs/reference/reddit/engagement/index.md#pricing) · [How credits work](https://socialtap.dev/docs/credits/index.md) | Source | Price per successful request | Per 1,000 requests | | --- | --- | --- | | Public page `page` | 1 credit | $0.75–$1.97 | - Cache hits are free. - Credits from packs and top-ups never expire. - A monthly plan's credits are spent first, and what is left of them ends at each renewal. - Prices exclude tax: sales tax is added at checkout where it applies. - Outside the US, plans and packs are sold to businesses: checkout asks for your VAT, GST or other business tax ID. ## Questions about the Reddit Engagement API. More in the [API reference](https://socialtap.dev/docs/reference/reddit/engagement/index.md). **Why are the engagement rates null on Reddit?** Because an engagement rate divides a post's interactions by the account's followers or the post's views, and Reddit shows neither logged out. Rather than guess, those fields are null. The upvote and comment averages, the comment-to-upvote ratio, each post against the user's median, posting cadence and the top and bottom post are all computed. **How much does the Reddit Engagement API cost?** A request costs 1 credit. SocialTap credits cost $0.75–$1.97 per 1,000, depending on the plan or pack. Other platforms ## Engagement stats on 5 more platforms. - [TikTok Engagement API](https://socialtap.dev/apis/tiktok/engagement/index.md) (1 credit · `GET /v1/tiktok/engagement`) - [Instagram Engagement API](https://socialtap.dev/apis/instagram/engagement/index.md) (1 credit · `GET /v1/instagram/engagement`) - [Facebook Engagement API](https://socialtap.dev/apis/facebook/engagement/index.md) (1 credit · `GET /v1/facebook/engagement`) - [YouTube Engagement API](https://socialtap.dev/apis/youtube/engagement/index.md) (1 credit · `GET /v1/youtube/engagement`) - [Rumble Engagement API](https://socialtap.dev/apis/rumble/engagement/index.md) (1 credit · `GET /v1/rumble/engagement`) More Reddit ## Reddit API. 13 endpoints, one key. - [Reddit Post API](https://socialtap.dev/apis/reddit/post/index.md) (1 credit · `GET /v1/reddit/post`) - [Reddit Search API](https://socialtap.dev/apis/reddit/search_posts/index.md) (1 credit / page · `GET /v1/reddit/search_posts`) - [Reddit User Posts API](https://socialtap.dev/apis/reddit/posts/index.md) (1 credit / page · `GET /v1/reddit/posts`) - [Reddit Subreddit Posts API](https://socialtap.dev/apis/reddit/subreddit_posts/index.md) (1 credit / page · `GET /v1/reddit/subreddit_posts`) - [Reddit Profile API](https://socialtap.dev/apis/reddit/profile/index.md) (1 credit · `GET /v1/reddit/profile`) - [Reddit User Search API](https://socialtap.dev/apis/reddit/search_profiles/index.md) (1 credit / page · `GET /v1/reddit/search_profiles`) - [Reddit Comments API](https://socialtap.dev/apis/reddit/comments/index.md) (1 credit / page · `GET /v1/reddit/comments`) - [Reddit User Comments API](https://socialtap.dev/apis/reddit/profile_comments/index.md) (1 credit / page · `GET /v1/reddit/profile_comments`) - [Reddit Comment Search API](https://socialtap.dev/apis/reddit/search_comments/index.md) (1 credit / page · `GET /v1/reddit/search_comments`) - [Reddit Video Transcript API](https://socialtap.dev/apis/reddit/transcript/index.md) (From 1 credit · `GET /v1/reddit/transcript`) - [Reddit Subreddit API](https://socialtap.dev/apis/reddit/subreddit/index.md) (1 credit · `GET /v1/reddit/subreddit`) - [Reddit Subreddit Search API](https://socialtap.dev/apis/reddit/search_subreddits/index.md) (1 credit / page · `GET /v1/reddit/search_subreddits`) ## Try it on an account you know. Paste its handle or link in the playground, or copy the request into your code. 100free credits - No credit card - Failed requests are free - Works on all 218 endpoints [Start for free](https://socialtap.dev/signup/) [Read the docs](https://socialtap.dev/docs/index.md) --- [HTML version](https://socialtap.dev/apis/reddit/engagement/) · [Docs index for AI agents](https://socialtap.dev/llms.txt) · [All docs in one file](https://socialtap.dev/llms-full.txt)