Location Analytics

const fetch = require('node-fetch');

const shortUrlId = '550e8400-e29b-41d4-a716-446655440000';
const response = await fetch(
  `https://jmpy.me/api/v1/analytics/geographic/${shortUrlId}`,
  {
    headers: { 'Authorization': 'Bearer YOUR_API_KEY' }
  }
);
const data = await response.json();

// Display top countries
console.log('Top Countries:');
data.data.data.slice(0, 5).forEach(loc => {
  console.log(`  ${loc.country}: ${loc.clicks} clicks (${loc.percentage}%)`);
});

import axios from 'axios';

interface LocationData {
  country: string;
  country_code: string;
  region: string;
  city: string;
  clicks: number;
  percentage: number;
}

interface LocationAnalyticsResponse {
  data: LocationData[];
  total_locations: number;
}

const shortUrlId = '550e8400-e29b-41d4-a716-446655440000';
const response = await axios.get<{ success: boolean; data: LocationAnalyticsResponse }>(
  `https://jmpy.me/api/v1/analytics/geographic/${shortUrlId}`,
  {
    headers: { 'Authorization': 'Bearer YOUR_API_KEY' }
  }
);

// Group by country
const byCountry = response.data.data.data.reduce((acc, loc) => {
  acc[loc.country] = (acc[loc.country] || 0) + loc.clicks;
  return acc;
}, {} as Record<string, number>);

import requests

short_url_id = '550e8400-e29b-41d4-a716-446655440000'

response = requests.get(
    f'https://jmpy.me/api/v1/analytics/geographic/{short_url_id}',
    headers={'Authorization': 'Bearer YOUR_API_KEY'}
)

data = response.json()['data']
locations = data['data']

print(f"Total unique locations: {data['total_locations']}")
print("\nTop 5 Countries:")

# Aggregate by country
countries = {}
for loc in locations:
    country = loc['country']
    countries[country] = countries.get(country, 0) + loc['clicks']

for country, clicks in sorted(countries.items(), key=lambda x: -x[1])[:5]:
    print(f"  {country}: {clicks} clicks")

<?php
$client = new GuzzleHttp\Client();
$shortUrlId = '550e8400-e29b-41d4-a716-446655440000';

$response = $client->request('GET', 
    "https://jmpy.me/api/v1/analytics/geographic/{$shortUrlId}", [
    'headers' => [
        'Authorization' => 'Bearer YOUR_API_KEY'
    ]
]);

$data = json_decode($response->getBody(), true);
$locations = $data['data']['data'];

echo "Top Locations:\n";
foreach (array_slice($locations, 0, 10) as $loc) {
    echo "  {$loc['country']}, {$loc['city']}: {$loc['clicks']} clicks\n";
}
?>

package main

import (
    "fmt"
    "net/http"
    "io"
)

func main() {
    shortUrlId := "550e8400-e29b-41d4-a716-446655440000"
    url := fmt.Sprintf(
        "https://jmpy.me/api/v1/analytics/geographic/%s",
        shortUrlId,
    )

    req, _ := http.NewRequest("GET", url, 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;

String shortUrlId = "550e8400-e29b-41d4-a716-446655440000";
String url = String.format(
    "https://jmpy.me/api/v1/analytics/geographic/%s",
    shortUrlId
);

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create(url))
    .header("Authorization", "Bearer YOUR_API_KEY")
    .GET()
    .build();

HttpResponse<String> response = client.send(request, 
    HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

{
  "success": false,
  "error": {
    "code": "FEATURE_DISABLED",
    "message": "Geographic analytics is not available on your current plan",
    "details": {
      "feature": "Geographic analytics",
      "currentPlan": "Free",
      "upgradeRequired": true
    }
  }
}

{
  "success": false,
  "error": {
    "code": "NOT_FOUND",
    "message": "Short URL not found",
    "details": "No short URL found with code or alias: invalid-code"
  }
}