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
Predefined date range: last_hour, last_24_hours, last_7_days, last_30_days, last_year, all_time, custom.
Start date for custom range (ISO 8601).
End date for custom range (ISO 8601).
Filter by URL type: all, standard, branded, subdomain.
Filter by Campaign UUID or name.
Comma-separated list of tags to filter by.
Response
Whether the request was successful.
Social media platform name (e.g., “Facebook”, “Twitter”, “WhatsApp”).
Total number of shares on this platform.
Percentage of total shares.
Request Examples
cURL
Node.js
TypeScript
Python
PHP
Go
Java
curl -X GET "https://jmpy.me/api/v1/analytics/user-shares?dateRange=last_30_days" \
-H "Authorization: Bearer YOUR_API_KEY"
const fetch = require ( 'node-fetch' );
const response = await fetch (
'https://jmpy.me/api/v1/analytics/user-shares?dateRange=last_30_days' ,
{
headers: { 'Authorization' : 'Bearer YOUR_API_KEY' }
}
);
const { data } = await response . json ();
console . log ( 'Social Shares:' , data );
import axios from 'axios' ;
interface SharePoint {
platform : string ;
count : number ;
percentage : number ;
}
const response = await axios . get <{ success : boolean ; data : SharePoint [] }>(
'https://jmpy.me/api/v1/analytics/user-shares' ,
{
headers: { 'Authorization' : 'Bearer YOUR_API_KEY' },
params: { dateRange: 'last_30_days' , urlType: 'branded' }
}
);
console . log ( response . data . data );
import requests
response = requests.get(
'https://jmpy.me/api/v1/analytics/user-shares' ,
headers = { 'Authorization' : 'Bearer YOUR_API_KEY' },
params = { 'dateRange' : 'last_30_days' }
)
shares = response.json()[ 'data' ]
for platform in shares:
print ( f " { platform[ 'platform' ] } : { platform[ 'count' ] } shares ( { platform[ 'percentage' ] } %)" )
<? php
$client = new GuzzleHttp\ Client ();
$response = $client -> request ( 'GET' , 'https://jmpy.me/api/v1/analytics/user-shares' , [
'headers' => [ 'Authorization' => 'Bearer YOUR_API_KEY' ],
'query' => [ 'dateRange' => 'last_30_days' ]
]);
$data = json_decode ( $response -> getBody (), true );
print_r ( $data [ 'data' ]);
?>
package main
import (
" fmt "
" net/http "
" io "
)
func main () {
req , _ := http . NewRequest ( "GET" , "https://jmpy.me/api/v1/analytics/user-shares?dateRange=last_30_days" , nil )
req . Header . Add ( "Authorization" , "Bearer YOUR_API_KEY" )
resp , _ := http . DefaultClient . Do ( req )
defer resp . Body . Close ()
body , _ := io . ReadAll ( resp . Body )
fmt . Println ( string ( body ))
}
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.URI;
import java.net.http.HttpResponse;
HttpClient client = HttpClient . newHttpClient ();
HttpRequest request = HttpRequest . newBuilder ()
. uri ( URI . create ( "https://jmpy.me/api/v1/analytics/user-shares?dateRange=last_30_days" ))
. header ( "Authorization" , "Bearer YOUR_API_KEY" )
. build ();
HttpResponse < String > response = client . send (request, HttpResponse . BodyHandlers . ofString ());
System . out . println ( response . body ());
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.
Measure influencer impact
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.
Optimize social media presence
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.