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

Please Wait...

Hello Guest

logo

Short URL Analytics

Short URL Analytics api document


APIs

Short URL Analytics

Getting Started

Authenticate using the Login API to obtain an access token. Include the returned Bearer Token in the Authorization header and provide a unique X-Device-ID with all authenticated requests. All requests must be made over HTTPS and are subject to rate limits.

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

POST /external/short-url/analytics
Use the Short URL Analytics API to retrieve performance metrics for an individual short URL. This endpoint provides click activity, visitor statistics, engagement metrics, and recent performance information, allowing integrations to display analytics directly within browser extensions, WordPress plugins, dashboards, and automation workflows.

Request Information

MethodPOST
API Endpointhttps://insprl.com/api/external/short-url/analytics
Authentication Required

Header Parameters

ParameterTypeDescription
AuthorizationStringBearer authentication token received from the Login API.
X-Device-IDStringThe same device identifier used during login.
Content-TypeJSONapplication/json

Request Parameters

ParameterTypeValidateDescription
slugStringRequiredShort URL slug to retrieve analytics for.

Response Parameters

ParameterTypeDescription
successBooleanRequest status (true/false).
dataObjectAnalytics summary for the requested URL.
data.url_idIntegerUnique URL identifier.
data.click_countIntegerTotal recorded clicks.
data.unique_visitorsIntegerTotal unique visitors.
data.last_clicked_atDateTimeLast click timestamp.
data.created_atDateTimeURL creation timestamp.
data.freshness_scoreIntegerContent freshness score.
data.engagement_scoreIntegerVisitor engagement score.
data.intelligence_indexIntegerOverall link intelligence score.
data.bot_percentDecimalEstimated bot traffic percentage.
data.is_trendingBooleanIndicates whether the URL is currently trending.

Response Codes

SPRL Code HTTP Status Mode Response Field Description
100 200 success data Request processed successfully.
101 401 failed message Authentication failed. Invalid session, token or credentials.
102 422 failed errors Parameter validation failed. Check the request fields.
103 404 failed message Requested resource was not found.
104 403 failed message Access denied or account restricted.
105 429 failed message Too many requests. Please retry later.
106 500 failed message Unexpected server error. Please try again later.

Error Flag Reference

Category Flag Type Description
Authentication INVALID_SESSION auth_error The supplied token or device identifier is invalid.
Authentication INVALID_CREDENTIALS auth_error Invalid login credentials supplied.
Validation INVALID_PARAMETER validation_error One or more request parameters are invalid.
Resource RESOURCE_NOT_FOUND resource_error The requested URL, folder, domain or resource could not be found.
Account ACCOUNT_RESTRICTED account_error The account is restricted or access has been denied.
Rate Limit RATE_LIMIT_EXCEEDED rate_limit_exceeded The request rate limit has been exceeded.
Server UNEXPECTED_ERROR server_error An unexpected internal server error occurred.

Notes:

  • The requested URL must belong to the authenticated SPRL account.
  • Analytics data may take a short time to update after new click activity.
  • Some advanced metrics are available only for authenticated users.
  • The same X-Device-ID used during login must be supplied.
  • Authentication is required for all requests to this endpoint.
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