GET
/
analytics
/
user-shares
Social Share Analytics
curl --request GET \
  --url https://jmpy.me/api/v1/analytics/user-shares \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "data": [
    {
      "platform": "<string>",
      "count": 123,
      "percentage": 123
    }
  ]
}
Analyze which social platforms are driving the most engagement for your links. This endpoint provides a breakdown of shares across platforms like Facebook, Twitter, WhatsApp, LinkedIn, and more.

Query Parameters

dateRange
string
default:"all_time"
Predefined date range: last_hour, last_24_hours, last_7_days, last_30_days, last_year, all_time, custom.
startDate
string
Start date for custom range (ISO 8601).
endDate
string
End date for custom range (ISO 8601).
urlType
string
default:"all"
Filter by URL type: all, standard, branded, subdomain.
campaignId
string
Filter by Campaign UUID or name.
tags
string
Comma-separated list of tags to filter by.

Response

success
boolean
Whether the request was successful.
data
array

Request Examples

curl -X GET "https://jmpy.me/api/v1/analytics/user-shares?dateRange=last_30_days" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response Example

{
  "success": true,
  "data": [
    { "platform": "Facebook", "count": 450, "percentage": 40.5 },
    { "platform": "Twitter", "count": 320, "percentage": 28.8 },
    { "platform": "WhatsApp", "count": 210, "percentage": 18.9 },
    { "platform": "LinkedIn", "count": 130, "percentage": 11.8 }
  ]
}

Use Cases

Discover which social platforms are organically sharing your links the most. Allocate more marketing resources or tailor content specifically for those high-performing social channels to maximize reach.
Track social shares across different campaigns and tags to measure the effectiveness of influencer partnerships. See exactly where their audience is engaging with your links.
By knowing the percentage of shares from each platform, you can fine-tune your social media presence, ensuring you are active and engaging where your audience is already sharing your content.