Location Analytics

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

const response = await fetch(
  'https://jmpy.me/api/v1/qranalytics/locations?days=30',
  {
    headers: { 'Authorization': 'Bearer YOUR_API_KEY' }
  }
);
const data = await response.json();

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

// Display city breakdown
console.log('\nTop Cities:');
data.data.cities.slice(0, 5).forEach(city => {
  console.log(`  ${city.city}, ${city.country}: ${city.scans} scans`);
});

import axios from 'axios';

interface LocationAnalytics {
  countries: Array<{ 
    country: string; 
    scans: number; 
    uniqueScanners: number; 
    percentage: number 
  }>;
  cities: Array<{ 
    country: string; 
    city: string; 
    scans: number; 
    uniqueScanners: number 
  }>;
  totalScans: number;
}

const response = await axios.get<{ success: boolean; data: LocationAnalytics }>(
  'https://jmpy.me/api/v1/qranalytics/locations',
  {
    headers: { 'Authorization': 'Bearer YOUR_API_KEY' },
    params: { days: 30 }
  }
);

const { countries, cities, totalScans } = response.data.data;
console.log(`Total scans: ${totalScans}`);
console.log(`Top country: ${countries[0]?.country}`);
console.log(`Top city: ${cities[0]?.city}`);

import requests

response = requests.get(
    'https://jmpy.me/api/v1/qranalytics/locations',
    headers={'Authorization': 'Bearer YOUR_API_KEY'},
    params={'days': 30}
)

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

print("Country Distribution:")
for country in data['countries'][:5]:
    print(f"  {country['country']}: {country['scans']} ({country['percentage']}%)")

print("\nTop Cities:")
for city in data['cities'][:5]:
    print(f"  {city['city']}, {city['country']}: {city['scans']} scans")

<?php
$client = new GuzzleHttp\Client();

$response = $client->request('GET', 'https://jmpy.me/api/v1/qranalytics/locations', [
    'headers' => [
        'Authorization' => 'Bearer YOUR_API_KEY'
    ],
    'query' => [
        'days' => 30
    ]
]);

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

echo "Top Countries:\n";
foreach (array_slice($data['countries'], 0, 5) as $country) {
    echo "  {$country['country']}: {$country['scans']} ({$country['percentage']}%)\n";
}
?>

package main

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

func main() {
    baseURL := "https://jmpy.me/api/v1/qranalytics/locations"
    params := url.Values{}
    params.Add("days", "30")

    req, _ := http.NewRequest("GET", baseURL+"?"+params.Encode(), 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();

String url = "https://jmpy.me/api/v1/qranalytics/locations?days=30";

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": "UNAUTHORIZED",
    "message": "User authentication required"
  }
}

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