Huntly Developer API Reference

X-Huntly-Key: hnt_sbx_9a8b7c6d5e4f3a2b1c0d

curl -X GET "https://www.gethuntly.eu/api/v1/fuel/nearby?lat=41.9028&lng=12.4964&radius_km=5&fuel_type=diesel" \
  -H "X-Huntly-Key: YOUR_API_KEY"

import requests

url = "https://www.gethuntly.eu/api/v1/fuel/nearby"
params = {
    "lat": 41.9028,
    "lng": 12.4964,
    "radius_km": 5,
    "fuel_type": "diesel"
}
headers = {
    "X-Huntly-Key": "YOUR_API_KEY"
}

response = requests.get(url, params=params, headers=headers)
data = response.json()
print(f"Stazioni trovate: {len(data['data'])}")

const params = new URLSearchParams({
  lat: '41.9028',
  lng: '12.4964',
  radius_km: '5',
  fuel_type: 'diesel'
});

const res = await fetch(`https://www.gethuntly.eu/api/v1/fuel/nearby?${params}`, {
  headers: {
    'X-Huntly-Key': 'YOUR_API_KEY'
  }
});

const data = await res.json();
console.log(data);

import 'package:http/http.dart' as http;
import 'dart:convert';

Future<void> fetchNearbyFuel() async {
  final uri = Uri.parse('https://www.gethuntly.eu/api/v1/fuel/nearby?lat=41.9028&lng=12.4964&radius_km=5&fuel_type=diesel');
  final response = await http.get(
    uri,
    headers: {'X-Huntly-Key': 'YOUR_API_KEY'},
  );

  if (response.statusCode == 200) {
    final Map<String, dynamic> json = jsonDecode(response.body);
    print('Trovate ${json['data'].length} stazioni');
  }
}

{
  "status": "success",
  "meta": {
    "query": {
      "latitude": 41.9028,
      "longitude": 12.4964,
      "radius_km": 5,
      "fuel_type": "diesel",
      "limit": 20
    },
    "results_count": 1,
    "tier": "sandbox",
    "quota_remaining": 492,
    "timestamp": "2026-10-10T12:00:00.000Z"
  },
  "data": [
    {
      "id": "shop_01j7h8k...",
      "name": "Eni Station Roma Termini",
      "brand": "Eni",
      "address": "Via Giovanni Giolitti 40",
      "city": "Roma",
      "country": "IT",
      "coordinates": {
        "latitude": 41.8982,
        "longitude": 12.5034
      },
      "distance_km": 0.78,
      "fuel": {
        "type": "diesel",
        "price": 1.639,
        "service_type": "self",
        "last_updated": "2026-10-10T06:15:00.000Z"
      }
    }
  ]
}

{
  "status": "ok",
  "service": "Huntly European Fuel & Retail B2B API",
  "version": "v1.0.0",
  "timestamp": "2026-10-10T12:00:00.000Z",
  "coverage": {
    "countries": ["IT", "FR", "ES", "DE", "PT", "NL", "BE", "CA-QC"],
    "stations_monitored": "80,000+"
  }
}