# Reddit User Search API. Users matching your search. Users by name, with karma and avatar. We handle the proxies, blocks and platform changes. [Get API key](https://socialtap.dev/signup/?next=%2Fplayground%2F%3Fendpoint%3Dreddit.search_profiles) ## Reddit User Search API at a glance Searches Reddit users by name and returns them a page at a time, in Reddit's relevance order. Each has its t2_ ID, username, profile link, avatar, description, verified badge and exact total karma. A name or part of one works, in any language and any case. GET `/v1/reddit/search_profiles` [Read the API reference](https://socialtap.dev/docs/reference/reddit/search_profiles/index.md) - **1 credit** per page, $0.75–$1.97 per 1,000 pages - **19 typed fields** null when unknown - **7** users per page, Reddit's relevance order - **`query`** is all it needs, e.g. `spez` ## Send one request. Get up to 7 users 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` `query = spez` [Open in playground](https://socialtap.dev/playground/?endpoint=reddit.search_profiles) cURL: ```shell curl 'https://socialtap.dev/v1/reddit/search_profiles?query=spez' \ -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.searchProfiles.list({ query: "spez" }); console.log(res.data); console.log(res.credits.charged, res.meta.request_id); ``` Node.js (fetch): ```javascript const params = new URLSearchParams({ query: "spez", }); const res = await fetch(`https://socialtap.dev/v1/reddit/search_profiles?${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, page, meta } = body; console.log(data, meta.credits_charged); ``` Python (requests): ```python import os import requests res = requests.get( "https://socialtap.dev/v1/reddit/search_profiles", params={"query": "spez"}, 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, page, meta = body["data"], body["page"], 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("query", "spez") req, err := http.NewRequest("GET", "https://socialtap.dev/v1/reddit/search_profiles?"+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"` Page json.RawMessage `json:"page"` 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": [], "avatar_url": "https://styles.redditmedia.com/t5_3k30p/styles/profileIcon_uj015iwx9s7g1.png", "banner_url": null, "bio": "Reddit CEO", "category": null, "country_code": null, "created_at": null, "display_name": null, "external_links": [], "id": "t2_1w72", "is_private": false, "is_verified": true, "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": null, "contribution_count": null, "is_admin": null, "is_nsfw": null, "is_premium": null, "karma": 941387, "moderated_subreddits": [], "post_karma": null, "trophies": [] } }, "type": "unknown", "unknown_fields": [ "external_links", "platform_specific.reddit.moderated_subreddits", "platform_specific.reddit.trophies" ], "url": "https://www.reddit.com/user/spez/", "username": "spez" }, { "approximate_fields": [], "avatar_url": "https://i.redd.it/snoovatar/avatars/dd4f5ee8-3016-4ba8-b38b-cc9f09c5ff44.png", "banner_url": null, "bio": null, "category": null, "country_code": null, "created_at": null, "display_name": null, "external_links": [], "id": "t2_w1jdgw3z4", "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": null, "contribution_count": null, "is_admin": null, "is_nsfw": null, "is_premium": null, "karma": -1, "moderated_subreddits": [], "post_karma": null, "trophies": [] } }, "type": "unknown", "unknown_fields": [ "external_links", "platform_specific.reddit.moderated_subreddits", "platform_specific.reddit.trophies" ], "url": "https://www.reddit.com/user/Spezigeniesser/", "username": "Spezigeniesser" }, { "approximate_fields": [], "avatar_url": "https://styles.redditmedia.com/t5_23u24h/styles/profileIcon_7jn5mi6ql2wd1.png", "banner_url": null, "bio": null, "category": null, "country_code": null, "created_at": null, "display_name": null, "external_links": [], "id": "t2_4gm3yvpn", "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": null, "contribution_count": null, "is_admin": null, "is_nsfw": null, "is_premium": null, "karma": 11283, "moderated_subreddits": [], "post_karma": null, "trophies": [] } }, "type": "unknown", "unknown_fields": [ "external_links", "platform_specific.reddit.moderated_subreddits", "platform_specific.reddit.trophies" ], "url": "https://www.reddit.com/user/spezialzt/", "username": "spezialzt" } ], "page": { "has_more": true, "next_cursor": "c1.EXAMPLE_CURSOR", "next_cursor_expires_at": "2026-10-26T12:00:00Z", "end_reason": null }, "meta": { "request_id": "req_3f9c2a7d1e8b4c6a9f0e2d4b6a8c0e1f", "platform": "reddit", "source": "page", "is_cached": false, "credits_charged": 1, "latency_ms": 364, "fetched_at": "2026-10-25T12:00:00Z", "input": null, "credits_remaining": 9999, "client_request_id": null, "warnings": [] } } ``` Long arrays and strings are shortened here. Real responses are complete. ## One schema on 27 platforms. The [response reference](https://socialtap.dev/docs/reference/reddit/search_profiles/index.md#response) lists every field, its type and when it is `null`. [See the full schema](https://socialtap.dev/resources/profile/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 A name to find Reddit users by, matched by Reddit's people search against usernames (spez, bill gates, tagesschau); case does not matter. - ### Write one parser Reddit, TikTok, Instagram and 24 more platforms answer in these fields, so the code that reads one reads them all. - **`platform`string**: Platform ID (tiktok, youtube, …). - **`id`string**: Platform-native account ID (string; YouTube UC…, Reddit t2_…). - **`username`string**: Handle without the @; null when the account has none. - **`display_name`string**: Display name, channel title or page name; null when empty or not exposed. - **`url`string**: Canonical profile URL. - **`type`string**: Coarse account kind, as the platform labels it; unknown when it does not (TikTok labels organizations only). New values may be added; treat unknown values as unknown. - **`bio`string**: Profile bio, channel description or page about text; null when empty or not exposed. - **`avatar_url`string**: Profile picture URL (largest available). Platform CDN URLs can expire within hours. 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 User Search API. - ### Find a person's or brand's Reddit account - ### Resolve names to usernames and t2_ IDs - ### Spot impersonators of a username - ### Rank candidate accounts by karma ## Good to know before you build. - Results show only what Reddit's people search shows. Display name, cake day, post and comment karma, badges other than verified, social links, moderated subreddits and trophies are null (the lists in unknown_fields). The Reddit Profile API returns them. - Reddit serves a few pages of people per search logged out. A walk that reaches the last one ends with end_reason platform_limit. - Accounts with adult names are found like any other, but the results don't show whether a profile is marked NSFW, so platform_specific.reddit.is_nsfw is null. ## 1 credit per page. 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/search_profiles/index.md#pricing) · [How credits work](https://socialtap.dev/docs/credits/index.md) | Source | Price per successful page | Per 1,000 pages | | --- | --- | --- | | 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 User Search API. More in the [API reference](https://socialtap.dev/docs/reference/reddit/search_profiles/index.md). **How much does the Reddit User Search API cost?** A page of up to 7 users costs 1 credit. Every successful page is charged, empty pages included. SocialTap credits cost $0.75–$1.97 per 1,000, depending on the plan or pack. **How do I get the next page?** Repeat the same request with cursor set to page.next_cursor from the previous response, keeping the other parameters. When page.has_more is false there are no more pages. Cursors expire after 24 hours. Other platforms ## Profiles on 26 more platforms. - [TikTok Profile API](https://socialtap.dev/apis/tiktok/profile/index.md) (1 credit · `GET /v1/tiktok/profile`) - [Instagram Profile API](https://socialtap.dev/apis/instagram/profile/index.md) (1 credit · `GET /v1/instagram/profile`) - [Facebook Profile API](https://socialtap.dev/apis/facebook/profile/index.md) (1 credit · `GET /v1/facebook/profile`) - [YouTube Channel API](https://socialtap.dev/apis/youtube/profile/index.md) (1 credit · `GET /v1/youtube/profile`) - [Threads User Search API](https://socialtap.dev/apis/threads/search_profiles/index.md) (1 credit / page · `GET /v1/threads/search_profiles`) - [Spotify Artist API](https://socialtap.dev/apis/spotify/artist/index.md) (1 credit · `GET /v1/spotify/artist`) - [Amazon Shop API](https://socialtap.dev/apis/amazon/shop/index.md) (1 credit · `GET /v1/amazon/shop`) - [Apple Music Artist API](https://socialtap.dev/apis/applemusic/artist/index.md) (1 credit · `GET /v1/applemusic/artist`) - [Pinterest Profile API](https://socialtap.dev/apis/pinterest/profile/index.md) (1 credit · `GET /v1/pinterest/profile`) - [Rumble Channel API](https://socialtap.dev/apis/rumble/profile/index.md) (1 credit · `GET /v1/rumble/profile`) - [X (Twitter) Profile API](https://socialtap.dev/apis/x/profile/index.md) (1 credit · `GET /v1/x/profile`) - [Bluesky Profile API](https://socialtap.dev/apis/bluesky/profile/index.md) (1 credit · `GET /v1/bluesky/profile`) - [Twitch Profile API](https://socialtap.dev/apis/twitch/profile/index.md) (1 credit · `GET /v1/twitch/profile`) - [LinkedIn Profile API](https://socialtap.dev/apis/linkedin/profile/index.md) (From 1 credit · `GET /v1/linkedin/profile`) - [Telegram Channel API](https://socialtap.dev/apis/telegram/channel/index.md) (1 credit · `GET /v1/telegram/channel`) - [Kwai Profile API](https://socialtap.dev/apis/kwai/profile/index.md) (1 credit · `GET /v1/kwai/profile`) - [Snapchat Profile API](https://socialtap.dev/apis/snapchat/profile/index.md) (1 credit · `GET /v1/snapchat/profile`) - [SoundCloud Artist API](https://socialtap.dev/apis/soundcloud/artist/index.md) (1 credit · `GET /v1/soundcloud/artist`) - [Truth Social Profile API](https://socialtap.dev/apis/truthsocial/profile/index.md) (1 credit · `GET /v1/truthsocial/profile`) - [Komi Page API](https://socialtap.dev/apis/komi/page/index.md) (1 credit · `GET /v1/komi/page`) - [Lnk.Bio Profile API](https://socialtap.dev/apis/linkbio/profile/index.md) (1 credit · `GET /v1/linkbio/profile`) - [Linkme Profile API](https://socialtap.dev/apis/linkme/profile/index.md) (1 credit · `GET /v1/linkme/profile`) - [Linktree Profile API](https://socialtap.dev/apis/linktree/profile/index.md) (1 credit · `GET /v1/linktree/profile`) - [Pillar Page API](https://socialtap.dev/apis/pillar/page/index.md) (1 credit · `GET /v1/pillar/page`) - [Facebook Ad Library Advertiser Search API](https://socialtap.dev/apis/facebook/search_advertisers/index.md) (1 credit / page · `GET /v1/facebook/search_advertisers`) - [Google Ads Transparency Center Advertiser API](https://socialtap.dev/apis/google/advertiser/index.md) (1 credit · `GET /v1/google/advertiser`) 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 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 Engagement API](https://socialtap.dev/apis/reddit/engagement/index.md) (1 credit · `GET /v1/reddit/engagement`) - [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 with your own search. Type it 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/search_profiles/) · [Docs index for AI agents](https://socialtap.dev/llms.txt) · [All docs in one file](https://socialtap.dev/llms-full.txt)