Build with Micro.blog logo
Build with Micro.blog
API Documentation

Movies

View .md

Endpoints for movie and TV discovery, search, and posting helpers.

BASE URL https://micro.blog
GET /movies/discover

Returns recent movie and TV activity in JSON Feed format.

Example Request

curl -X GET "https://micro.blog/movies/discover" \
  --header "Authorization: Bearer EF7BB9BCAC1F6D561C93"

Header Parameters

Name Type Required Description
Authorization string Required Bearer token for authentication. Format: Bearer {token}.

Response

200 OK application/json

Returns a JSON Feed response.

Example Response

{
  "version": "https://jsonfeed.org/version/1.1",
  "title": "Micro.blog - Discover Movies",
  "home_page_url": "https://micro.blog",
  "feed_url": "https://micro.blog/movies/discover",
  "_microblog": {
    "about": "https://micro.blog/about/api"
  },
  "items": [
    {
      "id": "12345",
      "title": "Dune: Part Two",
      "content_text": "Paul Atreides unites with Chani and the Fremen.",
      "url": "https://www.themoviedb.org/movie/693134",
      "image": "https://image.tmdb.org/t/p/w500/example.jpg",
      "date_published": "2026-04-26T12:00:00+00:00",
      "authors": [
        {
          "name": "Vincent",
          "url": "https://vincent.micro.blog/",
          "avatar": "https://avatars.micro.blog/avatars/2026/123.jpg",
          "_microblog": {
            "username": "vincent",
            "user_id": 123
          }
        }
      ],
      "_microblog": {
        "tmdb_id": "693134",
        "tmdb_url": "https://www.themoviedb.org/movie/693134",
        "poster_url": "https://image.tmdb.org/t/p/w500/example.jpg",
        "username": "vincent",
        "user_id": 123,
        "user_avatar_url": "https://avatars.micro.blog/avatars/2026/123.jpg",
        "date_timestamp": 1777204800
      }
    }
  ]
}
GET /movies/discover/{id}

Returns TV season posting helpers for a TMDB show.

Example Request

curl -X GET "https://micro.blog/movies/discover/{id}" \
  --header "Authorization: Bearer EF7BB9BCAC1F6D561C93"

Header Parameters

Name Type Required Description
Authorization string Required Bearer token for authentication. Format: Bearer {token}.

Path Parameters

Name Type Required Description
id integer Required TMDB show identifier.
Example: 1399

Response

200 OK application/json

Returns a JSON Feed response.

Example Response

{
  "version": "https://jsonfeed.org/version/1.1",
  "title": "Micro.blog - Discover Movies - Severance",
  "home_page_url": "https://micro.blog",
  "feed_url": "https://micro.blog/movies/discover/95396",
  "_microblog": {
    "about": "https://micro.blog/about/api",
    "tmdb_id": "95396",
    "tmdb_url": "https://www.themoviedb.org/tv/95396",
    "movies_prefix": "Watched:",
    "movies_emoji_movie": "",
    "movies_emoji_tv": "",
    "title": "Severance",
    "overview": "Mark leads a team of office workers whose memories have been surgically divided.",
    "poster_url": "https://image.tmdb.org/t/p/w500/example.jpg",
    "number_of_seasons": 2,
    "number_of_episodes": 19,
    "type": "tv",
    "first_air_date": "2022-02-17",
    "post_text": "Watched: [Severance](https://www.themoviedb.org/tv/95396)"
  },
  "items": [
    {
      "id": "tv-95396-season-1",
      "title": "Season 1",
      "content_text": "The Macrodata Refinement team begins to question Lumon Industries.",
      "url": "https://www.themoviedb.org/tv/95396/season/1",
      "image": "https://micro.blog/photos/100x/https%3A%2F%2Fimage.tmdb.org%2Ft%2Fp%2Fw500%2Fexample.jpg",
      "_microblog": {
        "tmdb_id": "95396",
        "season_number": 1,
        "tmdb_url": "https://www.themoviedb.org/tv/95396/season/1",
        "post_text": "Watched: [Severance Season 1](https://www.themoviedb.org/tv/95396/season/1)",
        "movies_prefix": "Watched:",
        "movies_emoji_tv": "",
        "series_title": "Severance",
        "season_title": "Season 1",
        "overview": "The Macrodata Refinement team begins to question Lumon Industries.",
        "air_date": "2022-02-17",
        "episode_count": 9,
        "poster_url": "https://image.tmdb.org/t/p/w500/example.jpg"
      }
    }
  ]
}
GET /movies/discover/{id}/seasons/{number}

