Developer

Language: English
Appearance

Theme

Accent colour

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

Sign in

Pages

Language

Theme

Where should the theme change?

Choose where the new theme applies.

You can change it any time from the header.

News events

News events with reaction

GET/v1/news/events

What Moldova's outlets and public pages reported, grouped per event, newest first. Unless `all=true`, only events about Moldova that are not advertising and not a bulletin of unrelated stories. `reaction` is what commenters wrote. Past the plan's history, `from` is cut to it. Costs 2 credits.

Credits
2 for every 20 rows
With a key

Parameters

  • categorystringoptional

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

  • regionstring: global, chisinau, balti, nord, centru, sud, gagauzia, transnistria, diasporaoptional

    The district.

  • slotstring: morning, noon, eveningoptional

    Only events of this time of day.

  • min_gravityintegeroptional

    The minimum gravity, from 0 to 100.

  • social_onlybooleanoptional

    True: only events known from public pages alone. False: only events an outlet reported too.

  • sentimentstring: negative, mixed, positiveoptional

    Only events whose `reaction.label` is this. An event with too few comments for a label matches none.

  • fromstringoptional

    From this date, YYYY-MM-DD.

  • tostringoptional

    Up to this date, YYYY-MM-DD.

  • allbooleanoptional

    Also events that are not about Moldova, advertising or bulletins.

  • pageintegeroptionaldefault 1

    The page, starting at 1.

  • perintegeroptionaldefault 20

    Rows per page, at most 20.

Possible errors

Try it

curl "https://api.satelit.md/v1/news/events" \
  -H "Authorization: Bearer $SATELIT_KEY"
const res = await fetch("https://api.satelit.md/v1/news/events", {
  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/news/events",
    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/news/events");
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": "e_7d20c4f19ab35e6810cd",
      "title": "Gas tariff goes before the regulator",
      "lang": "ro",
      "category": {
        "key": "economy",
        "label": "Economy & prices"
      },
      "gravity": 62,
      "band": "high",
      "region": {
        "key": "global",
        "label": "Nationwide"
      },
      "regions": [
        "global"
      ],
      "slot": {
        "key": "noon",
        "label": "Midday"
      },
      "due_at": "2026-11-02T13:05:00+02:00",
      "first_at": "2026-11-02T13:05:00+02:00",
      "last_at": "2026-11-02T13:05:00+02:00",
      "reports": 6,
      "outlets": 4,
      "social_only": false,
      "reaction": {
        "score": -0.42,
        "label": "negative",
        "comments": 64
      }
    }
  ],
  "meta": {
    "credits": 2,
    "updated_at": "2026-11-02T13:05:00+02:00",
    "sources": [
      {
        "name": "Satelit",
        "url": "https://satelit.md",
        "license": "Satelit"
      }
    ],
    "attribution": "Date: Satelit (satelit.md)",
    "page": {
      "page": 1,
      "per": 20,
      "total": 240,
      "pages": 12
    }
  }
}

One news event

GET/v1/news/events/{id}

The card, its reports as links, and the whole reaction. A report's `likes`, `dislikes`, `shares` and `views` are a post's, null for a web page and for a post whose numbers we cannot vouch for as people's. No report's text is here. On a plan without `social` in `/plans` (Start, Creator) the sources stay, `reaction` is the card's, and `meta.fields_cut` says so. An event older than the plan's history answers 402. Costs 1 credit.

Credits
1
With a key

Parameters

  • idstringrequired

    The row identifier.

Possible errors

Try it

curl "https://api.satelit.md/v1/news/events/{id}" \
  -H "Authorization: Bearer $SATELIT_KEY"
