Look Up 100 Reddit Accounts in One API Call

Up to 100 Reddit accounts in one call, by account id.

Every post and comment this API returns carries its author's account id, author_info.fullname (for example t2_16b0vi). After a search or a subreddit read, pass those ids here to get every author's karma and account age in one call instead of one call per author.

Query Parameters

By id, not by username. Reddit's batch read takes account ids only; it has no batch read by username. A bare name such as spez is refused rather than read as an id, because the two look alike. For one username, use /api/reddit/user/{name}, which also returns the account's fullname.

Example

curl -H "Authorization: Bearer $TOKEN" \
  "https://api.redditapis.com/api/reddit/users/batch?ids=t2_16b0vi,t2_10qk8o"

const response = await fetch(
  "https://api.redditapis.com/api/reddit/users/batch?ids=t2_16b0vi,t2_10qk8o",
  { headers: { Authorization: "Bearer TOKEN" } }
);
const { users, missing } = await response.json();

import requests

response = requests.get(
    "https://api.redditapis.com/api/reddit/users/batch",
    params={"ids": "t2_16b0vi,t2_10qk8o"},
    headers={"Authorization": "Bearer TOKEN"},
)
data = response.json()

Response Shape

{
  "users": [
    {
      "id": "16b0vi",
      "fullname": "t2_16b0vi",
      "name": "KNeutch",
      "created_utc": 1500000000,
      "created": "2017-07-14T02:40:00.000Z",
      "link_karma": 10,
      "comment_karma": 32,
      "total_karma": 42,
      "profile_img": "https://...",
      "profile_over_18": false
    }
  ],
  "requested": 2,
  "returned": 1,
  "missing": ["t2_10qk8o"]
}

An id Reddit does not return is listed in missing: the account was deleted or suspended, or the id never existed. Every id you sent is in users or in missing. For the reason behind one missing account, read it by name with /api/reddit/user/{name}.

Errors

Billed at the standard read price, $0.0015 per call, at any batch size.