Фильмы и сериалы
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.
Параметры
-
qstringобязательныйСлова для поиска.
-
kindstring: all, movie, series, personнеобязательныйпо умолчанию allWhich kind.
-
yearintegerнеобязательныйA film's year or a series' first year.
-
pageintegerнеобязательныйпо умолчанию 1Страница, начиная с 1.
-
data_langstring: be, bg, cs, en, es, fr, he, it, pl, pt, ro, ru, uk, zhнеобязательныйThe 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`.
Возможные ошибки
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.
Параметры
-
idstringобязательныйИдентификатор строки.
-
data_langstring: be, bg, cs, en, es, fr, he, it, pl, pt, ro, ru, uk, zhнеобязательныйThe 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`.
Возможные ошибки
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.
Параметры
-
idstringобязательныйИдентификатор строки.
-
data_langstring: be, bg, cs, en, es, fr, he, it, pl, pt, ro, ru, uk, zhнеобязательныйThe 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`.
Возможные ошибки
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.
Параметры
-
idstringобязательныйИдентификатор строки.
-
countrystringнеобязательныйпо умолчанию MDСтрана, на румынском: Turcia, Egipt.
Возможные ошибки
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.
Параметры
-
idstringобязательныйИдентификатор строки.
-
data_langstring: be, bg, cs, en, es, fr, he, it, pl, pt, ro, ru, uk, zhнеобязательныйThe 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`.
Возможные ошибки
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.
Параметры
-
kindstring: movie, seriesнеобязательныйпо умолчанию movieFilms or series.
-
genrestringнеобязательныйA genre id from `/movies/genres`, or its name, such as `comedie` or `комедия`.
-
yearintegerнеобязательныйOne year.
-
year_fromintegerнеобязательныйFrom this year.
-
year_tointegerнеобязательныйTo this year.
-
countrystringнеобязательныйСтрана, на румынском: Turcia, Egipt.
-
languagestringнеобязательныйOriginal language, two letters, such as `ro`.
-
sortstring: popular, rating, newest, votesнеобязательныйпо умолчанию popularprice или date.
-
min_votesintegerнеобязательныйAt least this many votes.
-
pageintegerнеобязательныйпо умолчанию 1Страница, начиная с 1.
-
data_langstring: be, bg, cs, en, es, fr, he, it, pl, pt, ro, ru, uk, zhнеобязательныйThe 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`.
Возможные ошибки
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.
Параметры
-
kindstring: all, movie, series, personнеобязательныйпо умолчанию allWhich kind.
-
windowstring: day, weekнеобязательныйпо умолчанию weekToday or this week.
-
pageintegerнеобязательныйпо умолчанию 1Страница, начиная с 1.
-
data_langstring: be, bg, cs, en, es, fr, he, it, pl, pt, ro, ru, uk, zhнеобязательныйThe 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`.
Возможные ошибки
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.
Параметры
-
countrystringнеобязательныйпо умолчанию MDСтрана, на румынском: Turcia, Egipt.
-
whenstring: now, nextнеобязательныйпо умолчанию nowNow or next.
-
pageintegerнеобязательныйпо умолчанию 1Страница, начиная с 1.
-
data_langstring: be, bg, cs, en, es, fr, he, it, pl, pt, ro, ru, uk, zhнеобязательныйThe 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`.
Возможные ошибки
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.
Параметры
-
kindstring: movie, seriesнеобязательныйпо умолчанию movieFilms or series.
-
data_langstring: be, bg, cs, en, es, fr, he, it, pl, pt, ro, ru, uk, zhнеобязательныйThe 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`.
Возможные ошибки
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.
Параметры
-
countrystringнеобязательныйпо умолчанию MDСтрана, на румынском: Turcia, Egipt.
-
citystringнеобязательныйГород.
Возможные ошибки
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.
Параметры
Без параметров.
Возможные ошибки
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.
Параметры
-
idstringобязательныйИдентификатор строки.
-
datestringнеобязательныйДень, YYYY-MM-DD.
-
data_langstring: be, bg, cs, en, es, fr, he, it, pl, pt, ro, ru, uk, zhнеобязательныйThe 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`.
Возможные ошибки
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.
Параметры
-
countrystringнеобязательныйпо умолчанию MDСтрана, на румынском: Turcia, Egipt.
-
citystringнеобязательныйГород.
-
datestringнеобязательныйДень, YYYY-MM-DD.
-
data_langstring: be, bg, cs, en, es, fr, he, it, pl, pt, ro, ru, uk, zhнеобязательныйThe 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`.
Возможные ошибки
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.
Параметры
-
kindstring: movie, seriesнеобязательныйпо умолчанию movieFilms or series.
-
qstringнеобязательныйСлова для поиска.
-
licensestring: public_domain, open_licenseнеобязательныйOnly this kind of freedom.
-
countrystringнеобязательныйСтрана, на румынском: Turcia, Egipt.
-
yearintegerнеобязательныйRelease year.
-
genrestringнеобязательныйA genre id or name.
-
sortstring: popular, rating, votes, newest, oldestнеобязательныйпо умолчанию popularprice или date.
-
pageintegerнеобязательныйпо умолчанию 1Страница, начиная с 1.
-
data_langstring: be, bg, cs, en, es, fr, he, it, pl, pt, ro, ru, uk, zhнеобязательныйThe 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`.
Возможные ошибки
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.
Параметры
Без параметров.
Возможные ошибки
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.
Параметры
-
idstringобязательныйИдентификатор строки.
Возможные ошибки
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.
Параметры
-
idstringобязательныйИдентификатор строки.
Возможные ошибки
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.
Параметры
-
idstringобязательныйИдентификатор строки.
-
data_langstring: be, bg, cs, en, es, fr, he, it, pl, pt, ro, ru, uk, zhнеобязательныйThe 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`.
Возможные ошибки
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.
Параметры
-
sizestring: s, m, l, wобязательныйThe size.
-
filestringобязательныйThe picture's name, from an answer.
Возможные ошибки
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.
Параметры
-
datestringнеобязательныйДень, YYYY-MM-DD.
Возможные ошибки
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
}
}