Carburanți

Plafonul și rețelele

GET/v1/fuel

Plafonul ANRE, prețul fiecărei rețele, cea mai ieftină rețea pe combustibil și intervalul de preț.

Credite: 1
: Cu cheie

Parametri

Fără parametri.

Erori posibile

curl "https://api.satelit.md/v1/fuel" \
  -H "Authorization: Bearer $SATELIT_KEY"

const res = await fetch("https://api.satelit.md/v1/fuel", {
  headers: { Authorization: `Bearer ${process.env.SATELIT_KEY}` },
});
const { data, meta } = await res.json();
console.log(data, meta.credits);

import json, os, urllib.request

req = urllib.request.Request(
    "https://api.satelit.md/v1/fuel",
    headers={"Authorization": f"Bearer {os.environ['SATELIT_KEY']}"},
)
with urllib.request.urlopen(req) as res:
    body = json.load(res)
print(body["data"], body["meta"]["credits"])

<?php
$ch = curl_init("https://api.satelit.md/v1/fuel");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ["Authorization: Bearer " . getenv("SATELIT_KEY")],
]);
$body = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($body["data"]);

Răspuns

{
  "data": {
    "date": "2026-11-02",
    "cap": {
      "a95": 31.4,
      "diesel": 36.28
    },
    "networks": [
      {
        "key": "gloria-qvarc",
        "name": "Gloria-Qvarc",
        "url": null,
        "stations": 8,
        "date": "2026-11-02",
        "stale": false,
        "prices": {
          "a95": 31.36,
          "diesel": 36.05,
          "lpg": 17.5
        }
      },
      {
        "key": "primoil",
        "name": "PrimOil",
        "url": null,
        "stations": 6,
        "date": "2026-11-02",
        "stale": false,
        "prices": {
          "a95": 31.41,
          "diesel": 36.16,
          "lpg": 17.25
        }
      }
    ],
    "cheapest": {
      "a95": "gloria-qvarc",
      "diesel": "tlx",
      "lpg": "tlx"
    },
    "range": {
      "a95": {
        "min": 31.36,
        "max": 31.51,
        "networks": 19
      },
      "diesel": {
        "min": 35.89,
        "max": 36.16,
        "networks": 19
      },
      "lpg": {
        "min": 16.9,
        "max": 17.9,
        "networks": 16
      }
    }
  },
  "meta": {
    "credits": 1,
    "updated_at": "2026-11-02T13:05:00+02:00",
    "sources": [
      {
        "name": "ANRE",
        "url": "https://anre.md",
        "license": "Public data of ANRE"
      }
    ],
    "attribution": "Date: Satelit (satelit.md)"
  }
}

Stațiile

GET/v1/fuel/stations

Fiecare stație, cu adresă, raion, coordonate și prețuri. Costă 5 credite pe pagina de 100 de rânduri.

Credite: 5 pentru fiecare 100 rânduri
: Cu cheie

Parametri

networkstringopțional

Cheia rețelei, de exemplu lukoil.
raionstringopțional

Raionul, de exemplu Orhei.
pageintegeropționalimplicit 1

Pagina, de la 1.

Erori posibile

Încearcă

curl "https://api.satelit.md/v1/fuel/stations?network=lukoil&page=1" \
  -H "Authorization: Bearer $SATELIT_KEY"

const res = await fetch("https://api.satelit.md/v1/fuel/stations?network=lukoil&page=1", {
  headers: { Authorization: `Bearer ${process.env.SATELIT_KEY}` },
});
const { data, meta } = await res.json();
console.log(data, meta.credits);

import json, os, urllib.request

req = urllib.request.Request(
    "https://api.satelit.md/v1/fuel/stations?network=lukoil&page=1",
    headers={"Authorization": f"Bearer {os.environ['SATELIT_KEY']}"},
)
with urllib.request.urlopen(req) as res:
    body = json.load(res)
print(body["data"], body["meta"]["credits"])

<?php
$ch = curl_init("https://api.satelit.md/v1/fuel/stations?network=lukoil&page=1");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ["Authorization: Bearer " . getenv("SATELIT_KEY")],
]);
$body = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($body["data"]);

Răspuns

{
  "data": [
    {
      "id": "st_1",
      "network": "fox-petrol",
      "name": "PECO 04",
      "address": "șos. Chișinău-Tighina, Anenii Noi",
      "raion": "Anenii Noi",
      "lat": 46.884792,
      "lon": 29.236294,
      "date": "2026-11-02",
      "prices": {
        "a95": 31.48,
        "diesel": 36.13,
        "lpg": 17.42
      }
    },
    {
      "id": "st_2",
      "network": "lukoil",
      "name": "PECO 024",
      "address": "str. Chișinăului 84/1, Anenii Noi",
      "raion": "Anenii Noi",
      "lat": 46.889278,
      "lon": 29.202943,
      "date": "2026-11-02",
      "prices": {
        "a95": 31.51,
        "diesel": 36.16,
        "lpg": 17.9
      }
    }
  ],
  "meta": {
    "credits": 5,
    "updated_at": "2026-11-02T13:05:00+02:00",
    "sources": [
      {
        "name": "ANRE",
        "url": "https://anre.md",
        "license": "Public data of ANRE"
      }
    ],
    "attribution": "Date: Satelit (satelit.md)",
    "page": {
      "page": 1,
      "per": 100,
      "total": 586,
      "pages": 6
    }
  }
}

Istoricul prețului

GET/v1/fuel/history

Prețul zilnic al unui combustibil, pentru o rețea sau pentru plafon. Costă 2 credite pentru fiecare 30 de zile începute.

Credite: 2 pentru fiecare 30 zile începute
: Cu cheie

Parametri

fuelstring: a95, diesel, lpgobligatoriu

Combustibilul: a95, diesel sau lpg.
networkstringopțional

Cheia rețelei, de exemplu lukoil.
daysintegeropționalimplicit 30

Câte zile în urmă. Tăiat la limita planului.

Erori posibile

Încearcă

curl "https://api.satelit.md/v1/fuel/history?fuel=a95&network=lukoil&days=30" \
  -H "Authorization: Bearer $SATELIT_KEY"

const res = await fetch("https://api.satelit.md/v1/fuel/history?fuel=a95&network=lukoil&days=30", {
  headers: { Authorization: `Bearer ${process.env.SATELIT_KEY}` },
});
const { data, meta } = await res.json();
console.log(data, meta.credits);

import json, os, urllib.request

req = urllib.request.Request(
    "https://api.satelit.md/v1/fuel/history?fuel=a95&network=lukoil&days=30",
    headers={"Authorization": f"Bearer {os.environ['SATELIT_KEY']}"},
)
with urllib.request.urlopen(req) as res:
    body = json.load(res)
print(body["data"], body["meta"]["credits"])

<?php
$ch = curl_init("https://api.satelit.md/v1/fuel/history?fuel=a95&network=lukoil&days=30");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ["Authorization: Bearer " . getenv("SATELIT_KEY")],
]);
$body = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($body["data"]);

Răspuns

{
  "data": {
    "fuel": "a95",
    "network": "lukoil",
    "points": [
      {
        "date": "2026-11-01",
        "value": 31.51
      },
      {
        "date": "2026-11-02",
        "value": 31.51
      },
      {
        "date": "2026-11-03",
        "value": 31.51
      }
    ]
  },
  "meta": {
    "credits": 2,
    "updated_at": "2026-11-02T13:05:00+02:00",
    "sources": [
      {
        "name": "ANRE",
        "url": "https://anre.md",
        "license": "Public data of ANRE"
      }
    ],
    "attribution": "Date: Satelit (satelit.md)"
  }
}