Ad Details

GET/v1/reddit/adNot available

Retired: Reddit removed its public Ad Library, so this route can no longer return an ad.

Not available

This route is documented so that existing integrations get a clear answer, but it returns no data: every call is a free error and costs no credits. The notes below say what it answers.

01Query parameters

This endpoint takes no parameters.

02Responses

Real answers from the API. Lists are shortened to 2 items.

GET /v1/reddit/ad

{
  "success": false,
  "credits_remaining": 4980,
  "credits_charged": 0,
  "error": "bad_request",
  "errorStatus": 400,
  "message": "We're sorry, but Reddit Ad Library endpoints are permanently deprecated because Reddit removed its public Ad Library. These endpoints can no longer return Reddit ad data."
}

Common to every endpoint

Any route can answer these: a missing or wrong key, no credits left, the platform not answering, or a failure on our side. None of them costs credits.

GET /v1/cosmos/profile?handle=design

{
  "success": false,
  "message": "Invalid API key"
}

03Notes

Not available. Every call answers a free 400 explaining that the Reddit Ad Library routes are permanently deprecated. Kept so existing integrations get a clear answer.

04Errors & credits

Every error has success: false, a real HTTP status and costs no credits.

400missing_parameter
A required parameter is missing or invalid.
403private_account
The account is private or age-restricted.
404not_found
No such account.
503upstream_error
The platform did not answer; retry shortly.