API Description

This page describes how to make automated requests. Automated requests require an access token. You can buy a token here.

Request URL: https://cable.ayra.ch/reddit/auto.php
Request Mode: POST
User Agent: User agent header must be set and descriptive (30+ characters) and should contain an e-mail address, phone number or web address to contact you in case we see problems with your API requests.
Request Format: Either application/x-www-form-urlencoded or multipart/form-data
Request Parameters:

• un: Reddit username
• token: Access token
• api: Must be the value 1

Example tokens

The tokens listed below can be used to test your implementation. Note that no actual shadowban check will be performed when using these.

• 12345678-90AB-CDEF-0000-FB0102915A9F: Pretends that the account is OK
• 12345678-90AB-CDEF-0000-A6F3D97A08FF: Pretends that the account is restricted to ages 18+
• 12345678-90AB-CDEF-0000-41128BA1D5DC: Pretends that the account is shadowbanned
• 12345678-90AB-CDEF-0000-F39482E1A2FA: Pretends that reddit is overloaded
• 12345678-90AB-CDEF-0000-B2CE64392884: Pretends that reddit sent an unknown answer
• 12345678-90AB-CDEF-0000-9AC47E4249FD: Pretends that the token is completely used up

Example request

POST /reddit/auto.php HTTP/1.1
Host: cable.ayra.ch
User-Agent: RedditShadowbanTester/1.0 +contact@example.com
Content-Length: 56
Content-Type: application/x-www-form-urlencoded

un=test&token=0b8a8889-297b-44bd-a487-489a39b8c105&api=1

Response Description

The response will be a JSON object with the following keys:

• name: The reddit username that was checked
• code: A number indicating the result. See below for a list of numbers
• desc: A string that describes the code
• remain: A number indicating how many requests remain for your token
• sign: A link to allow verification of the request by anybody. Not valid when using example tokens.

Possible codes

• 0: User is not shadowbanned
• 1: User has profile restricted to mature audience (age 18+)
• 2: User is shadowbanned or does not exist
• 3: Unable to derermine account status. Reddit probably overloaded
• 4: Local server error. Try again later
• 1000 or bigger: Reddit probably overloaded

If you receive a code of 3 or bigger, your token will not be consumed.

Error Responses

If your token has no remaining requests, HTTP 400 will be returned. If your token is not found, HTTP 404 is returned.

Error responses will not contain a JSON but may contain a raw description text.