Shops and places

GET/v1/places

Rows from OpenStreetMap, with filters and search around a point. Costs 2 credits per 100 rows.

Credits: 2 for every 100 rows
: With a key

Parameters

kindstring: shop, venueoptional

shop or venue.
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

curl "https://api.satelit.md/v1/places?kind=shop&near=47.0225%2C28.8353&radius=1000" \
  -H "Authorization: Bearer $SATELIT_KEY"

const res = await fetch("https://api.satelit.md/v1/places?kind=shop&near=47.0225%2C28.8353&radius=1000", {
  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?kind=shop&near=47.0225%2C28.8353&radius=1000",
    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?kind=shop&near=47.0225%2C28.8353&radius=1000");
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": "n293219605",
      "kind": "shop",
      "name": "Nr 1",
      "chain": null,
      "category": "supermarket",
      "address": "Bulevardul Ștefan cel Mare și Sfânt 132",
      "lat": 47.02257,
      "lon": 28.83587,
      "city": "Chișinău",
      "phone": null,
      "website": null,
      "opening_hours": null,
      "updated_at": "2026-10-31"
    }
  ],
  "meta": {
    "credits": 2,
    "updated_at": "2026-11-02T13:05:00+02:00",
    "sources": [
      {
        "name": "OpenStreetMap",
        "url": "https://www.openstreetmap.org/copyright",
        "license": "ODbL 1.0, © OpenStreetMap contributors",
        "download": "https://api.satelit.md/downloads/places-osm.ndjson.gz"
      }
    ],
    "attribution": "Date: Satelit (satelit.md). © OpenStreetMap contributors, ODbL",
    "page": {
      "page": 1,
      "per": 100,
      "total": 7651,
      "pages": 77
    }
  }
}