API service

Route every visit with a smarter link

SmartURLs combines a managed destination with Stopbot visitor detection, allowing each visit to receive a redirect decision and its supporting traffic context.

GET /services/shorterlink

How it works

A managed link with a decision behind it

A SmartURLs request uses a registered keyname together with visitor IP and optional user-agent context. Stopbot evaluates the visit, records its result, and returns the redirect destination for the active link configuration.

uniqueCode is returned only when JavaScript verification is enabled and a verification token is issued. The client uses that token for the follow-up verification request.
Response fieldsGET /services/shorterlink
redirectToDestination selected by the active SmartURLs configuration
blockAccessAccess decision produced for the current visit
jsResponseShows whether JavaScript verification is enabled for the link
uniqueCodeOptional token used by the JavaScript verification flow

Integration examples

Resolve SmartURLs from your stack

Send the registered keyname and visitor context, then use the returned JSON to continue the configured redirect and verification flow.

Replace the keyname placeholder with one owned by the API account and handle redirectTo, jsResponse, and uniqueCode according to the documented flow. Read the complete SmartURLs documentation.

Connected rings representing a managed link between destinations

Core capabilities

What SmartURLs provides

Managed destination

Keep the public keyname stable while controlling its active and blocked destinations from the panel.

Visitor-aware routing

Uses traffic context and configured country, device, and detection rules when deciding where a visit goes.

JavaScript verification

Supports an optional second step that records whether the visitor executed the browser verification flow.

Visit statistics

Records SmartURLs visitor results so link activity can be reviewed from the Stopbot panel.

Use cases

Where SmartURLs fits

Campaign links

Use one managed link while retaining control over destination and visitor filtering rules.

Device or country routing

Send visits to destinations that fit the configured device and geographic policy.

Traffic visibility

Review redirect activity together with detection decisions and visitor network context.

Start using SmartURLs

Create an account, configure the service in the Stopbot panel, and follow the integration documentation for your application.