Find Reddit users by name
Search for Reddit users by username. Returns matching profile names, descriptions, metadata, and URLs.
/search-users Search https://api.fetchlayer.dev/reddit/search-users Headers
Authorization string required Bearer token — your FetchLayer API key.
Parameters
query string required Username to search for.
limit number optional Max results. (default: 10)
pages number optional Maximum number of result pages to scrape. (default: 1)
Response Fields
search-users
Find Reddit users by name
blocked boolean Whether Reddit returned a block or verification page.
blockReason string | null Machine-readable block reason when blocked is true; otherwise omitted.
blockedBodyText string | null Diagnostic block-page text when blocked is true; otherwise omitted.
pageTitle string Title of the scraped Reddit page.
requestedUrl string Reddit URL requested by the scraper.
fetchUrl string Normalized Reddit URL fetched by the scraper.
finalUrl string Final URL after redirects.
responseStatus number | null HTTP status returned by Reddit, or null when unavailable.
listingType string Always search-users for a successful response.
query string User search query.
items[].username string | null Reddit username.
items[].displayName string | null Profile display name.
items[].descriptionText string Plain-text profile description.
items[].descriptionHtml string | null HTML profile description when available.
items[].url string | null Absolute Reddit profile URL.
items[].metaText string | null Metadata text displayed by Reddit.
listingTitle string | null Display title of the listing, or null when unavailable.
itemCount number Number of entries returned in items.
nextPageUrl string | null Next-page URL when available, otherwise null.
prevPageUrl string | null Previous-page URL when available, otherwise null.
pagesRequested number Number of pages requested.
pagesScraped number Number of pages successfully scraped.
scrapedAt string ISO 8601 timestamp for the scrape.
transport string Reddit page transport used for extraction.
Request
curl -X POST "https://api.fetchlayer.dev/reddit/search-users" \
-H "Authorization: Bearer ss-your-key" \
-H "Content-Type: application/json" \
-d '{"query":"spez","limit":5}'Response
{
"blocked": false,
"listingType": "search-users",
"query": "spez",
"items": [
{
"username": "spez",
"displayName": "spez",
"descriptionText": "Reddit profile description.",
"url": "https://www.reddit.com/user/spez/",
"metaText": "Reddit user"
}
],
"itemCount": 1,
"pagesRequested": 1,
"pagesScraped": 1,
"transport": "old-reddit-html"
}