const res = await fetch("https://api.satelit.md/v1/news/events/{id}", {
  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/news/events/{id}",
    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/news/events/{id}");
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": "e_7d20c4f19ab35e6810cd",
    "title": "Gas tariff goes before the regulator",
    "lang": "ro",
    "category": {
      "key": "economy",
      "label": "Economy & prices"
    },
    "gravity": 62,
    "band": "high",
    "region": {
      "key": "global",
      "label": "Nationwide"
    },
    "regions": [
      "global"
    ],
    "slot": {
      "key": "noon",
      "label": "Midday"
    },
    "due_at": "2026-11-02T13:05:00+02:00",
    "first_at": "2026-11-02T13:05:00+02:00",
    "last_at": "2026-11-02T13:05:00+02:00",
    "reports": 6,
    "outlets": 4,
    "social_only": false,
    "reaction": {
      "comments": 64,
      "authors": 51,
      "judged": 58,
      "positive": 0.14,
      "neutral": 0.3,
      "negative": 0.56,
      "score": -0.42,
      "label": "negative",
      "disputed": 0.08,
      "toxic": 0.11,
      "flagged_ai": 3,
      "updated_at": "2026-11-02T13:05:00+02:00",
      "platforms": {
        "facebook": {
          "posts": 2,
          "comments": 40,
          "likes": 310,
          "dislikes": 12,
          "shares": 44,
          "views": 9100
        },
        "point": {
          "posts": 0,
          "comments": 24,
          "likes": 0,
          "dislikes": 0,
          "shares": 0,
          "views": 0
        }
      }
    },
    "sources": [
      {
        "name": "Example Outlet",
        "url": "https://outlet.example/story",
        "channel": "web",
        "voice": "outlet",
        "published_at": "2026-11-02T13:05:00+02:00",
        "likes": null,
        "dislikes": null,
        "shares": null,
        "views": null
      },
      {
        "name": "Example Page",
        "url": "https://www.facebook.com/examplepage/posts/1",
        "channel": "facebook",
        "voice": "official",
        "published_at": "2026-11-02T13:05:00+02:00",
        "likes": 310,
        "dislikes": 12,
        "shares": 44,
        "views": 9100
      }
    ]
  },
  "meta": {
    "credits": 1,
    "updated_at": "2026-11-02T13:05:00+02:00",
    "sources": [
      {
        "name": "Satelit",
        "url": "https://satelit.md",
        "license": "Satelit"
      },
      {
        "name": "Public pages on social networks",
        "url": null,
        "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)"
  }
}

Comments on a news event

GET/v1/news/events/{id}/comments

What readers wrote under the event's reports, with no author. Comments that look machine-written and comments whose text is past its 90 days stay out. On a plan with `social` in `/plans` (Pro and above); otherwise 402, with nothing charged. Costs 3 credits.

Credits
3 for every 20 rows
With a key

Parameters

  • idstringrequired

    The row identifier.

  • sortstring: top, new, negative, positiveoptionaldefault top

    price or date.

  • platformstring: facebook, tiktok, youtube, telegram, point, stirioptional

    Only comments of this platform.

  • min_likesintegeroptional

    Only comments with at least this many likes.

  • no_toxicbooleanoptional

    Only comments judged not to insult or threaten.

  • pageintegeroptionaldefault 1

    The page, starting at 1.

  • perintegeroptionaldefault 20

    Rows per page, at most 20.

Possible errors

Try it

curl "https://api.satelit.md/v1/news/events/{id}/comments" \
  -H "Authorization: Bearer $SATELIT_KEY"
const res = await fetch("https://api.satelit.md/v1/news/events/{id}/comments", {
  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/news/events/{id}/comments",
    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/news/events/{id}/comments");
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": "c_4be1a07f92d3c618",
      "text": "The price goes up again before winter.",
      "platform": "point",
      "likes": 18,
      "dislikes": 2,
      "sentiment": "negative",
      "toxic": 0.04,
      "disputes": 0.02,
      "is_reply": false,
      "posted_at": "2026-11-02T13:05:00+02:00",
      "url": null
    }
  ],
  "meta": {
    "credits": 3,
    "updated_at": "2026-11-02T13:05:00+02:00",
    "sources": [
      {
        "name": "Satelit",
        "url": "https://satelit.md",
        "license": "Satelit"
      },
      {
        "name": "Point.md and Stiri.md readers' comments",
        "url": null,
        "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": 20,
      "total": 240,
      "pages": 12
    }
  }
}