Returns TV episode posting helpers for a TMDB show season.

Example Request

curl -X GET "https://micro.blog/movies/discover/{id}/seasons/{number}" \
  --header "Authorization: Bearer EF7BB9BCAC1F6D561C93"

Header Parameters

Name Type Required Description
Authorization string Required Bearer token for authentication. Format: Bearer {token}.

Path Parameters

Name Type Required Description
id integer Required TMDB show identifier.
Example: 1399
number integer Required Season number.
Example: 1

Response

200 OK application/json

Returns a JSON Feed response.

Example Response

{
  "version": "https://jsonfeed.org/version/1.1",
  "title": "Micro.blog - Discover Movies - Severance Season 1",
  "home_page_url": "https://micro.blog",
  "feed_url": "https://micro.blog/movies/discover/95396/seasons/1",
  "_microblog": {
    "about": "https://micro.blog/about/api",
    "tmdb_id": "95396",
    "tmdb_url": "https://www.themoviedb.org/tv/95396/season/1",
    "season_number": "1",
    "movies_prefix": "Watched:",
    "movies_emoji_tv": "",
    "series_title": "Severance",
    "title": "Season 1",
    "overview": "The Macrodata Refinement team begins to question Lumon Industries.",
    "poster_url": "https://image.tmdb.org/t/p/w500/example.jpg",
    "episode_count": 9
  },
  "items": [
    {
      "id": "tv-95396-season-1-episode-1",
      "title": "Severance S1E1: Good News About Hell",
      "content_text": "Mark is promoted to lead a team whose memories are divided between work and home.",
      "url": "https://www.themoviedb.org/tv/95396/season/1/episode/1",
      "image": "https://micro.blog/photos/100x/https%3A%2F%2Fimage.tmdb.org%2Ft%2Fp%2Fw500%2Fstill.jpg",
      "_microblog": {
        "tmdb_id": "95396",
        "season_number": "1",
        "episode_number": "1",
        "tmdb_url": "https://www.themoviedb.org/tv/95396/season/1/episode/1",
        "post_text": "Watched: [Severance S1E1, Good News About Hell](https://www.themoviedb.org/tv/95396/season/1/episode/1)",
        "movies_prefix": "Watched:",
        "movies_emoji_tv": "",
        "series_title": "Severance",
        "episode_title": "Good News About Hell",
        "overview": "Mark is promoted to lead a team whose memories are divided between work and home.",
        "still_url": "https://image.tmdb.org/t/p/w500/still.jpg",
        "large_still_url": "https://image.tmdb.org/t/p/w500/still.jpg",
        "runtime": 57,
        "air_date": "2022-02-17"
      }
    }
  ]
}
GET /movies/search

Searches TMDB movies and TV shows.

Example Request

curl -X GET "https://micro.blog/movies/search?q=search+term" \
  --header "Authorization: Bearer EF7BB9BCAC1F6D561C93"

Query Parameters

Name Type Required Description
q string Required Search query.
Example: search term
limit integer Optional Maximum number of items to return.
Example: 25

Header Parameters

Name Type Required Description
Authorization string Required Bearer token for authentication. Format: Bearer {token}.

Response

200 OK application/json

Returns a JSON Feed response.

Example Response

{
  "version": "https://jsonfeed.org/version/1.1",
  "title": "Micro.blog - Movies Search",
  "home_page_url": "https://micro.blog",
  "feed_url": "https://micro.blog/movies/search",
  "_microblog": {
    "about": "https://micro.blog/about/api",
    "movies_prefix": "Watched:",
    "movies_emoji_movie": "",
    "movies_emoji_tv": ""
  },
  "items": [
    {
      "id": "movie-693134",
      "title": "Dune: Part Two",
      "content_text": "",
      "url": "https://www.themoviedb.org/movie/693134",
      "image": "https://image.tmdb.org/t/p/w500/example.jpg",
      "_microblog": {
        "tmdb_id": "693134",
        "type": "movie",
        "title": "Dune: Part Two",
        "tmdb_url": "https://www.themoviedb.org/movie/693134",
        "year": "2024",
        "director": "Denis Villeneuve",
        "poster_url": "https://image.tmdb.org/t/p/w500/example.jpg",
        "overview": "Paul Atreides unites with Chani and the Fremen.",
        "post_text": "Watched: [Dune: Part Two](https://www.themoviedb.org/movie/693134)",
        "movies_prefix": "Watched:",
        "movies_emoji_movie": "",
        "movies_emoji_tv": ""
      }
    }
  ]
}