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.
Parameters
-
categorystringoptionalThe category key, from /v1/news/categories.
-
regionstring: global, chisinau, balti, nord, centru, sud, gagauzia, transnistria, diasporaoptionalThe district.
-
slotstring: morning, noon, eveningoptionalOnly events of this time of day.
-
min_gravityintegeroptionalThe minimum gravity, from 0 to 100.
-
social_onlybooleanoptionalTrue: only events known from public pages alone. False: only events an outlet reported too.
-
sentimentstring: negative, mixed, positiveoptionalOnly events whose `reaction.label` is this. An event with too few comments for a label matches none.
-
fromstringoptionalFrom this date, YYYY-MM-DD.
-
tostringoptionalUp to this date, YYYY-MM-DD.
-
allbooleanoptionalAlso events that are not about Moldova, advertising or bulletins.
-
pageintegeroptionaldefault 1The page, starting at 1.
-
perintegeroptionaldefault 20Rows per page, at most 20.
Possible errors
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"]); {
"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.
Parameters
-
idstringrequiredThe row identifier.
Possible errors
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"]); {
"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.
Parameters
-
idstringrequiredThe row identifier.
-
sortstring: top, new, negative, positiveoptionaldefault topprice or date.
-
platformstring: facebook, tiktok, youtube, telegram, point, stirioptionalOnly comments of this platform.
-
min_likesintegeroptionalOnly comments with at least this many likes.
-
no_toxicbooleanoptionalOnly comments judged not to insult or threaten.
-
pageintegeroptionaldefault 1The page, starting at 1.
-
perintegeroptionaldefault 20Rows per page, at most 20.
Possible errors
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"]); {
"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
}
}
}