Overview

Welcome to the official B.Y.P.A.S.S API documentation (Banning Your Persistent Attempts to Skip Sponsors). This API enables developers and content creators to protect their monetized links against unauthorized bypass services.

What is B.Y.P.A.S.S?

B.Y.P.A.S.S is an advanced protection system specifically designed to prevent unauthorized bypassing of monetized link services. It protects content creator revenue through multiple layers of security and detection.

๐Ÿ›ก๏ธ

Multi-Layer Protection

Multiple detection systems working in concert

โšก

Fast API

Millisecond responses for seamless integration

๐Ÿ”ง

Highly Configurable

Customize every aspect of protection

Authentication

All API requests require authentication via a unique API Key that must be included in the headers of each request.

Authentication Header

Include your API Key in the c-api-key header in all your requests. This key is provided by B.Y.P.A.S.S upon service registration.

Required Header
c-api-key: {apikey}
โš ๏ธ

Important

Never share your API Key publicly. If you believe it has been compromised, contact support immediately to generate a new one.

Base URL

All API requests must be directed to the following base URL. Ensure you use HTTPS to guarantee data security.

Base URL
https://kys.linkvertise.lol/api/v2/bck

Request Body

The request body must be a JSON object containing all configuration parameters for the protected link. The complete structure is shown below.

Complete Request Body Example
{
  "url": "https://google.com",
  "pikey": "1229349",
  "provider": "lvdynamic",
  "ads_script_url": "https://example.com/ads.js",
  "jsonDetections": {
    "Referer": true,
    "MaxTasks": "3",
    "tier_id": 3,
    "Presets": {
      "BYPASS.VIP": true,
      "BYPASS.CITY": true,
      "TRW-API": true
    },
    "RenueveBooster": {
      "BlockVPNS": true,
      "BlockIncognito": true,
      "CaptchaRequired": true,
      "Max_Renueve": false,
      "XTra_tasks": [
        {
          "Title": "Join Discord",
          "Descr": "Join our community",
          "link": "https://discord.gg/xyz",
          "ID": "discord_join"
        }
      ]
    },
    "MinTime": "1",
    "DetectUserscripts": true,
    "UnicodeDetect": true,
    "SpoofCompletion": true,
    "RS_Invisible": false,
    "ManualDetectionZ": false,
    "VMConfig": {
      "enabled": true,
      "VMode": "medium"
    }
  }
}
GET

Manual Report

Verifies tokens generated by ManualDetectionZ. When a bypass attempt is detected and ManualDetectionZ is enabled, the user is still allowed to reach their destination but the final URL receives a RS_EvaluationDT parameter containing a short-lived token. This endpoint allows you to verify those tokens server-side.

Endpoint
GET https://kys.linkvertise.lol/api/v2/ManualReport?tk={token}

Query Parameters

ParameterTypeRequiredDescription
tkstringRequiredThe token received via the RS_EvaluationDT URL parameter. Valid for 30 seconds after generation.

Response Fields

FieldTypeDescription
successBooleantrue if the token exists and is valid. false if a token was not provided, not found, or an error occurred. The fields below are only present when success is true.
TaskIDStringThe task_id of the link that generated this token (same as in /DTOM/{task_id} returned by /api/v2/bck/publishers). Useful to ensure you are not validating a token from a different task.
TTNumberUnix timestamp of when the token was generated.
Completion_IPStringThe IP address of the user who completed the task. Typically IPv4.
FinalReportObjectA list of what was detected. Will be empty if nothing was detected. See the table below for possible entries.
encrypted_portStringCompact VM snapshot sealed with AES-256-GCM. If you find a working bypasser, bypass a link then send this parameter to our discord server, we will patch it.

FinalReport, Possible Detection Entries

Only present in the report when detected. Absent if not triggered. Values are usually boolean true, but some detections may return an internal JSON object with extra telemetry instead (e.g. counters). Always accept both shapes; more detections may adopt this in the future.

