Films and series
Find films, series and people
GET/v1/movies/search
By name in any language: the title, the original title and the alternative titles, most relevant first, 20 to a page. `kind` keeps one kind. Texts in the request's language when the catalogue has them. Costs 1 credit.
Parameters
-
qstringrequiredWords to search for.
-
kindstring: all, movie, series, personoptionaldefault allWhich kind.
-
yearintegeroptionalA film's year or a series' first year.
-
pageintegeroptionaldefault 1The page, starting at 1.
-
data_langstring: be, bg, cs, en, es, fr, he, it, pl, pt, ro, ru, uk, zhoptionalThe language of the data itself (titles, overviews, genres): be, bg, cs, en, es, fr, he, it, pl, pt, ro, ru, uk or zh. Without it: the request's `lang`.
Possible errors
curl "https://api.satelit.md/v1/movies/search?q=matrix" \
-H "Authorization: Bearer $SATELIT_KEY" const res = await fetch("https://api.satelit.md/v1/movies/search?q=matrix", {
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/movies/search?q=matrix",
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/movies/search?q=matrix");
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": {
"page": 1,
"pages": 7,
"total": 126,
"results": [
{
"id": "m603",
"kind": "movie",
"title": "The Matrix",
"original_title": "The Matrix",
"year": 1999,
"released": "1999-03-31",
"language": "en",
"rating": {
"value": 8.3,
"votes": 29297
},
"overview": "A hacker learns that the world he knows is a simulation and joins the fight against its makers.",
"pictures": {
"poster": {
"s": "https://api.satelit.md/v1/movies/img/s/fvCgaMLmIcGTAGgWfunRHMyMDOW.jpg",
"m": "https://api.satelit.md/v1/movies/img/m/fvCgaMLmIcGTAGgWfunRHMyMDOW.jpg",
"l": "https://api.satelit.md/v1/movies/img/l/fvCgaMLmIcGTAGgWfunRHMyMDOW.jpg"
},
"backdrop": {
"m": "https://api.satelit.md/v1/movies/img/m/tlm8UkiQsitc8rSuIAscQDCnP8d.jpg",
"w": "https://api.satelit.md/v1/movies/img/w/tlm8UkiQsitc8rSuIAscQDCnP8d.jpg"
}
},
"genres": [
"Action",
"Science Fiction"
]
}
]
},
"meta": {
"credits": 1,
"updated_at": "2026-11-02T13:05:00+02:00",
"sources": [
{
"name": "Satelit",
"url": "https://satelit.md",
"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)"
}
}One film or series
GET/v1/movies/titles/{id}
Names, year, length, genres, countries and languages, the community rating, the age rating in Moldova (else Romania, else the US), directors and writers, 15 of the cast with their characters, where it is streamed, rented or sold (Moldova first), trailers, money for a film, seasons for a series, eight like it. Costs 1 credit.
Parameters
-
idstringrequiredThe row identifier.
-
data_langstring: be, bg, cs, en, es, fr, he, it, pl, pt, ro, ru, uk, zhoptionalThe language of the data itself (titles, overviews, genres): be, bg, cs, en, es, fr, he, it, pl, pt, ro, ru, uk or zh. Without it: the request's `lang`.
Possible errors
curl "https://api.satelit.md/v1/movies/titles/m603" \
-H "Authorization: Bearer $SATELIT_KEY" const res = await fetch("https://api.satelit.md/v1/movies/titles/m603", {
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/movies/titles/m603",
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/movies/titles/m603");
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": "m603",
"kind": "movie",
"title": "The Matrix",
"original_title": "The Matrix",
"year": 1999,
"released": "1999-03-31",
"language": "en",
"overview": "A hacker learns that the world he knows is a simulation and joins the fight against its makers.",
"pictures": {
"poster": {
"s": "https://api.satelit.md/v1/movies/img/s/fvCgaMLmIcGTAGgWfunRHMyMDOW.jpg",
"m": "https://api.satelit.md/v1/movies/img/m/fvCgaMLmIcGTAGgWfunRHMyMDOW.jpg",
"l": "https://api.satelit.md/v1/movies/img/l/fvCgaMLmIcGTAGgWfunRHMyMDOW.jpg"
},
"backdrop": {
"m": "https://api.satelit.md/v1/movies/img/m/tlm8UkiQsitc8rSuIAscQDCnP8d.jpg",
"w": "https://api.satelit.md/v1/movies/img/w/tlm8UkiQsitc8rSuIAscQDCnP8d.jpg"
}
},
"genres": [
"Action",
"Science Fiction"
],
"tagline": "Believe the unbelievable.",
"status": "released",
"runtime_min": 136,
"countries": [
"US"
],
"spoken": [
"en"
],
"ratings": {
"community": {
"value": 8.3,
"votes": 29284
}
},
"age_rating": {
"country": "RO",
"rating": "15"
},
"people": {
"directors": [
{
"id": "p9340",
"name": "Lana Wachowski"
},
{
"id": "p9339",
"name": "Lilly Wachowski"
}
],
"writers": [
{
"id": "p9340",
"name": "Lana Wachowski"
}
],
"cast": [
{
"id": "p6384",
"name": "Keanu Reeves",
"character": "Neo",
"pictures": {
"photo": {
"s": "https://api.satelit.md/v1/movies/img/s/8RZLOyYGsoRe9p44q3xin9QkMHv.jpg",
"m": "https://api.satelit.md/v1/movies/img/m/8RZLOyYGsoRe9p44q3xin9QkMHv.jpg",
"l": "https://api.satelit.md/v1/movies/img/l/8RZLOyYGsoRe9p44q3xin9QkMHv.jpg"
}
}
}
]
},
"companies": [
"Warner Bros. Pictures",
"Village Roadshow Pictures"
],
"watch": {
"country": "RO",
"stream": [],
"free": [],
"rent": [
"Amazon Video",
"Rakuten TV"
],
"buy": [
"Amazon Video"
]
},
"trailers": [],
"similar": [],
"attribution": null,
"money": {
"budget_usd": 63000000,
"box_office_usd": 467222728
},
"collection": "The Matrix Collection"
},
"meta": {
"credits": 1,
"updated_at": "2026-11-02T13:05:00+02:00",
"sources": [
{
"name": "Satelit",
"url": "https://satelit.md",
"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)"
}
}A film or series in full
GET/v1/movies/titles/{id}/full
Everything of `/movies/titles/{id}`, plus IMDb, Metacritic, Rotten Tomatoes and Kinopoisk ratings, mood scores from 0 to 10, questions and answers, the soundtrack, topics and keywords, the age rating in every country, whether a scene follows the credits, and recommendations. Costs 3 credits.
Parameters
-
idstringrequiredThe row identifier.
-
data_langstring: be, bg, cs, en, es, fr, he, it, pl, pt, ro, ru, uk, zhoptionalThe language of the data itself (titles, overviews, genres): be, bg, cs, en, es, fr, he, it, pl, pt, ro, ru, uk or zh. Without it: the request's `lang`.
Possible errors
curl "https://api.satelit.md/v1/movies/titles/m603/full" \
-H "Authorization: Bearer $SATELIT_KEY" const res = await fetch("https://api.satelit.md/v1/movies/titles/m603/full", {
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/movies/titles/m603/full",
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/movies/titles/m603/full");
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": "m603",
"kind": "movie",
"title": "The Matrix",
"original_title": "The Matrix",
"year": 1999,
"released": "1999-03-31",
"language": "en",
"overview": "A hacker learns that the world he knows is a simulation and joins the fight against its makers.",
"pictures": {
"poster": {
"s": "https://api.satelit.md/v1/movies/img/s/fvCgaMLmIcGTAGgWfunRHMyMDOW.jpg",
"m": "https://api.satelit.md/v1/movies/img/m/fvCgaMLmIcGTAGgWfunRHMyMDOW.jpg",
"l": "https://api.satelit.md/v1/movies/img/l/fvCgaMLmIcGTAGgWfunRHMyMDOW.jpg"
},
"backdrop": {
"m": "https://api.satelit.md/v1/movies/img/m/tlm8UkiQsitc8rSuIAscQDCnP8d.jpg",
"w": "https://api.satelit.md/v1/movies/img/w/tlm8UkiQsitc8rSuIAscQDCnP8d.jpg"
}
},
"genres": [
"Action",
"Science Fiction"
],
"tagline": "Believe the unbelievable.",
"status": "released",
"runtime_min": 136,
"countries": [
"US"
],
"spoken": [
"en"
],
"ratings": {
"community": {
"value": 8.3,
"votes": 29284
},
"imdb": {
"value": 8.7,
"votes": 2284373
},
"metacritic": {
"value": 73,
"votes": null
},
"rotten_tomatoes": {
"value": 83,
"votes": null
}
},
"age_rating": {
"country": "RO",
"rating": "15"
},
"people": {
"directors": [
{
"id": "p9340",
"name": "Lana Wachowski"
},
{
"id": "p9339",
"name": "Lilly Wachowski"
}
],
"writers": [
{
"id": "p9340",
"name": "Lana Wachowski"
}
],
"cast": [
{
"id": "p6384",
"name": "Keanu Reeves",
"character": "Neo",
"pictures": {
"photo": {
"s": "https://api.satelit.md/v1/movies/img/s/8RZLOyYGsoRe9p44q3xin9QkMHv.jpg",
"m": "https://api.satelit.md/v1/movies/img/m/8RZLOyYGsoRe9p44q3xin9QkMHv.jpg",
"l": "https://api.satelit.md/v1/movies/img/l/8RZLOyYGsoRe9p44q3xin9QkMHv.jpg"
}
}
}
]
},
"companies": [
"Warner Bros. Pictures",
"Village Roadshow Pictures"
],
"watch": {
"country": "RO",
"stream": [],
"free": [],
"rent": [
"Amazon Video",
"Rakuten TV"
],
"buy": [
"Amazon Video"
]
},
"trailers": [],
"similar": [],
"attribution": null,
"money": {
"budget_usd": 63000000,
"box_office_usd": 467222728
},
"collection": "The Matrix Collection",
"moods": {
"action": 3,
"fear": 3.6,
"humor": 0.4,
"pace": 4.7,
"violence": 2.3
},
"questions": [
{
"q": "Who directed The Matrix?",
"a": "Lana Wachowski and Lilly Wachowski."
}
],
"topics": [
"Artificial intelligence",
"Martial arts",
"Cyberpunk"
],
"keywords": [
"simulated reality",
"man vs machine"
],
"age_ratings": {
"DE": "16",
"RO": "15",
"US": "R"
},
"soundtrack": {
"album": "The Matrix: Music From the Motion Picture",
"released": "1999-03-30",
"tracks": [
{
"n": 1,
"title": "Rock Is Dead",
"artist": "Marilyn Manson",
"seconds": 191
}
]
},
"after_credits": null,
"recommended": []
},
"meta": {
"credits": 3,
"updated_at": "2026-11-02T13:05:00+02:00",
"sources": [
{
"name": "Satelit",
"url": "https://satelit.md",
"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)"
}
}A film's sessions
GET/v1/movies/titles/{id}/showtimes
Cinema by cinema in a country (Moldova by default): date, time, formats, language, subtitles, price and the cinema's own booking link without tracking. `countries` lists every country with sessions. Empty while no cinema of that country publishes them. Costs 2 credits.
Parameters
-
idstringrequiredThe row identifier.
-
countrystringoptionaldefault MDThe country, in Romanian: Turcia, Egipt.
Possible errors
curl "https://api.satelit.md/v1/movies/titles/m603/showtimes?country=MD" \
-H "Authorization: Bearer $SATELIT_KEY" const res = await fetch("https://api.satelit.md/v1/movies/titles/m603/showtimes?country=MD", {
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/movies/titles/m603/showtimes?country=MD",
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/movies/titles/m603/showtimes?country=MD");
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": "m603",
"country": "MD",
"cinemas": [],
"countries": []
},
"meta": {
"credits": 2,
"updated_at": "2026-11-02T13:05:00+02:00",
"sources": [
{
"name": "Satelit",
"url": "https://satelit.md",
"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)"
}
}One person
GET/v1/movies/people/{id}
An actor, director or writer: born, died, birthplace, biography, photo, and the 30 best-known titles with the character or the job. Costs 1 credit.
Parameters
-
idstringrequiredThe row identifier.
-
data_langstring: be, bg, cs, en, es, fr, he, it, pl, pt, ro, ru, uk, zhoptionalThe language of the data itself (titles, overviews, genres): be, bg, cs, en, es, fr, he, it, pl, pt, ro, ru, uk or zh. Without it: the request's `lang`.
Possible errors
curl "https://api.satelit.md/v1/movies/people/p6384" \
-H "Authorization: Bearer $SATELIT_KEY" const res = await fetch("https://api.satelit.md/v1/movies/people/p6384", {
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/movies/people/p6384",
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/movies/people/p6384");
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": "p6384",
"kind": "person",
"name": "Keanu Reeves",
"known_for": "Acting",
"born": "1964-09-02",
"died": null,
"birthplace": "Beirut, Lebanon",
"biography": "Keanu Charles Reeves is a Canadian actor.",
"pictures": {
"photo": {
"s": "https://api.satelit.md/v1/movies/img/s/8RZLOyYGsoRe9p44q3xin9QkMHv.jpg",
"m": "https://api.satelit.md/v1/movies/img/m/8RZLOyYGsoRe9p44q3xin9QkMHv.jpg",
"l": "https://api.satelit.md/v1/movies/img/l/8RZLOyYGsoRe9p44q3xin9QkMHv.jpg"
}
},
"work": [
{
"id": "m603",
"kind": "movie",
"title": "The Matrix",
"original_title": "The Matrix",
"year": 1999,
"released": "1999-03-31",
"language": "en",
"rating": {
"value": 8.3,
"votes": 29297
},
"overview": "A hacker learns that the world he knows is a simulation and joins the fight against its makers.",
"pictures": {
"poster": {
"s": "https://api.satelit.md/v1/movies/img/s/fvCgaMLmIcGTAGgWfunRHMyMDOW.jpg",
"m": "https://api.satelit.md/v1/movies/img/m/fvCgaMLmIcGTAGgWfunRHMyMDOW.jpg",
"l": "https://api.satelit.md/v1/movies/img/l/fvCgaMLmIcGTAGgWfunRHMyMDOW.jpg"
},
"backdrop": {
"m": "https://api.satelit.md/v1/movies/img/m/tlm8UkiQsitc8rSuIAscQDCnP8d.jpg",
"w": "https://api.satelit.md/v1/movies/img/w/tlm8UkiQsitc8rSuIAscQDCnP8d.jpg"
}
},
"genres": [
"Action",
"Science Fiction"
],
"role": "Neo"
}
],
"attribution": null
},
"meta": {
"credits": 1,
"updated_at": "2026-11-02T13:05:00+02:00",
"sources": [
{
"name": "Satelit",
"url": "https://satelit.md",
"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)"
}
}Films or series by filters
GET/v1/movies/discover
By genre (its id or its name in any of our languages), year or years, country of origin and original language, sorted by popularity, rating (at least 200 votes), newest or votes, 20 to a page. Costs 1 credit.
Parameters
-
kindstring: movie, seriesoptionaldefault movieFilms or series.
-
genrestringoptionalA genre id from `/movies/genres`, or its name, such as `comedie` or `комедия`.
-
yearintegeroptionalOne year.
-
year_fromintegeroptionalFrom this year.
-
year_tointegeroptionalTo this year.
-
countrystringoptionalThe country, in Romanian: Turcia, Egipt.
-
languagestringoptionalOriginal language, two letters, such as `ro`.
-
sortstring: popular, rating, newest, votesoptionaldefault popularprice or date.
-
min_votesintegeroptionalAt least this many votes.
-
pageintegeroptionaldefault 1The page, starting at 1.
-
data_langstring: be, bg, cs, en, es, fr, he, it, pl, pt, ro, ru, uk, zhoptionalThe language of the data itself (titles, overviews, genres): be, bg, cs, en, es, fr, he, it, pl, pt, ro, ru, uk or zh. Without it: the request's `lang`.
Possible errors
curl "https://api.satelit.md/v1/movies/discover?genre=animatie&sort=rating" \
-H "Authorization: Bearer $SATELIT_KEY" const res = await fetch("https://api.satelit.md/v1/movies/discover?genre=animatie&sort=rating", {
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/movies/discover?genre=animatie&sort=rating",
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/movies/discover?genre=animatie&sort=rating");
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": {
"page": 1,
"pages": 7,
"total": 126,
"results": [
{
"id": "m603",
"kind": "movie",
"title": "The Matrix",
"original_title": "The Matrix",
"year": 1999,
"released": "1999-03-31",
"language": "en",
"rating": {
"value": 8.3,
"votes": 29297
},
"overview": "A hacker learns that the world he knows is a simulation and joins the fight against its makers.",
"pictures": {
"poster": {
"s": "https://api.satelit.md/v1/movies/img/s/fvCgaMLmIcGTAGgWfunRHMyMDOW.jpg",
"m": "https://api.satelit.md/v1/movies/img/m/fvCgaMLmIcGTAGgWfunRHMyMDOW.jpg",
"l": "https://api.satelit.md/v1/movies/img/l/fvCgaMLmIcGTAGgWfunRHMyMDOW.jpg"
},
"backdrop": {
"m": "https://api.satelit.md/v1/movies/img/m/tlm8UkiQsitc8rSuIAscQDCnP8d.jpg",
"w": "https://api.satelit.md/v1/movies/img/w/tlm8UkiQsitc8rSuIAscQDCnP8d.jpg"
}
},
"genres": [
"Action",
"Science Fiction"
]
}
]
},
"meta": {
"credits": 1,
"updated_at": "2026-11-02T13:05:00+02:00",
"sources": [
{
"name": "Satelit",
"url": "https://satelit.md",
"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)"
}
}What is trending
GET/v1/movies/trending
The films, series and people the world watches and looks up today or this week. Costs 1 credit.
Parameters
-
kindstring: all, movie, series, personoptionaldefault allWhich kind.
-
windowstring: day, weekoptionaldefault weekToday or this week.
-
pageintegeroptionaldefault 1The page, starting at 1.
-
data_langstring: be, bg, cs, en, es, fr, he, it, pl, pt, ro, ru, uk, zhoptionalThe language of the data itself (titles, overviews, genres): be, bg, cs, en, es, fr, he, it, pl, pt, ro, ru, uk or zh. Without it: the request's `lang`.
Possible errors
curl "https://api.satelit.md/v1/movies/trending" \
-H "Authorization: Bearer $SATELIT_KEY" const res = await fetch("https://api.satelit.md/v1/movies/trending", {
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/movies/trending",
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/movies/trending");
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": {
"page": 1,
"pages": 7,
"total": 126,
"results": [
{
"id": "m603",
"kind": "movie",
"title": "The Matrix",
"original_title": "The Matrix",
"year": 1999,
"released": "1999-03-31",
"language": "en",
"rating": {
"value": 8.3,
"votes": 29297
},
"overview": "A hacker learns that the world he knows is a simulation and joins the fight against its makers.",
"pictures": {
"poster": {
"s": "https://api.satelit.md/v1/movies/img/s/fvCgaMLmIcGTAGgWfunRHMyMDOW.jpg",
"m": "https://api.satelit.md/v1/movies/img/m/fvCgaMLmIcGTAGgWfunRHMyMDOW.jpg",
"l": "https://api.satelit.md/v1/movies/img/l/fvCgaMLmIcGTAGgWfunRHMyMDOW.jpg"
},
"backdrop": {
"m": "https://api.satelit.md/v1/movies/img/m/tlm8UkiQsitc8rSuIAscQDCnP8d.jpg",
"w": "https://api.satelit.md/v1/movies/img/w/tlm8UkiQsitc8rSuIAscQDCnP8d.jpg"
}
},
"genres": [
"Action",
"Science Fiction"
]
}
]
},
"meta": {
"credits": 1,
"updated_at": "2026-11-02T13:05:00+02:00",
"sources": [
{
"name": "Satelit",
"url": "https://satelit.md",
"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)"
}
}In cinemas
GET/v1/movies/cinema
The films in a country's cinemas now (Moldova by default), or the ones that open next, with the window of dates. Costs 1 credit.
Parameters
-
countrystringoptionaldefault MDThe country, in Romanian: Turcia, Egipt.
-
whenstring: now, nextoptionaldefault nowNow or next.
-
pageintegeroptionaldefault 1The page, starting at 1.
-
data_langstring: be, bg, cs, en, es, fr, he, it, pl, pt, ro, ru, uk, zhoptionalThe language of the data itself (titles, overviews, genres): be, bg, cs, en, es, fr, he, it, pl, pt, ro, ru, uk or zh. Without it: the request's `lang`.
Possible errors
curl "https://api.satelit.md/v1/movies/cinema" \
-H "Authorization: Bearer $SATELIT_KEY" const res = await fetch("https://api.satelit.md/v1/movies/cinema", {
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/movies/cinema",
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/movies/cinema");
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": {
"page": 1,
"pages": 7,
"total": 126,
"results": [
{
"id": "m603",
"kind": "movie",
"title": "The Matrix",
"original_title": "The Matrix",
"year": 1999,
"released": "1999-03-31",
"language": "en",
"rating": {
"value": 8.3,
"votes": 29297
},
"overview": "A hacker learns that the world he knows is a simulation and joins the fight against its makers.",
"pictures": {
"poster": {
"s": "https://api.satelit.md/v1/movies/img/s/fvCgaMLmIcGTAGgWfunRHMyMDOW.jpg",
"m": "https://api.satelit.md/v1/movies/img/m/fvCgaMLmIcGTAGgWfunRHMyMDOW.jpg",
"l": "https://api.satelit.md/v1/movies/img/l/fvCgaMLmIcGTAGgWfunRHMyMDOW.jpg"
},
"backdrop": {
"m": "https://api.satelit.md/v1/movies/img/m/tlm8UkiQsitc8rSuIAscQDCnP8d.jpg",
"w": "https://api.satelit.md/v1/movies/img/w/tlm8UkiQsitc8rSuIAscQDCnP8d.jpg"
}
},
"genres": [
"Action",
"Science Fiction"
]
}
],
"dates": {
"minimum": "2026-10-14",
"maximum": "2026-11-25"
}
},
"meta": {
"credits": 1,
"updated_at": "2026-11-02T13:05:00+02:00",
"sources": [
{
"name": "Satelit",
"url": "https://satelit.md",
"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)"
}
}Genres
GET/v1/movies/genres
The genres of films or series with their ids, in the request's language. Costs nothing.
Parameters
-
kindstring: movie, seriesoptionaldefault movieFilms or series.
-
data_langstring: be, bg, cs, en, es, fr, he, it, pl, pt, ro, ru, uk, zhoptionalThe language of the data itself (titles, overviews, genres): be, bg, cs, en, es, fr, he, it, pl, pt, ro, ru, uk or zh. Without it: the request's `lang`.
Possible errors
curl "https://api.satelit.md/v1/movies/genres" \
-H "Authorization: Bearer $SATELIT_KEY" const res = await fetch("https://api.satelit.md/v1/movies/genres", {
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/movies/genres",
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/movies/genres");
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": {
"kind": "movie",
"genres": [
{
"id": 28,
"name": "Action"
},
{
"id": 16,
"name": "Animation"
}
]
},
"meta": {
"credits": 0,
"updated_at": "2026-11-02T13:05:00+02:00",
"sources": [
{
"name": "Satelit",
"url": "https://satelit.md",
"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)"
}
}Cinemas of a country
GET/v1/movies/cinemas
Every cinema read in a country (Moldova by default), the busiest first: chain, city, address, screens, sessions ahead, and the coverage: chains, cinemas, cities, sessions, films, the days and when the cinemas' own sites were last read. Costs 1 credit.
Parameters
-
countrystringoptionaldefault MDThe country, in Romanian: Turcia, Egipt.
-
citystringoptionalThe city.
Possible errors
curl "https://api.satelit.md/v1/movies/cinemas" \
-H "Authorization: Bearer $SATELIT_KEY" const res = await fetch("https://api.satelit.md/v1/movies/cinemas", {
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/movies/cinemas",
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/movies/cinemas");
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": {
"coverage": {
"country": "MD",
"chains": 2,
"cinemas": 4,
"cinemas_with_sessions": 3,
"cities": 2,
"sessions": 109,
"films": 9,
"first_day": "2026-11-19",
"last_day": "2026-11-22",
"read_at": "2026-11-19T03:06:19Z"
},
"cinemas": [
{
"id": "c3966341138",
"name": "Cineplex Mall",
"chain": "Cineplex",
"city": "Chișinău",
"address": "Arborilor 21, Shopping Malldova",
"screens": 6,
"lat": null,
"lon": null,
"sessions": 77,
"first_day": "2026-11-19",
"last_day": "2026-11-22"
}
]
},
"meta": {
"credits": 1,
"updated_at": "2026-11-02T13:05:00+02:00",
"sources": [
{
"name": "Satelit",
"url": "https://satelit.md",
"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)"
}
}Countries with cinemas
GET/v1/movies/cinemas/countries
Every country whose cinemas are read, the one with the most cinemas first: chains, cinemas, cities, sessions ahead, films, the days and when its cinemas' own sites were last read; the totals; and the 14 languages `data_lang` takes. Costs 1 credit.
Parameters
No parameters.
Possible errors
curl "https://api.satelit.md/v1/movies/cinemas/countries" \
-H "Authorization: Bearer $SATELIT_KEY" const res = await fetch("https://api.satelit.md/v1/movies/cinemas/countries", {
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/movies/cinemas/countries",
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/movies/cinemas/countries");
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": {
"countries": [
{
"name": "United Kingdom",
"country": "GB",
"chains": 11,
"cinemas": 227,
"cinemas_with_sessions": 223,
"cities": 179,
"sessions": 28504,
"films": 96,
"first_day": "2026-11-19",
"last_day": "2026-11-22",
"read_at": "2026-11-19T03:06:19Z"
}
],
"total": {
"chains": 148,
"cinemas": 2052,
"cities": 1294,
"sessions": 187385
},
"data_langs": [
"be",
"bg",
"cs",
"en",
"es",
"fr",
"he",
"it",
"pl",
"pt",
"ro",
"ru",
"uk",
"zh"
]
},
"meta": {
"credits": 1,
"updated_at": "2026-11-02T13:05:00+02:00",
"sources": [
{
"name": "Satelit",
"url": "https://satelit.md",
"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)"
}
}One cinema's sessions
GET/v1/movies/cinemas/{id}/schedule
A cinema's films from today on, or on one day, each with its sessions in time order: hall, formats, audio and language, subtitles, price, sold out, the cinema's own booking link. A film listed twice (dubbed and subtitled) is one film. Costs 2 credits.
Parameters
-
idstringrequiredThe row identifier.
-
datestringoptionalThe day, YYYY-MM-DD.
-
data_langstring: be, bg, cs, en, es, fr, he, it, pl, pt, ro, ru, uk, zhoptionalThe language of the data itself (titles, overviews, genres): be, bg, cs, en, es, fr, he, it, pl, pt, ro, ru, uk or zh. Without it: the request's `lang`.
Possible errors
curl "https://api.satelit.md/v1/movies/cinemas/{id}/schedule" \
-H "Authorization: Bearer $SATELIT_KEY" const res = await fetch("https://api.satelit.md/v1/movies/cinemas/{id}/schedule", {
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/movies/cinemas/{id}/schedule",
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/movies/cinemas/{id}/schedule");
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": {
"cinema": {
"id": "c3966341138",
"name": "Cineplex Mall",
"chain": "Cineplex",
"city": "Chișinău",
"address": "Arborilor 21, Shopping Malldova",
"screens": 6,
"lat": null,
"lon": null,
"sessions": 77,
"first_day": "2026-11-19",
"last_day": "2026-11-22"
},
"day": null,
"films": [
{
"id": "m603",
"kind": "movie",
"title": "The Matrix",
"original_title": "The Matrix",
"year": 1999,
"released": "1999-03-31",
"language": "en",
"rating": {
"value": 8.3,
"votes": 29297
},
"overview": "A hacker learns that the world he knows is a simulation and joins the fight against its makers.",
"pictures": {
"poster": {
"s": "https://api.satelit.md/v1/movies/img/s/fvCgaMLmIcGTAGgWfunRHMyMDOW.jpg",
"m": "https://api.satelit.md/v1/movies/img/m/fvCgaMLmIcGTAGgWfunRHMyMDOW.jpg",
"l": "https://api.satelit.md/v1/movies/img/l/fvCgaMLmIcGTAGgWfunRHMyMDOW.jpg"
},
"backdrop": {
"m": "https://api.satelit.md/v1/movies/img/m/tlm8UkiQsitc8rSuIAscQDCnP8d.jpg",
"w": "https://api.satelit.md/v1/movies/img/w/tlm8UkiQsitc8rSuIAscQDCnP8d.jpg"
}
},
"listed_title": "The Matrix",
"sessions": [
{
"date": "2026-11-19",
"time": "19:10",
"hall": "Sala 2",
"formats": [
"2D"
],
"audio": "ro",
"language": "RO",
"subtitles": null,
"price": null,
"currency": null,
"sold_out": false,
"booking_url": null
}
]
}
]
},
"meta": {
"credits": 2,
"updated_at": "2026-11-02T13:05:00+02:00",
"sources": [
{
"name": "Satelit",
"url": "https://satelit.md",
"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)"
}
}A day in every cinema
GET/v1/movies/cinemas/today
One day's sessions in every cinema of a country that has them, the first day with sessions unless `date` says: each cinema and its films with their hours, and the coverage. Costs 3 credits.
Parameters
-
countrystringoptionaldefault MDThe country, in Romanian: Turcia, Egipt.
-
citystringoptionalThe city.
-
datestringoptionalThe day, YYYY-MM-DD.
-
data_langstring: be, bg, cs, en, es, fr, he, it, pl, pt, ro, ru, uk, zhoptionalThe language of the data itself (titles, overviews, genres): be, bg, cs, en, es, fr, he, it, pl, pt, ro, ru, uk or zh. Without it: the request's `lang`.
Possible errors
curl "https://api.satelit.md/v1/movies/cinemas/today" \
-H "Authorization: Bearer $SATELIT_KEY" const res = await fetch("https://api.satelit.md/v1/movies/cinemas/today", {
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/movies/cinemas/today",
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/movies/cinemas/today");
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": {
"country": "MD",
"day": "2026-11-19",
"cinemas": [
{
"cinema": {
"id": "c3966341138",
"name": "Cineplex Mall",
"chain": "Cineplex",
"city": "Chișinău",
"address": "Arborilor 21, Shopping Malldova",
"screens": 6,
"lat": null,
"lon": null,
"sessions": 77,
"first_day": "2026-11-19",
"last_day": "2026-11-22"
},
"films": [
{
"id": "m603",
"kind": "movie",
"title": "The Matrix",
"original_title": "The Matrix",
"year": 1999,
"released": "1999-03-31",
"language": "en",
"rating": {
"value": 8.3,
"votes": 29297
},
"overview": "A hacker learns that the world he knows is a simulation and joins the fight against its makers.",
"pictures": {
"poster": {
"s": "https://api.satelit.md/v1/movies/img/s/fvCgaMLmIcGTAGgWfunRHMyMDOW.jpg",
"m": "https://api.satelit.md/v1/movies/img/m/fvCgaMLmIcGTAGgWfunRHMyMDOW.jpg",
"l": "https://api.satelit.md/v1/movies/img/l/fvCgaMLmIcGTAGgWfunRHMyMDOW.jpg"
},
"backdrop": {
"m": "https://api.satelit.md/v1/movies/img/m/tlm8UkiQsitc8rSuIAscQDCnP8d.jpg",
"w": "https://api.satelit.md/v1/movies/img/w/tlm8UkiQsitc8rSuIAscQDCnP8d.jpg"
}
},
"listed_title": "The Matrix",
"sessions": [
{
"date": "2026-11-19",
"time": "19:10",
"hall": "Sala 2",
"formats": [
"2D"
],
"audio": "ro",
"language": "RO",
"subtitles": null,
"price": null,
"currency": null,
"sold_out": false,
"booking_url": null
}
]
}
]
}
],
"coverage": {
"country": "MD",
"chains": 2,
"cinemas": 4,
"cinemas_with_sessions": 3,
"cities": 2,
"sessions": 109,
"films": 9,
"first_day": "2026-11-19",
"last_day": "2026-11-22",
"read_at": "2026-11-19T03:06:19Z"
}
},
"meta": {
"credits": 3,
"updated_at": "2026-11-02T13:05:00+02:00",
"sources": [
{
"name": "Satelit",
"url": "https://satelit.md",
"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)"
}
}Free films and series
GET/v1/movies/free
Titles the catalogue proves free to show in full, public domain or an open licence, each with where it is free (worldwide or by country), the terms (commercial use, changes, attribution, share alike), the proof's kind and whether a full copy is known; 20 to a page. `q` searches them by title. Costs 2 credits.
Parameters
-
kindstring: movie, seriesoptionaldefault movieFilms or series.
-
qstringoptionalWords to search for.
-
licensestring: public_domain, open_licenseoptionalOnly this kind of freedom.
-
countrystringoptionalThe country, in Romanian: Turcia, Egipt.
-
yearintegeroptionalRelease year.
-
genrestringoptionalA genre id or name.
-
sortstring: popular, rating, votes, newest, oldestoptionaldefault popularprice or date.
-
pageintegeroptionaldefault 1The page, starting at 1.
-
data_langstring: be, bg, cs, en, es, fr, he, it, pl, pt, ro, ru, uk, zhoptionalThe language of the data itself (titles, overviews, genres): be, bg, cs, en, es, fr, he, it, pl, pt, ro, ru, uk or zh. Without it: the request's `lang`.
Possible errors
curl "https://api.satelit.md/v1/movies/free" \
-H "Authorization: Bearer $SATELIT_KEY" const res = await fetch("https://api.satelit.md/v1/movies/free", {
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/movies/free",
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/movies/free");
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": {
"page": 1,
"pages": 500,
"total": 10000,
"results": [
{
"id": "m10331",
"kind": "movie",
"title": "Night of the Living Dead",
"original_title": "Night of the Living Dead",
"year": 1968,
"released": "1968-10-04",
"language": "en",
"rating": {
"value": 7.5,
"votes": 2400
},
"overview": "Strangers hide in a farmhouse from the walking dead.",
"pictures": null,
"genres": [
"Horror"
],
"license": {
"status": "public_domain",
"free": true,
"confidence": "high",
"worldwide": false,
"countries": [
"US"
],
"spdx": null,
"license_url": null,
"commercial_use": true,
"modifications": true,
"attribution_required": false,
"share_alike": false,
"basis": [
"us_no_notice"
],
"has_copy": true,
"checked_at": null
}
}
]
},
"meta": {
"credits": 2,
"updated_at": "2026-11-02T13:05:00+02:00",
"sources": [
{
"name": "Satelit",
"url": "https://satelit.md",
"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)"
}
}How many titles are free
GET/v1/movies/free/stats
Films and series that are public domain, under an open licence, and free worldwide. Costs nothing.
Parameters
No parameters.
Possible errors
curl "https://api.satelit.md/v1/movies/free/stats" \
-H "Authorization: Bearer $SATELIT_KEY" const res = await fetch("https://api.satelit.md/v1/movies/free/stats", {
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/movies/free/stats",
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/movies/free/stats");
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": {
"films": {
"public_domain": 26301,
"open_license": 31,
"worldwide": 47,
"total": 26332
},
"series": {
"public_domain": 0,
"open_license": 4,
"worldwide": 4,
"total": 4
}
},
"meta": {
"credits": 0,
"updated_at": "2026-11-02T13:05:00+02:00",
"sources": [
{
"name": "Satelit",
"url": "https://satelit.md",
"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)"
}
}A title's licence
GET/v1/movies/titles/{id}/license
Whether a film or series may be shown in full on a website, where, on what terms and on which proof. Costs 1 credit.
Parameters
-
idstringrequiredThe row identifier.
Possible errors
curl "https://api.satelit.md/v1/movies/titles/{id}/license" \
-H "Authorization: Bearer $SATELIT_KEY" const res = await fetch("https://api.satelit.md/v1/movies/titles/{id}/license", {
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/movies/titles/{id}/license",
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/movies/titles/{id}/license");
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": "m10331",
"license": {
"status": "public_domain",
"free": true,
"confidence": "high",
"worldwide": false,
"countries": [
"US"
],
"spdx": null,
"license_url": null,
"commercial_use": true,
"modifications": true,
"attribution_required": false,
"share_alike": false,
"basis": [
"us_no_notice"
],
"has_copy": true,
"checked_at": null
}
},
"meta": {
"credits": 1,
"updated_at": "2026-11-02T13:05:00+02:00",
"sources": [
{
"name": "Satelit",
"url": "https://satelit.md",
"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)"
}
}A free film's streams
GET/v1/movies/titles/{id}/streams
The playable copies of a film the licence calls free: HLS, MP4, WebM or Ogg, with the page, the quality, the audio language, the copy's own licence and how it was checked. Wikimedia Commons copies carry their licence; Internet Archive copies the uploader's claim; partner copies need no account and are started before they are listed. Links may expire within hours: ask again, never store them. A film that is not free has none; `pending` asks to try again in a minute. Costs 5 credits. Open from the Creator plan up.
Parameters
-
idstringrequiredThe row identifier.
Possible errors
curl "https://api.satelit.md/v1/movies/titles/{id}/streams" \
-H "Authorization: Bearer $SATELIT_KEY" const res = await fetch("https://api.satelit.md/v1/movies/titles/{id}/streams", {
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/movies/titles/{id}/streams",
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/movies/titles/{id}/streams");
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": "m10331",
"license": {
"status": "public_domain",
"free": true,
"confidence": "high",
"worldwide": false,
"countries": [
"US"
],
"spdx": null,
"license_url": null,
"commercial_use": true,
"modifications": true,
"attribution_required": false,
"share_alike": false,
"basis": [
"us_no_notice"
],
"has_copy": true,
"checked_at": null
},
"total": 2,
"checked_at": "2026-11-19T12:00:00Z",
"stale": false,
"pending": false,
"streams": [
{
"source": "wikimedia_commons",
"source_id": "3f9a0c1d2e4b5a69",
"url": "https://upload.wikimedia.org/example.webm",
"page_url": "https://commons.wikimedia.org/wiki/File:Example.webm",
"type": "webm",
"quality": "1080p",
"audio_language": "en",
"license": "Public domain",
"verified": true,
"headers": {}
},
{
"source": "internet_archive",
"source_id": "8b1e7d0a4c2f9e31",
"url": "https://archive.org/download/example/example.mp4",
"page_url": "https://archive.org/details/example",
"type": "mp4",
"quality": "360p",
"audio_language": "en",
"license": null,
"verified": false,
"headers": {}
}
]
},
"meta": {
"credits": 5,
"updated_at": "2026-11-02T13:05:00+02:00",
"sources": [
{
"name": "Satelit",
"url": "https://satelit.md",
"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)"
}
}A series' episodes
GET/v1/movies/series/{id}/episodes
Every aired episode, season by season, with its name, air date, length and rating, and the best and the worst episode. Costs 2 credits.
Parameters
-
idstringrequiredThe row identifier.
-
data_langstring: be, bg, cs, en, es, fr, he, it, pl, pt, ro, ru, uk, zhoptionalThe language of the data itself (titles, overviews, genres): be, bg, cs, en, es, fr, he, it, pl, pt, ro, ru, uk or zh. Without it: the request's `lang`.
Possible errors
curl "https://api.satelit.md/v1/movies/series/{id}/episodes" \
-H "Authorization: Bearer $SATELIT_KEY" const res = await fetch("https://api.satelit.md/v1/movies/series/{id}/episodes", {
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/movies/series/{id}/episodes",
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/movies/series/{id}/episodes");
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": "s1399",
"rated": 73,
"aired": 73,
"seasons": [
{
"season": 6,
"episodes": [
{
"episode": 9,
"name": "Battle of the Bastards",
"aired": "2016-06-19",
"runtime_min": 60,
"rating": {
"value": 9.3,
"votes": 401
}
}
]
}
],
"best": {
"season": 6,
"episode": 9,
"name": "Battle of the Bastards",
"aired": "2016-06-19",
"runtime_min": 60,
"rating": {
"value": 9.3,
"votes": 401
}
},
"worst": {
"season": 8,
"episode": 6,
"name": "The Iron Throne",
"aired": "2019-05-19",
"runtime_min": 80,
"rating": {
"value": 4.5,
"votes": 469
}
}
},
"meta": {
"credits": 2,
"updated_at": "2026-11-02T13:05:00+02:00",
"sources": [
{
"name": "Satelit",
"url": "https://satelit.md",
"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)"
}
}A picture
GET/v1/movies/img/{size}/{file}
A poster, backdrop or photo from an answer's `pictures`, at `s` (185 px wide), `m` (342), `l` (780) or `w` (1280, backdrops). No key, so a page's image tag loads it; 600 a minute per address, cached for a year. Use the addresses the answers give: the names cannot be guessed.
Parameters
-
sizestring: s, m, l, wrequiredThe size.
-
filestringrequiredThe picture's name, from an answer.
Possible errors
curl "https://api.satelit.md/v1/movies/img/{size}/{file}" const res = await fetch("https://api.satelit.md/v1/movies/img/{size}/{file}");
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/movies/img/{size}/{file}",
)
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/movies/img/{size}/{file}");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
]);
$body = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($body["data"]); Today in Moldova's cinemas
GET/v1/movies/board
Today's sessions in Moldova's cinemas without a key, the same as `/movies/cinemas/today` for Moldova: one answer per language for everybody, kept 10 minutes, 30 a minute per address.
Parameters
-
datestringoptionalThe day, YYYY-MM-DD.
Possible errors
curl "https://api.satelit.md/v1/movies/board" const res = await fetch("https://api.satelit.md/v1/movies/board");
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/movies/board",
)
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/movies/board");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
]);
$body = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($body["data"]); {
"data": {
"country": "MD",
"day": "2026-11-19",
"cinemas": [
{
"cinema": {
"id": "c3966341138",
"name": "Cineplex Mall",
"chain": "Cineplex",
"city": "Chișinău",
"address": "Arborilor 21, Shopping Malldova",
"screens": 6,
"lat": null,
"lon": null,
"sessions": 77,
"first_day": "2026-11-19",
"last_day": "2026-11-22"
},
"films": [
{
"id": "m603",
"kind": "movie",
"title": "The Matrix",
"original_title": "The Matrix",
"year": 1999,
"released": "1999-03-31",
"language": "en",
"rating": {
"value": 8.3,
"votes": 29297
},
"overview": "A hacker learns that the world he knows is a simulation and joins the fight against its makers.",
"pictures": {
"poster": {
"s": "https://api.satelit.md/v1/movies/img/s/fvCgaMLmIcGTAGgWfunRHMyMDOW.jpg",
"m": "https://api.satelit.md/v1/movies/img/m/fvCgaMLmIcGTAGgWfunRHMyMDOW.jpg",
"l": "https://api.satelit.md/v1/movies/img/l/fvCgaMLmIcGTAGgWfunRHMyMDOW.jpg"
},
"backdrop": {
"m": "https://api.satelit.md/v1/movies/img/m/tlm8UkiQsitc8rSuIAscQDCnP8d.jpg",
"w": "https://api.satelit.md/v1/movies/img/w/tlm8UkiQsitc8rSuIAscQDCnP8d.jpg"
}
},
"listed_title": "The Matrix",
"sessions": [
{
"date": "2026-11-19",
"time": "19:10",
"hall": "Sala 2",
"formats": [
"2D"
],
"audio": "ro",
"language": "RO",
"subtitles": null,
"price": null,
"currency": null,
"sold_out": false,
"booking_url": null
}
]
}
]
}
],
"coverage": {
"country": "MD",
"chains": 2,
"cinemas": 4,
"cinemas_with_sessions": 3,
"cities": 2,
"sessions": 109,
"films": 9,
"first_day": "2026-11-19",
"last_day": "2026-11-22",
"read_at": "2026-11-19T03:06:19Z"
}
},
"meta": {
"credits": 0,
"updated_at": null,
"sources": [
{
"name": "Satelit",
"url": "https://satelit.md",
"license": "none: read from the source's public pages; no agreement with the source and no licence over its data is granted"
}
],
"attribution": null
}
}