Traffic Quality

curl --request GET \
  --url https://jmpy.me/api/v1/analytics/traffic-quality/{shortUrlId} \
  --header 'Authorization: Bearer <token>'

{
  "human_clicks": 123,
  "bot_clicks": 123,
  "bot_percentage": 123,
  "suspicious_clicks": 123,
  "traffic_health": "<string>"
}

GET

analytics

traffic-quality

{shortUrlId}

Traffic Quality

curl --request GET \
  --url https://jmpy.me/api/v1/analytics/traffic-quality/{shortUrlId} \
  --header 'Authorization: Bearer <token>'

{
  "human_clicks": 123,
  "bot_clicks": 123,
  "bot_percentage": 123,
  "suspicious_clicks": 123,
  "traffic_health": "<string>"
}

Get insights into the quality of traffic visiting your short URL, including bot detection and traffic behavior analysis.

Parameters

shortUrlId

string

required

The unique ID or short code of the URL.

Request Examples

cURL
Node.js
Python

curl -X GET "https://jmpy.me/api/v1/analytics/traffic-quality/google-redirect" \
  -H "Authorization: Bearer YOUR_API_KEY"

const response = await fetch('https://jmpy.me/api/v1/analytics/traffic-quality/google-redirect', {
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY'
  }
});
const data = await response.json();
console.log(data);

import requests

headers = {
    'Authorization': 'Bearer YOUR_API_KEY'
}
response = requests.get('https://jmpy.me/api/v1/analytics/traffic-quality/google-redirect', headers=headers)
print(response.json())

Response Examples

200 OK

{
  "human_clicks": 1450,
  "bot_clicks": 50,
  "bot_percentage": 3.33,
  "suspicious_clicks": 0,
  "traffic_health": "good"
}

Response Fields

human_clicks

number

Count of clicks identified as real human users.

bot_clicks

number

Count of clicks identified as automated bots, crawlers, or scrapers.

bot_percentage

number

Percentage of total traffic identified as bots.

suspicious_clicks

number

Count of clicks flagged as suspicious or potentially fraudulent.

traffic_health

string

Overall assessment of traffic quality (good, fair, poor).

Use Cases

Ad Fraud Detection

Monitor bot_percentage and suspicious_clicks to ensure you are not paying for fraudulent traffic in your paid campaigns.

Filtering Analytics

Use these metrics to understand the true reach of your content by focusing on human_clicks rather than raw total clicks.

Core Metrics

View general engagement stats

Device Analytics

See device and browser breakdown

Recent Activity QR Analytics Overview

​Parameters

​Request Examples

​Response Examples

​Response Fields

​Use Cases

​Related Endpoints

Core Metrics

Device Analytics

Parameters

Request Examples

Response Examples

Response Fields

Use Cases

Related Endpoints