EN

Theme

Accent colour

Your theme and colour carry over to satelit.md and the app.

Dashboard Choose a plan

Chains' lists

GET/v1/places?source=chains

Shops the chains publish on their own sites. 2 credits per 100 rows. Not in the free OpenStreetMap copy.

Credits
2 for every 100 rows
With a key

Parameters

  • citystringoptional

    The city.

  • chainstringoptional

    The shop chain.

  • categorystringoptional

    The category key, from /v1/news/categories.

  • nearstringoptional

    A point: lat,lon.

  • radiusintegeroptionaldefault 2000

    The radius in meters, at most 20000.

  • pageintegeroptionaldefault 1

    The page, starting at 1.

Possible errors

Try it

curl "https://api.satelit.md/v1/places?source=chains&city=chisinau" \
  -H "Authorization: Bearer $SATELIT_KEY"
const res = await fetch("https://api.satelit.md/v1/places?source=chains&city=chisinau", {
  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/places?source=chains&city=chisinau",
    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/places?source=chains&city=chisinau");
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"]);
Response
{
  "data": [
    {
      "id": "off:agroteh:dd3088f2",
      "kind": "shop",
      "name": "agroteh",
      "chain": "agroteh",
      "category": "other",
      "city": "chisinau",
      "address": "str. Lisabona 2/2",
      "lat": 47.033186,
      "lon": 28.805361,
      "updated_at": "2026-11-02"
    }
  ],
  "meta": {
    "credits": 2,
    "updated_at": "2026-11-02T13:05:00+02:00",
    "sources": [
      {
        "name": "the chains' own pages",
        "license": "none: read from the source's public pages; no agreement with the source and no licence over its data is granted"
      }
    ],
    "attribution": "Date: Satelit (satelit.md)",
    "page": {
      "page": 1,
      "per": 100,
      "total": 2745,
      "pages": 28
    }
  }
}