GET
/
analytics
/
distribution
Engagement Distribution
curl --request GET \
  --url https://jmpy.me/api/v1/analytics/distribution \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "data": [
    {
      "label": "<string>",
      "clicks": 123,
      "scans": 123
    }
  ]
}
Identify your peak performance times. This endpoint provides data on when your links are most active, helping you optimize your posting schedule.

Query Parameters

type
string
required
Distribution type: hourly or weekly.
dateRange
string
default:"all_time"
Predefined date range: last_hour, last_24_hours, last_7_days, last_30_days, last_year, all_time, custom.
urlType
string
default:"all"
Filter by URL type: all, standard, branded, subdomain.
campaignId
string
Filter by Campaign UUID or name.

Response

success
boolean
Whether the request was successful.
data
array

Request Examples

# Get hourly distribution for last 7 days
curl -X GET "https://jmpy.me/api/v1/analytics/distribution?type=hourly&dateRange=last_7_days" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response Example (Hourly)

{
  "success": true,
  "data": [
    { "label": "0", "clicks": 120, "scans": 15 },
    { "label": "1", "clicks": 85, "scans": 10 },
    { "label": "12", "clicks": 450, "scans": 55 },
    { "label": "18", "clicks": 620, "scans": 80 }
  ]
}

Use Cases

Identify the exact hours when your audience is most active. Use this data to schedule your social media posts or email campaigns right before peak engagement periods.
Switch to weekly distribution to see if your links perform better on weekends or specific workdays, allowing you to tailor your content strategy accordingly.
Combine with location filters to understand when specific regions (e.g., US vs Europe) are interacting with your links, helping you manage global campaigns.