KeyFalse Positive RateDescription
referer_missmatch~2%Referer mismatch, the expected referer (e.g. linkvertise.com) was not received or a different one was sent. Note: ~2% False Positive Rate in some browsers.
Userscript_DET10%A userscript was detected using detection method DET1. 0% False Positive Rate.
LV_SPOOFED_COMPLETION0%The Linkvertise step was completed, but it was detected by our systems as being spoofed by a bypasser. 0% False Positive Rate.
LTL_SPOOFED_COMPLETION0%The LootLabs ad was completed by an external bypassing server rather than by the actual user. 0% False Positive Rate.
DeadHand_MagnusX50%Detection by the Magnus-type Dead-Hand engine (VMD-SIGNATURE-FAIL). 0% False Positive Rate.
DeadHand_MagnusX60%Detection by the Magnus-type Dead-Hand engine (VMD-DCY). 0% False Positive Rate.
DeadHand_MagnusX7~1%/~30%Detection by the Magnus-type Dead-Hand engine (VMD-SCREENWIDTHHEIGHT). ~1% False Positive Rate in normal users | ~30% False Positive in Premium Users (Linkvertise, Lootlabs, Lockr, etc). May return an internal JSON instead of true: {"VPoints": <int>} where 0 VPoints can mean the user used Premium to skip or used a bypasser.
DeadHand_MagnusX80%Detection by the Magnus-type Dead-Hand engine (VMD-TLS-FINGERPRINTING)
DeadHand_MagnusX90%Detection by the Magnus-type Dead-Hand engine (KAT environment-variable bind). Client-reported process env / KAT snapshot did not match the TLS-bound header set. 0% False Positive Rate.
DeadHand_MagnusX100%Detection by the Magnus-type Dead-Hand engine (VMD-YXHandshake-MISMATCH)
TRW_API_Detected0%A bypass using TRW-API was detected. 0% False Positive Rate.
BYPASS_CITY_DETECTED0%A bypass using BYPASS.CITY was detected. 0% False Positive Rate.
SEC_BROWSER_CHECK_01~2%Completion request was not a browser navigation (no Fetch Metadata, or a subresource/fetch). A normal document load is not flagged, including the ad redirect and the IP-changed continue button. Residual false positives are old browsers or proxies that strip Sec-Fetch-*.
FAST_COMPLETION0%The checkpoint was completed faster than the configured MinTime, indicating the ad steps were skipped. 0% False Positive Rate.
Example Response, bypass detected
{
  "success": true,
  "TaskID": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "TT": 1767760709,
  "Completion_IP": "192.168.1.1",
  "FinalReport": {
    "Userscript_DET1": true,
    "referer_missmatch": true,
    "DeadHand_MagnusX7": { "VPoints": 1 }
  }
}
Example Response, no detections
{
  "success": true,
  "TaskID": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "TT": 1767760709,
  "Completion_IP": "192.168.1.1",
  "FinalReport": {}
}
โš ๏ธ

Token Validity

Tokens generated by ManualDetectionZ are valid for 30 seconds only. Make sure to verify the token as soon as it is received to avoid expiration.

url

RequiredString

The destination URL to which the user will be redirected after successfully completing the monetization process. This is the final URL you wish to protect.

Detailed Description

