Oops! Facing network problem. Unable to load this page. Refresh

Please Wait...

Hello Guest

logo

Bulk URL(s) Short

Bulk URL(s) Short api document

Shorten Link
APIs

Bulk URL(s) Short

Base URL: https://insprl.com/api

POST /url/bulk-short-url

Shortening a single URL is easy - but what if you have hundreds or thousands of long links? The Bulk URL(s) Short API by SPRL lets you programmatically compress large batches of URLs into concise, trackable short links—all with a single API request. Whether you’re running marketing campaigns, sending newsletters, or managing large datasets, this API is built to scale.

With SPRL’s Bulk Link Shortener API, you can:

  • Use your own branded domain or the default SPRL domain
  • Define expiry dates per campaign
  • Control slug prefixes, response format, and more

Request Information

MethodPOST
Request URLhttps://insprl.com/api/url/bulk-short-url
AuthenticationRequired How to Generate API keys?
Header Yes Description
Authorization Yes Bearer {CLIENT_KEY}
Content-Type JSON Supported values:
  • application/x-www-form-urlencoded
  • application/json
ParameterTypeValidateDescription
client_idStringRequiredUse your "CLIENT ID" for this Parameter
urlsArrayRequiredAdd multiple urls (Up to 1000) which you want to get shorter.
slug_prefixStringOptionalAllowed only alpha-numeric characters, underscores, and dashes.
domainStringOptionalSpecify if you want to use custom domain
expiry_dateDateOptionalDate format: dd-mm-yyyy
response_modeStringOptional"plain" (Default) or "along" (Pass the reference key to receive in response)
ParameterTypeDescription
codeNumericFind the code information below under "API Codes"
messageString / ArrayAs per the request handler
short_urlsArrayList of Shorten URLs
 
 
SPRL Code HTTP Status Mode Response Field Description
100 200 success data Request processed successfully.
101 401 failed message Authentication failed. Invalid or missing API credentials.
102 422 failed errors Parameter validation failed. Check the input fields.
103 403 failed error SPRL account is restricted (temporary or permanent block).
104 400 failed errors Insufficient wallet balance. Recharge required.
105 500 failed message Unexpected server error. Please try again later.
129 429 failed errors API usage limit exceeded (daily, monthly, or total).
Category Flag Type Description
Account ACCOUNT_PERMANENT_BLOCKED account_restricted The SPRL account has been permanently blocked.
Account ACCOUNT_TEMP_BLOCKED account_restricted The SPRL account has been temporarily restricted.
Billing INSUFFICIENT_BALANCE billing_error The wallet balance is insufficient to process the request.
Rate Limit DAILY_LIMIT_REACHED rate_limit_exceeded The daily API usage limit has been exceeded.
Rate Limit MONTHLY_LIMIT_REACHED rate_limit_exceeded The monthly API usage limit has been exceeded.
Rate Limit TOTAL_LIMIT_REACHED rate_limit_exceeded The total API usage limit has been exceeded.
Validation INVALID_PARAMETER validation_error One or more request parameters are invalid.
Authentication INVALID_CREDENTIALS auth_error API credentials are missing or invalid.
Server UNEXPECTED_ERROR server_error An unexpected internal server error occurred.
99.9% Uptime
High Availability Infrastructure
Enterprise Security
OWASP-Aligned Controls
Built for Scale
High-Performance REST APIs

Security & Compliance

We follow industry best practices for API security and data protection.

Our APIs are designed with authentication, rate limiting, and continuous security review.

View our Security & Compliance Overview (PDF)
sprl chrome extension

Download the SPRL Google Chrome extension, It's free!

Easy and Quick way to shorten link with SPRL!

 Download Extension

We provide best customer support.

Please feel free to contact us at 8088 948 172 for support.

Contact Us

We use cookies to improve your experience, analyse traffic, and personalise content. By clicking “Accept”, you consent to the use of cookies as described in our Cookie Policy .

Accept cookies Read our Cookie Policy