# Things



<MethodPage method="GET" path="/v1/reddit/things" credits={1}>
  <MethodSignature name="getThings" args={[{ name: "ids" }]} returns="ThingsResponse" />

  Fetches posts and comments you already know the IDs of: to refresh scores, check whether something was removed, or turn a list of links into data. Returns the items in the order you asked, without comment trees; use [Post](/reddit/post) for a thread. 1 credit per call, for up to 100 IDs.

  <Security permission="reddit:read" />

  <SchemaGroup title="Query parameters">
    <SchemaField name="ids" type="string" location="query" required>
      Up to 100 comma-separated IDs. Each can be a fullname (`t3_1x144ok` for a post, `t1_peqasez` for a comment), a bare post ID (`1x144ok`), or a post or comment URL. A bare ID is taken as a post.
    </SchemaField>
  </SchemaGroup>

  <div id="returns" className="mt-8">
    Response [#response]

    ```jsonc
    // GET /v1/reddit/things?ids=t3_1x144ok,t1_peqasez
    {
      "items": [
        {
          "kind": "post",
          "post": {
            "id": "1x144ok",
            "name": "t3_1x144ok",
            "subreddit": "programming",
            "title": "How big is a Git commit?",
            "author": "fagnerbrack",
            "score": 109,
            "num_comments": 41,
            "url": "https://ratfactor.com/cards/git-commit-size",
            "created_at": "2026-10-08T22:00:15Z"
            // …the other post fields, as in Subreddit
          }
        },
        {
          "kind": "comment",
          "comment": {
            "id": "peqasez",
            "name": "t1_peqasez",
            "post_id": "1x144ok",
            "post_title": "How big is a Git commit?",
            "subreddit": "programming",
            "author": "Bpofficial",
            "score": 192,
            "body": "At least 3",
            "created_at": "2026-10-08T22:07:39Z",
            "permalink": "/r/programming/comments/1x144ok/how_big_is_a_git_commit/peqasez/",
            "parent_id": "t3_1x144ok",
            "is_submitter": false,
            "controversiality": 0
          }
        }
      ],
      "missing": []
    }
    ```

    `missing` lists the IDs Reddit returned nothing for, as you passed them. An ID that isn't a fullname, a post ID or a Reddit URL returns 400 `invalid_request`.
  </div>

  <MethodSamples>
    <LanguageSample language="cURL">
      ```bash
      curl "https://api.threadapi.dev/v1/reddit/things?ids=t3_1x144ok,t1_peqasez" \
        -H "Authorization: Bearer $THREADAPI_API_KEY"
      ```
    </LanguageSample>

    <LanguageSample language="Python">
      ```python
      import os, requests

      ids = ["t3_1x144ok", "t1_peqasez"]  # up to 100
      r = requests.get(
          "https://api.threadapi.dev/v1/reddit/things",
          params={"ids": ",".join(ids)},
          headers={"Authorization": f"Bearer {os.environ['THREADAPI_API_KEY']}"},
      )
      for item in r.json()["items"]:
          thing = item[item["kind"]]
          print(item["kind"], thing["score"])
      ```
    </LanguageSample>
  </MethodSamples>
</MethodPage>