This parameter defines the final destination of the protected link. When a user successfully completes all required verifications and monetization tasks, they will be automatically redirected to this URL.

  • Must be a valid URL with protocol (http:// or https://)
  • Can contain query string parameters
  • Supports any valid domain
  • HTTPS is recommended for greater security
Usage Example
"url": "https://example.com/file.zip"

pikey

RequiredString

Monetization provider authorization token. This value varies depending on the provider you are using to monetize your links.

Tokens by Provider

Depending on the selected provider, the pikey value must correspond to one of the following credential types:

ProviderToken TypeWhere to Obtain
lvdynamicUser IDYour numeric Linkvertise User ID
lootlabsAPI KeyLootLabs Dashboard โ†’ Developers
admavenAPI KeyAd-Maven Dashboard โ†’ Tools โ†’ API
cutyioAPI KeyCuty.io Dashboard โ†’ Settings
lockrAPI KeyLockr Dashboard โ†’ API
rinkuAPI KeyRinku Dashboard โ†’ API
Example with Linkvertise User ID
"pikey": "1229349"

provider

RequiredString

Specifies the monetization provider you wish to use to generate revenue through your protected link. Each provider has its own characteristics and requirements.

Available Providers

lvdynamicRecommended

Linkvertise via User ID. The only Linkvertise provider; linkvertise (bearer) is no longer accepted.

lootlabsRequires Postback

Integration with LootLabs. Requires postback configuration in the LootLabs dashboard to function properly.

admaven

Integration with Ad-Maven. Uses the Ad-Maven API Key to generate monetized link-shortener links.

cutyio

Integration with Cuty.io. Requires Cuty.io API Key to generate monetized links.

lockr

Integration with Lockr. Requires Lockr API Key to generate monetized links.

rinku

Integration with Rinku. Requires Rinku API Key to generate monetized links.

Example using Linkvertise Dynamic
"provider": "lvdynamic"

Domain Management

Auto-Routing

Removed - The system now auto-routes all users between domains: kys.linkvertise.lol, red-square.space, and rs.linkvertise.lol. This enhancement provides better load balancing, improved redundancy, and seamless user experience across all available domains without manual tier-based assignment.

Automatic Domain Routing

The previous tier-based domain assignment has been replaced with intelligent auto-routing. The system automatically distributes users across all available domains (kys.linkvertise.lol, red-square.space, and rs.linkvertise.lol) to optimize performance, ensure high availability, and prevent any single domain from becoming a bottleneck.

Available Domains:kys.linkvertise.lol, red-square.space, rs.linkvertise.lol
Users are automatically routed to the optimal domain based on current load, geographic location, and system health.
โœ…

Improvement

This change eliminates the need for manual domain selection and ensures consistent performance across all user tiers.

ads_script_url

OptionalString

When provided, this url will be loaded within the website, specifically on the /taskcompleted route, allowing the user to view personalized advertisements. this enables publishers and keysystem owners to maximize revenue generation from each link.

Detailed Description

This parameter allows loading custom advertisement scripts on the task completion page, enabling additional monetization opportunities.

Usage Example
"ads_script_url": "https://example.com/ads.js"

Referer

Boolean

Enables HTTP Referer header verification to detect and block bypass attempts originating from unauthorized websites.

How Does It Work?

When this option is enabled, the system verifies the Referer header of each incoming request. If the request originates from a known bypass service domain (such as websites offering to skip monetization), access will be automatically denied.

โœ“ Advantages

  • โ€ข Blocks direct bypasses from websites
  • โ€ข Real-time detection
  • โ€ข No impact on legitimate users

โš  Considerations

  • โ€ข Can be evaded with modified headers
  • โ€ข Combine with other detections
Configuration
"Referer": true

MaxTasks

StringLootLabs Only

Defines the maximum number of tasks a user must complete before gaining access to protected content. This parameter is exclusive to LootLabs.

Allowed Values

The value must be a numeric string between "1" and "5". Higher task numbers increase monetization but also the time required from users.

"1" - Minimum"2""3" - Recommended"4""5" - Maximum
Configuration (3 tasks)
"MaxTasks": "3"

tier_id

IntegerLootLabs Only

LootLabs advertisement tier passed to content_locker. Ignored for every other provider. You may send it inside jsonDetections or at the top level of the wrap body. Missing or out of range values fall back to 3.

Allowed Values (1โ€“4)

Matches LootLabs: which ads the visitor sees on the locker.

1 โ€” Trending & Recommended2 โ€” Gaming Offers & Recommendations3 โ€” Profit Maximization (default)4 โ€” Maximum Profit and Software Products
jsonDetections
"tier_id": 3

Presets

Object

Predefined configurations to detect and block specific bypass services. Each preset is optimized to detect the behavior pattern of a particular service.

Detectable Services

BYPASS.VIPBoolean

Detects and blocks bypass attempts from the BYPASS.VIP service, one of the most widely used services for skipping monetization.

BYPASS.CITYBoolean

Detects and blocks bypass attempts from BYPASS.CITY, another popular link bypass service.

TRW-APIBoolean

Detects services based on TRW-API, including F.E.A.R, BYPASSUNLOCK, and other websites using this bypass technology.

Complete Presets Configuration
"Presets": {
  "BYPASS.VIP": true,
  "BYPASS.CITY": true,
  "TRW-API": true
}

MinTime

String

Establishes the minimum time in seconds that a user must spend completing the monetization process before accessing the content.

Detailed Description

This configuration helps detect automated bypasses that attempt to complete the process instantly. If a user "completes" the adlink in less than the specified time, they will be marked as suspicious and denied access.

Allowed range:1 - 70 seconds
Recommended value:1 second
Configuration
"MinTime": "1"

DetectUserscripts

Boolean

Enables detection of userscripts (Tampermonkey, Greasemonkey scripts, etc.) that attempt to manipulate or bypass the monetization process.

What are Userscripts?

Userscripts are small JavaScript programs that users can install in their browsers to modify website behavior. Some of these scripts are specifically designed to skip link monetization.

โš ๏ธ

Advanced Detection

This function uses multiple detection techniques to identify userscript presence, including behavior analysis and DOM integrity verification.

Configuration
"DetectUserscripts": true

RenueveBooster

Object

A comprehensive revenue optimization suite that implements multiple protection mechanisms to maximize ad revenue while preventing bypass attempts. Each option targets specific vulnerabilities and revenue leaks.

Available Options

BlockVPNSBoolean

Blocks VPN and Proxy connections to ensure better CPM rates from advertisers.

Why: Advertisers pay less for traffic from VPNs/Proxies as they are often associated with fraud or low-quality traffic.

BlockIncognitoBoolean

Blocks Incognito/Private browsing mode for better CPM rates.

Why: Trackers and advertisers prefer users without Incognito/Anti-Tracking modes as they can collect more data and serve better-targeted ads.

CaptchaRequiredBoolean

Requires RG-Sentry captcha to proceed before accessing the protected content.

Effectiveness: Blocks 100% of automated, bot, and userscript completions. This is the most effective protection against automated bypasses.

Max_RenueveBoolean

Edits the API parameters to maximize revenue.

XTra_tasksArray

Attach additional tasks that users must complete before accessing the final destination. Tasks can be direct links, Discord server invitations, YouTube subscriptions, or any other action you want the user to complete.

Use Case: Monetize your links further by requiring users to complete extra actions (social follows, subscriptions, etc.) before proceeding to their destination.

Complete RenueveBooster Configuration
"RenueveBooster": {
  "BlockVPNS": true,
  "BlockIncognito": true,
  "CaptchaRequired": true,
  "Max_Renueve": false,
  "XTra_tasks": [
    {
      "Title": "Subscribe to Discord",
      "Descr": "Join our Discord server for updates and community",
      "link": "https://discord.gg/yourserver",
      "ID": "discord_sub_2024"
    },
    {
      "Title": "Follow Twitter",
      "Descr": "Follow our Twitter account",
      "link": "https://twitter.com/yourname",
      "ID": "twitter_follow_unique_12345"
    }
  ]
}

XTra_tasks, Additional User Tasks

Array of Objects

XTra_tasks enables you to require users to complete additional actions before accessing the protected content. This feature monetizes your links further by integrating social media follows, Discord server joins, YouTube subscriptions, or direct links to partner sites. Each task is tracked independently and persisted on the user's device via localStorage.

How It Works

1. Task Flow: After the user passes all bypass detection checks, they are presented with a list of required tasks before they can access the final destination.

2. Task Execution: Each task opens in a new browser window. The user clicks the task, waits 25 seconds (or completes the action), and the task is marked as done.

3. Device Tracking: Each completed task is stored in the browser's localStorage using the task's ID. This means:
โ€ข If ID is a unique string โ†’ user only completes it once per device forever
โ€ข If ID is false โ†’ user must complete it every time they visit

4. Completion: Once all tasks are marked as done, the user sees a "Click to Continue" button to access the final destination.

Task Object Structure

Each task in the array must contain:

Title (String, Required)

The headline shown to the user. Be clear and descriptive. Example: "Subscribe to YouTube Channel", "Join Discord Server", "Follow on Twitter"

Descr (String, Required)

Short description of what the task requires. Example: "Subscribe to our YouTube channel for exclusive content", "Join our Discord community"

link (String, Required - MUST BE VALID)

A valid, working URL where the user will be directed. This MUST be a real, functioning link. Examples:

  • โœ… https://discord.gg/yourserver - Discord invite
  • โœ… https://youtube.com/@yourchannel - YouTube channel
  • โœ… https://twitter.com/yourhandle - Twitter profile
  • โœ… https://example.com/signup - Partner site
  • โŒ https://loot-link.com/... - Lootlabs (NOT RECOMMENDED)
  • โŒ https://linkvertise.com/... - Linkvertise (NOT RECOMMENDED)
ID (String OR Boolean, Required)

Unique identifier for task completion tracking. CRITICAL: This determines how many times the user must complete the task.

Option A: String (UUID/Unique ID)

Use a unique string identifier (e.g., "discord_invite_2024", "youtube_sub_unique_12345", or a UUID). When set to a string:

  • โœ… User completes the task ONCE on their device
  • โœ… Task is never required again from that device (stored in localStorage)
  • โœ… Perfect for limited-time offers or one-time actions (follow, subscribe)

Example: "ID": "youtube_channel_sub_2024"

Option B: Boolean False

Use the boolean value false (NOT a string "false", but actual boolean false). When set to false:

  • โŒ User MUST complete this task every single time they access the link
  • โŒ No persistence across sessions
  • โœ… Useful for mandatory viewing (ads, sponsor content)
  • โš ๏ธ Creates poor user experience if overused

Example: "ID": false

๐Ÿ’ก

Note: Avoid Using Competitor Ad-Links as XTra_tasks

We don't recommend using ad-link services like Lootlabs, Linkvertise, AdMaven, Lockr, or similar monetization platforms as XTra_tasks.

Why? These services create a poor user experience because:

  • ๐Ÿ”„ Users can easily skip or close these tasks, reducing effectiveness
  • ๐Ÿ“‰ Creates redundant monetization layers (ad-link within ad-link) that confuse users
  • โฑ๏ธ Best suited for lightweight, quick actions (Discord joins, follows, votes) rather than full ad campaigns

โœ… BETTER CHOICE: Use simple, quick actions like Discord server invites, YouTube channel subscriptions, Twitter follows, newsletter signups, or partner redirects. These work best with XTra_tasks.

Complete Examples

Example 1: One-Time Tasks (Recommended)
"XTra_tasks": [
  {
    "Title": "Subscribe to our YouTube Channel",
    "Descr": "Get exclusive content and updates",
    "link": "https://youtube.com/@myawesomechannel",
    "ID": "youtube_sub_unique_2024"
  },
  {
    "Title": "Join our Discord Community",
    "Descr": "Connect with thousands of members",
    "link": "https://discord.gg/abcd1234",
    "ID": "discord_join_2024"
  },
  {
    "Title": "Follow on Twitter",
    "Descr": "Stay updated with the latest news",
    "link": "https://twitter.com/myhandle",
    "ID": "twitter_follow_unique_001"
  }
]
Example 2: Mandatory Tasks (Every Time - Not Recommended for UX)
"XTra_tasks": [
  {
    "Title": "Watch Our Sponsor Ad",
    "Descr": "This sponsor makes our service possible",
    "link": "https://example.com/sponsor-ad",
    "ID": false
  },
  {
    "Title": "Sign the Petition (Every Visit)",
    "Descr": "Your signature is required every time",
    "link": "https://petition.example.com/sign",
    "ID": false
  }
]
Example 3: Mixed Tasks (Hybrid Approach)
"XTra_tasks": [
  {
    "Title": "Subscribe to YouTube (One Time)",
    "Descr": "Subscribe once and never see this again",
    "link": "https://youtube.com/@mychannel",
    "ID": "yt_sub_one_time_only"
  },
  {
    "Title": "View Sponsor Message",
    "Descr": "Quick message from our partner",
    "link": "https://sponsor.example.com/message",
    "ID": false
  }
]
โœ…

Best Practices for XTra_tasks

  • โœ“ Use clear, honest descriptions of what you're asking
  • โœ“ Ensure all links are legitimate and working
  • โœ“ Limit to 2-3 tasks maximum (too many reduces completion rates)
  • โœ“ Use unique string IDs for actions you only want once per user
  • โœ“ Test the links before deploying
  • โœ“ Monitor user feedback about task experience
  • โœ— Never chain ad-links together
  • โœ— Don't use Lootlabs, Linkvertise, AdMaven, Lockr, or similar services
  • โœ— Don't require users to complete impossible tasks

UnicodeDetect

Boolean

Detects "undetectable" userscripts that use URL parameter manipulation techniques with Unicode characters to evade traditional detections.

Detection Technique

Some advanced userscripts attempt to conceal their presence by modifying URL parameters in subtle ways, including the use of Unicode characters that look identical to normal ASCII characters but have different codes.

This function verifies URL parameter integrity to detect if they have been modified by a userscript, blocking access if alterations are detected.

Configuration
"UnicodeDetect": true

SpoofCompletion

Boolean

Implements an advanced honeypot technique that tricks large website userscripts into believing the link has been successfully bypassed, sending them to a trap link that detects them.

How Does the Honeypot Work?

This is one of B.Y.P.A.S.S's most effective techniques. Instead of simply blocking bypass attempts, the system simulates a successful response that userscripts interpret as a completed bypass.

  1. The userscript attempts to bypass the link
  2. The system detects the attempt and returns a fake success response
  3. The userscript redirects the user to the "bypassed link"
  4. The trap link detects and records the bypass attempt
  5. The user is blocked or redirected to a warning page
Configuration
"SpoofCompletion": true

RS_Invisible

Boolean

When set to true, improves user experience by removing Red-Square ads, providing direct links to the original creator's adlinks.

How Does It Work?

When this option is enabled, the system removes the Red-Square advertising layer and provides direct links to the original creator's adlinks. This significantly improves the end user experience by eliminating unnecessary intermediaries.

โœ“ Advantages

  • โ€ข Better user experience
  • โ€ข Removes Red-Square ads
  • โ€ข Direct links to creator's adlinks
  • โ€ข No additional configuration required

โš  Considerations

  • โ€ข The only way Red-Square stays online is through ads (please consider supporting us)
  • โ€ข In automatic redirect mode, auto-bypass bots are more likely to pass through undetected
Configuration
"RS_Invisible": true

VMConfig

Object

Controls how strict the isolated VM stage is for Lockr.so, LootLabs, and Ad-Maven links: how many verification tasks a user must clear before entering the VM, and whether decoy links are served alongside the real one.

Quick Explain: How It Works

To stop users from copying the ad-link and dropping it into a bypass site, we run it inside our own isolated VM, under our own domain. The link itself is randomized so it cannot just be copied and reused elsewhere.

The ad-link is then loaded inside a realm. Top-level userscripts (F.E.A.R by MCB, Evade by Skipped.lol) are built specifically to avoid running inside realms like this one, since realms are easy to fingerprint. This step alone kills about 99% of bypass attempts. Only advanced users make it past this point.

Next, we run 2 to 5 decoy realms alongside the real one, so a script has no way of knowing which realm holds the actual destination. Inject into the wrong one and it gets flagged and blocked. Inject into the right one and it still gets caught.

Finally, every realm is checked every 5 seconds for anomalies, and the results are sent to our servers over YX, an encrypted client-server channel that isn't readable even by the client itself. This is what gets us to a 100% detection rate.

enabled

Boolean

Set to false to skip the isolated VM stage entirely for this link. Defaults to true when omitted.

โš  Known Issues

  • โ€ข LootLabs can occasionally return a 429 error for some users, caused by the decoys that keep the link secure
  • โ€ข High loading time on some devices (1-10s on a black screen)
  • โ€ข On Lockr.so, premium sessions seem to not work properly for users (gets them logged out, etc)

โœ“ What Our VM Offers

  • โ€ข So far, a 100% detection rate for bypasses, userscripts, and automated scripts
  • โ€ข The isolated VM blocks many network-level ad-blockers, improving CPM
  • โ€ข In some cases improves UX through cache loading that speeds everything up by 10x
  • โ€ข VM customization via VMode

VMode Tiers

Set VMode to one of three presets. Strictness is per provider, since each one handles VM entry differently.

VModeLockr.soLootLabsAd-MavenDecoys
"onlyvm"NoneNoneNonefalse
"medium"โ˜… RecommendedLightLightLighttrue
"high"StrictStandardLighttrue

Defaults to "medium" when omitted. Higher tiers mean more friction (and more monetized completions) before a user reaches the VM; "onlyvm" skips straight to the isolated VM with no extra checks and no decoys. Ignored when "enabled": false.

โš ๏ธ

Known Issue: "high" VMode

"high" can cause false positives on Ad-Maven and LootLabs links. We are working on fixing it.

Configuration
"VMConfig": {
  "enabled": true,
  "VMode": "medium"
}

ManualDetectionZ

Boolean

Delegates all final decisions to the administrator. When a bypass attempt is detected, the user is still allowed to reach their destination instead of being blocked, however, the final URL is appended with a RS_EvaluationDT parameter containing a short-lived verification token.

How Does It Work?

When this setting is enabled and a bypass attempt is detected, the system will not block the user. Instead, it appends a RS_EvaluationDT query parameter to the final destination URL. This token is valid for 30 seconds and can be verified server-side by making a GET request to the /api/v2/ManualReport endpoint.

โœ“ Advantages

  • โ€ข Users are never hard-blocked, no false positive lockouts
  • โ€ข Full control stays with the administrator
  • โ€ข Detailed detection report available per request
  • โ€ข Can be used alongside other detection settings

โš  Considerations

  • โ€ข Requires server-side token verification
  • โ€ข Token expires after 30 seconds, verify promptly
  • โ€ข Administrator must implement their own enforcement logic

Flow Overview

  1. User completes the monetization link
  2. B.Y.P.A.S.S detects a bypass attempt
  3. Instead of blocking, the user is redirected to the destination URL with ?RS_EvaluationDT=<token> appended
  4. Your server receives the request, extracts the token, and sends a GET to /api/v2/ManualReport?tk=<token>
  5. The API returns a FinalReport with what was detected, you decide how to proceed
Configuration
"ManualDetectionZ": true

Response Structure

When the request is successful, the API returns a JSON object with information about the generated protected link, including timestamps and the final link.

Successful Response
{
  "success": true,
  "link": "https://kys.linkvertise.lol/DTOM/{TaskID}?antibypass=true&apimade=tr",
  "Ntimestamp": 1767760709.8914726
}
โ„น๏ธ

About TaskID

The {TaskID} in the URL is a unique identifier generated for each protected link. This ID allows tracking and management of the specific link. Example: a1b2c3d4-e5f6-7890-abcd-ef1234567890

Response Fields

FieldTypeDescription
successBooleanIndicates whether the operation was successful (true) or failed (false)
linkStringThe generated protected link. Share this URL. apimade=tr when created with a publisher API key, fl when created from the public dashboard.
NtimestampNumberUnix timestamp (seconds, with decimals) of when the link was created. API-created links are deleted 1800 seconds (30 minutes) after this time.
X-RT headerStringServer processing time, e.g. 0.0123s. Not part of the JSON body.

Code Generator

Use this interactive generator to create customized integration code according to your specific needs.

Enter a valid JSON array of task objects. Leave empty if not using XTra_tasks.

Generated Python Code
import requests

data = {
    "url": "https://google.com",
    "pikey": "1229349",
    "provider": "lvdynamic",
    "ads_script_url": "",
    "jsonDetections": {
        "Referer": True,
        "MaxTasks": "3",
    "tier_id": 3,
        "Presets": {
            "BYPASS.VIP": True,
            "BYPASS.CITY": True,
            "TRW-API": True
        },
        "RenueveBooster": {
            "BlockVPNS": True,
            "BlockIncognito": True,
            "CaptchaRequired": True,
            "Max_Renueve": False
        },
        "MinTime": "1",
        "DetectUserscripts": True,
        "UnicodeDetect": True,
        "SpoofCompletion": True
    }
}

response = requests.post(
    "https://red-square.space/api/v2/bck/publishers",
    json=data,
    headers={"c-api-key": "xyzabc"}
)

print(response.json())

Common Errors

Below are the most common errors you may encounter when using the API and how to resolve them.

401

Unauthorized

The API Key provided in the c-api-key header is invalid or was not included in the request. Body: {"success": false, "THReason": "N01"}

Solution: Verify that you are using the correct API Key and that it is included in the headers.

403

Key inactive

The API key has not generated any new links for 15 consecutive days and is blocked. Body: {"success": false, "THReason": "INACTIVE"}

Solution: Contact staff on Discord to restore the key. Completions on existing links do not reset this window.

400

Bad Request

The parameters sent in the request body are invalid or required fields are missing.

Solution: Review that all required fields are present and have the correct format.

422

Invalid Provider Key

The pikey provided is not valid for the selected provider.

Solution: Ensure you are using the correct type of credential according to the provider (User ID, API Key, Bearer Token).

429

Rate Limited

You have exceeded the allowed requests per minute limit.

Solution: Wait a few seconds before making another request. Consider implementing rate limiting in your application.

500

Server Error

Unexpected failure while creating the link. Body is typically {"success": false}.

Solution: Retry once. If it persists, join Discord with the request payload (redact keys) and the X-RT header if present.

Need Help?

Join our Discord community to get technical support, report bugs, or suggest new features.

Join Discord