---
title: "Post Visibility Check"
method: GET
path: "/api/reddit/post/{id}/visibility"
tags: ["Posts"]
---

# Post Visibility Check

`GET /api/reddit/post/{id}/visibility`

## Request

- Base URL: `https://api.redditapis.com`
- URL: `https://api.redditapis.com/api/reddit/post/{id}/visibility`
- Auth: HTTP bearer

Is a post still publicly visible, or did it quietly stop being so? A removed Reddit post still returns when fetched by id, with its title, body and score, so this cannot be answered by reading the post. It is answered by fetching the post and then one page of its author's submitted listing and comparing. Returns a `verdict` of `live`, `not_visible` or `undecidable`, a plain-language `reason`, and a `confident` flag. It deliberately never names a CAUSE: a moderator removal, an admin removal, a spam filter and an author who has hidden their post history are indistinguishable from outside, and only one of them is "removed". Exactly two upstream calls. Cost: $0.004 per call.

## Path parameters

- `id` string, required

## Response `200`

The post plus a visibility verdict

- object
  - `post` object
  - `verdict` 'live' | 'not_visible' | 'undecidable' | 'not_found'
  - `reason` string
  - `confident` boolean
  - `checked` object

## Other responses

- `400`: Malformed post id
- `402`: Your account balance does not cover this call, so nothing was charged and the request was not served. The response body is {"error":"Insufficient credits","top_up_url":"https://www.redditapis.com/dashboard/buy-credits","message":"..."}; error keeps that exact wording. This is a billing state, not a bad request: the same call succeeds once the balance is topped up, and retrying without topping up returns 402 again, which is why it carries Retry-After: 3600. Top up at the top_up_url, then call again at once; the header does not apply after a top-up. Read the remaining balance any time from GET /account/me, which is free and never returns this error. Distinct from the 402 on the monitoring endpoints, which is about plan entitlements rather than credits.
- `404`: No post with that id

---

[API](https://skmtc.dev/redditapis/apis/redditapis-api.md) · [All operations](https://skmtc.dev/redditapis/apis/redditapis-api/llms.txt) · [OpenAPI document](https://skmtc.dev/redditapis/apis/redditapis-api/revisions/f93b643b51b6?raw)