Search users
GET
/v1/reddit/users/searchMCP
reddit_user_search2 creditsLiveUpdated
Description
Find Reddit accounts by keyword in their name or profile. Returns profiles with karma, age, bio and badges. Costs 2 credits per page. Tip: use it to find a company's or founder's official account before calling reddit.user_posts.
Parameters
| Name | In | Type | Required | Default | Description |
|---|---|---|---|---|---|
q | query | string | yes | Keyword to match in usernames and profiles. | |
nsfw | query | boolean,string | no | Include adult accounts. true needs the 18+ setting. | |
limit | query | integer | no | 25 | Max rows to return (1-100). Reddit pages hold about 25 rows; larger values still return one page. Range 1 to 100. |
cursor | query | string | no | Opaque cursor from the previous response's page.nextCursor. Length 1 to 2048. |
- q query, string, required
- Keyword to match in usernames and profiles.
- nsfw query, boolean,string
- Include adult accounts. true needs the 18+ setting.
- limit query, integer
- Max rows to return (1-100). Reddit pages hold about 25 rows; larger values still return one page. Range 1 to 100. Default
25. - cursor query, string
- Opaque cursor from the previous response's page.nextCursor. Length 1 to 2048.
Request examples
curl "https://chatterapi.com/v1/reddit/users/search?q=hubspot&limit=10" \
-H "Authorization: Bearer $CHATTERAPI_KEY"Response
data is a list of RedditUser, with page.nextCursor and page.hasMore for the next page. Fields:
| Field | Type | Nullable | Description |
|---|---|---|---|
username | string | no | Username without u/. |
id | string | yes | Platform id. |
createdAt | string | yes | ISO 8601 UTC timestamp. |
karma | object | no | Total, post and comment karma. |
bio | string | yes | Profile bio. |
avatarUrl | string | yes | Avatar image URL. |
badges | object | yes | Verified, employee, moderator and premium flags, or null. |
response
{
"data": [
{
"username": "hubspot",
"id": "t2_7lu6yhqo",
"createdAt": "2020-08-07T22:01:06.000Z",
"karma": {
"total": 8,
"post": 8,
"comment": 0
},
"bio": null,
"avatarUrl": "https://styles.redditmedia.com/t5_2yo33r/styles/profileIcon_ky3b0bmwxwz61.png?width=256&height=256&crop=256:256,smart&s=4077c0fc3317942a8d2af82a4cee13b887d24820",
"badges": {
"premium": false,
"moderator": true,
"employee": false,
"verified": true
}
},
{
"username": "HubSpotAMA",
"id": "t2_eqytq96e",
"createdAt": "2021-09-23T17:59:05.000Z",
"karma": {
"total": 226,
"post": 145,
"comment": 81
},
"bio": "We're HubSpot, a CRM platform that's both powerful and easy to use. Check us out: https://www.hubspot.com/",
"avatarUrl": "https://styles.redditmedia.com/t5_52vydu/styles/profileIcon_2ku9xt7ylap71.png?width=256&height=256&crop=256:256,smart&s=2ca002ebfa95c112bf71e0256e921d5b1d2f8148",
"badges": {
"premium": false,
"moderator": true,
"employee": false,
"verified": true
}
},
{
"username": "HubSpotDev",
"id": "t2_86fzmr8d",
"createdAt": "2020-09-21T16:35:57.000Z",
"karma": {
"total": 12,
"post": 9,
"comment": 3
},
"bio": "We help developers build apps, integrations, and websites on HubSpot's platform. Visit developers.hubspot.com for free developer resources and tools.",
"avatarUrl": "https://styles.redditmedia.com/t5_35hs1u/styles/profileIcon_rzb8xi2n4jo51.png?width=256&height=256&crop=256:256,smart&s=b51e8a7ae8b7f270223d293f701d1589ff2e74ed",
"badges": {
"premium": false,
"moderator": false,
"employee": false,
"verified": true
}
}
],
"page": {
"nextCursor": "eyJ2IjoxLCJwIjoiY2l0ZXJvY2tldCIsImMiOiJ0Ml9odW0wdTdkdyIsIm8iOjAsImgiOiJjNGUzMTFmZDI1N2YifQ",
"hasMore": true
},
"credits": {
"charged": 2,
"remaining": 24997
},
"requestId": "req_01JA7Q3V8K2N4P5R6S7T8V",
"cached": false
}Recorded live response captured 2026-10-13, truncated to 3 items. Credits and request id are illustrative.
Credits
2 credits per call. Failed calls cost 0. Cached responses cost the same. Test keys cost 0. Repeat calls with the same input within 1 hour are served from cache.