openapi.json

{
  "openapi": "3.0.0",
  "servers": [
    {
      "url": "https://etmdb.com"
    }
  ],
  "info": {
    "contact": {
      "x-twitter": "etmdb"
    },
    "description": "The Ethiopian Movie Database",
    "title": "EtMDB REST API v1",
    "version": "1.0.0",
    "x-apisguru-categories": [
      "media"
    ],
    "x-logo": {
      "backgroundColor": "#FFFFFF",
      "url": "https://api.apis.guru/v2/cache/logo/https_twitter.com_etmdb_profile_image.png"
    },
    "x-origin": [
      {
        "format": "openapi",
        "url": "https://etmdb.com/api/docs/endpoints/?format=openapi",
        "version": "3.0"
      }
    ],
    "x-providerName": "etmdb.com"
  },
  "paths": {
    "/api/v1/cinema-detail/search/{cinema_name}": {
      "get": {
        "description": "Return cinema details search result\n\n### Response Class (Status 200)\n\n* __{cinema_name}__: Used as a key word to search cinemas,\n\nFor more details on how cinemas are listed [see here][ref].\n[ref]: https://etmdb.com/en/cinema-list/-updated_date",
        "operationId": "cinema-detail_search_read",
        "parameters": [
          {
            "description": "",
            "in": "path",
            "name": "cinema_name",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": ""
          }
        },
        "summary": "Return cinema details search result",
        "tags": [
          "cinema-detail"
        ]
      }
    },
    "/api/v1/cinema-schedule/search/{movie_title}": {
      "get": {
        "description": "Return cinema schedule search result\n\n### Response Class (Status 200)\n\n* __{movie_title}__: Used as a key word to search movie cast\n* You can use both Amharic or English charset/font to search\n\nFor more details about cinema schedule, check each cinema from the cinema list [see here][ref].\n[ref]: https://etmdb.com/en/movie-list/-updated_date",
        "operationId": "cinema-schedule_search_read",
        "parameters": [
          {
            "description": "",
            "in": "path",
            "name": "movie_title",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": ""
          }
        },
        "summary": "Return cinema schedule search result",
        "tags": [
          "cinema-schedule"
        ]
      }
    },
    "/api/v1/cinema-schedule/searchall/{param}": {
      "get": {
        "description": "Return cinema schedule search result\n\n### Response Class (Status 200)\n__{param}__ argument can be\n* movie title\n* cinema name\n* cinema hall name or\n* cinema technology\n\nFor more details about cinema schedule, check each cinema from the cinema list [see here][ref].\n[ref]: https://etmdb.com/en/movie-list/-updated_date",
        "operationId": "cinema-schedule_searchall_read",
        "parameters": [
          {
            "description": "",
            "in": "path",
            "name": "param",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": ""
          }
        },
        "summary": "Return cinema schedule search result",
        "tags": [
          "cinema-schedule"
        ]
      }
    },
    "/api/v1/cinema-shedule-showtime/search/{movie_title}": {
      "get": {
        "description": "Return cinema schedule and showtime search result\n\n### Response Class (Status 200)\n* __{movie_title}__: Used as a key word to search movie cast\n* You can use both Amharic or English charset/font to search\n\nFor more details about cinema schedule showtime, check each cinema from the cinema list [see here][ref].\n[ref]: https://etmdb.com/en/movie-list/-updated_date",
        "operationId": "cinema-shedule-showtime_search_read",
        "parameters": [
          {
            "description": "",
            "in": "path",
            "name": "movie_title",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": ""
          }
        },
        "summary": "Return cinema schedule and showtime search result",
        "tags": [
          "cinema-shedule-showtime"
        ]
      }
    },
    "/api/v1/cinema-shedule-showtime/searchall/{param}": {
      "get": {
        "description": "Return cinema schedule and showtime search result\n\n### Response Class (Status 200)\n__{param}__ argument can be\n* movie title\n* cinema name\n* cinema hall name\n* showtime starting date\n* showtime ending date or\n* cinema technology\n\nFor more details about cinema schedule, check each cinema from the cinema list [see here][ref].\n[ref]: https://etmdb.com/en/movie-list/-updated_date",
        "operationId": "cinema-shedule-showtime_searchall_read",
        "parameters": [
          {
            "description": "",
            "in": "path",
            "name": "param",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": ""
          }
        },
        "summary": "Return cinema schedule and showtime search result",
        "tags": [
          "cinema-shedule-showtime"
        ]
      }
    },
    "/api/v1/cinema/search/{id}": {
      "get": {
        "description": "Return cinema search result\n\n### Response Class (Status 200)\n\n* __{id}__: Used as a key to search cinemas,\n\nFor more details on how cinemas are listed [see here][ref].\n[ref]: https://etmdb.com/en/cinema-list/-updated_date",
        "operationId": "cinema_search_read",
        "parameters": [
          {
            "description": "",
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": ""
          }
        },
        "summary": "Return cinema search result",
        "tags": [
          "cinema"
        ]
      }
    },
    "/api/v1/company-credits/search/{movie_title}": {
      "get": {
        "description": "Return company credits search result\n\n### Response Class (Status 200)\n\n* __{movie_title}__: Used as a key word to search company credits for the movie\n* You can use both Amharic or English charset/font to search\n\nFor more details on how company credits are listed [see here][ref].\n[ref]: https://etmdb.com/en/movie-list/-updated_date",
        "operationId": "company-credits_search_read",
        "parameters": [
          {
            "description": "",
            "in": "path",
            "name": "movie_title",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": ""
          }
        },
        "summary": "Return company credits search result",
        "tags": [
          "company-credits"
        ]
      }
    },
    "/api/v1/company-credits/searchall/{param}": {
      "get": {
        "description": "Return company credits search result\n\n### Response Class (Status 200)\n__{param}__ argument can be\n* company name\n* movie title or\n* company credit description (such as production, cinematography, etc)\n\nFor more details on how company credits are listed [see here][ref].\n[ref]: https://etmdb.com/en/company-list/company_name",
        "operationId": "company-credits_searchall_read",
        "parameters": [
          {
            "description": "",
            "in": "path",
            "name": "param",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": ""
          }
        },
        "summary": "Return company credits search result",
        "tags": [
          "company-credits"
        ]
      }
    },
    "/api/v1/company/search/{company_name}": {
      "get": {
        "description": "Return company search result\n\n### Response Class (Status 200)\n\n* __{company_name}__: Used as a key word to search companies,\n\nFor more details on how companies are listed [see here][ref].\n[ref]: https://etmdb.com/en/company-list/-updated_date",
        "operationId": "company_search_read",
        "parameters": [
          {
            "description": "",
            "in": "path",
            "name": "company_name",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": ""
          }
        },
        "summary": "Return company search result",
        "tags": [
          "company"
        ]
      }
    },
    "/api/v1/filmography-type/search/{filmography_description}": {
      "get": {
        "description": "Return filmography type search result\n\n### Response Class (Status 200)\n\n* __{filmography_description}__: Used as a key word to search filmography types\n\nFor more details on how filmography types are listed [see here][ref].\n[ref]: https://etmdb.com/en/movie-list/-updated_date",
        "operationId": "filmography-type_search_read",
        "parameters": [
          {
            "description": "",
            "in": "path",
            "name": "filmography_description",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": ""
          }
        },
        "summary": "Return filmography type search result",
        "tags": [
          "filmography-type"
        ]
      }
    },
    "/api/v1/filmography/search/{movie_title}": {
      "get": {
        "description": "Return filmography search result\n\n### Response Class (Status 200)\n\n* __{movie_title}__: Used as a key word to search movies\n* You can use both Amharic or English charset/font to search\n\nFor more details on how filmographies are listed [see here][ref].\n[ref]: https://etmdb.com/en/movie-list/-updated_date",
        "operationId": "filmography_search_read",
        "parameters": [
          {
            "description": "",
            "in": "path",
            "name": "movie_title",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": ""
          }
        },
        "summary": "Return filmography search result",
        "tags": [
          "filmography"
        ]
      }
    },
    "/api/v1/filmography/searchall/{param}": {
      "get": {
        "description": "Return filmography search result\n\n### Response Class (Status 200)\n__{param}__ argument can be\n* artist first name\n* artist last name\n* artist username\n* movie title or\n* filmography description (such as director, actor, producer, etc)\n\nFor more details on how filmographies are listed [see here][ref].\n[ref]: https://etmdb.com/en/movie-list/-updated_date",
        "operationId": "filmography_searchall_read",
        "parameters": [
          {
            "description": "",
            "in": "path",
            "name": "param",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": ""
          }
        },
        "summary": "Return filmography search result",
        "tags": [
          "filmography"
        ]
      }
    },
    "/api/v1/genre-type/search/{genre_description}": {
      "get": {
        "description": "Return genre type search result\n\n### Response Class (Status 200)\n\n* __{genre_description}__: Used as a key word to search genre types\n\nFor more details on how genre types are listed [see here][ref].\n[ref]: https://etmdb.com/en/movie-list/-updated_date",
        "operationId": "genre-type_search_read",
        "parameters": [
          {
            "description": "",
            "in": "path",
            "name": "genre_description",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": ""
          }
        },
        "summary": "Return genre type search result",
        "tags": [
          "genre-type"
        ]
      }
    },
    "/api/v1/genre/search/{movie_title}": {
      "get": {
        "description": "Return movie genre search result\n\n### Response Class (Status 200)\n\n* __{movie_title}__: Used as a key word to search movie genres\n* You can use both Amharic or English charset/font to search\n\nFor more details on how movies are listed [see here][ref].\n[ref]: https://etmdb.com/en/movie-list/-updated_date",
        "operationId": "genre_search_read",
        "parameters": [
          {
            "description": "",
            "in": "path",
            "name": "movie_title",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": ""
          }
        },
        "summary": "Return movie genre search result",
        "tags": [
          "genre"
        ]
      }
    },
    "/api/v1/genre/searchall/{movie_genre_type}": {
      "get": {
        "description": "Return movie genre search result\n\n### Response Class (Status 200)\n\n* __{movie_genre_type}__: Used as a key word to search movie genres\n\nFor more details on how movies are listed [see here][ref].\n[ref]: https://etmdb.com/en/movie-list/-updated_date",
        "operationId": "genre_searchall_read",
        "parameters": [
          {
            "description": "",
            "in": "path",
            "name": "movie_genre_type",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": ""
          }
        },
        "summary": "Return movie genre search result",
        "tags": [
          "genre"
        ]
      }
    },
    "/api/v1/job/search/{job_title}": {
      "get": {
        "description": "Return job details search result\n\n### Response Class (Status 200)\n\n* __{job_title}__: Used as a key word to search jobs,\n\nFor more details on how job are listed [see here][ref].\n[ref]: https://etmdb.com/en/job-list/-updated_date",
        "operationId": "job_search_read",
        "parameters": [
          {
            "description": "",
            "in": "path",
            "name": "job_title",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": ""
          }
        },
        "summary": "Return job details search result",
        "tags": [
          "job"
        ]
      }
    },
    "/api/v1/job/searchall/{company_name}": {
      "get": {
        "description": "Return job details search result\n\n### Response Class (Status 200)\n\n* __{company_name}__: Used as a key word to search jobs,\n\nFor more details on how job are listed [see here][ref].\n[ref]: https://etmdb.com/en/job-list/-updated_date",
        "operationId": "job_searchall_read",
        "parameters": [
          {
            "description": "",
            "in": "path",
            "name": "company_name",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": ""
          }
        },
        "summary": "Return job details search result",
        "tags": [
          "job"
        ]
      }
    },
    "/api/v1/media/search/{movie_title}": {
      "get": {
        "description": "Return movie media search result\n\n### Response Class (Status 200)\n\n* __{movie_title}__: Used as a key word to search media for movies\n* You can use both Amharic or English charset/font to search\n\nFor more details on how media is listed [see here][ref].\n[ref]: https://etmdb.com/en/movie-list/-updated_date",
        "operationId": "media_search_read",
        "parameters": [
          {
            "description": "",
            "in": "path",
            "name": "movie_title",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": ""
          }
        },
        "summary": "Return movie media search result",
        "tags": [
          "media"
        ]
      }
    },
    "/api/v1/media/searchall/{user}": {
      "get": {
        "description": "Return cast media search result\n\n### Response Class (Status 200)\n__{user}__ argument can be\n* artist first name\n* artist last name\n* artist username\n\nFor more details on how cast media is listed [see here][ref].\n[ref]: https://etmdb.com/en/cast-list/-updated_date",
        "operationId": "media_searchall_read",
        "parameters": [
          {
            "description": "",
            "in": "path",
            "name": "user",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": ""
          }
        },
        "summary": "Return cast media search result",
        "tags": [
          "media"
        ]
      }
    },
    "/api/v1/movie-cast/search/{movie_title}": {
      "get": {
        "description": "Return movie cast search result\n\n### Response Class (Status 200)\n\n* __{movie_title}__: Used as a key word to search movie cast\n* You can use both Amharic or English charset/font to search\n\nFor more details on how movie casts are listed [see here][ref].\n[ref]: https://etmdb.com/en/movie-list/-updated_date",
        "operationId": "movie-cast_search_read",
        "parameters": [
          {
            "description": "",
            "in": "path",
            "name": "movie_title",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": ""
          }
        },
        "summary": "Return movie cast search result",
        "tags": [
          "movie-cast"
        ]
      }
    },
    "/api/v1/movie-cast/searchall/{param}": {
      "get": {
        "description": "Return movie cast search result\n\n### Response Class (Status 200)\n__{param}__ argument can be\n* artist first name\n* artist last name\n* artist username\n* movie title or\n* character name\n\nFor more details on how movie casts are listed [see here][ref].\n[ref]: https://etmdb.com/en/movie-list/-updated_date",
        "operationId": "movie-cast_searchall_read",
        "parameters": [
          {
            "description": "",
            "in": "path",
            "name": "param",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": ""
          }
        },
        "summary": "Return movie cast search result",
        "tags": [
          "movie-cast"
        ]
      }
    },
    "/api/v1/movie/search/{movie_title}": {
      "get": {
        "description": "Return movie search result\n\n### Response Class (Status 200)\n\n* __{movie_title}__: Used as a key word to search movies\n* You can use both Amharic or English charset/font to search\n\nFor more details on how movies are listed [see here][ref].\n[ref]: https://etmdb.com/en/movie-list/-updated_date",
        "operationId": "movie_search_read",
        "parameters": [
          {
            "description": "",
            "in": "path",
            "name": "movie_title",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": ""
          }
        },
        "summary": "Return movie search result",
        "tags": [
          "movie"
        ]
      }
    },
    "/api/v1/news/search/{title}": {
      "get": {
        "description": "Return news or article search result\n\n### Response Class (Status 200)\n\n* __{title}__: Used as a key word to search news and articles,\n\nFor more details on how news & articles are listed [see here][ref].\n[ref]: https://etmdb.com/en/news-list/-updated_date",
        "operationId": "news_search_read",
        "parameters": [
          {
            "description": "",
            "in": "path",
            "name": "title",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": ""
          }
        },
        "summary": "Return news or article search result",
        "tags": [
          "news"
        ]
      }
    },
    "/api/v1/people/search/{user}": {
      "get": {
        "description": "Return cast search result\n\n### Response Class (Status 200)\n__{param}__ argument can be\n* artist first name\n* artist last name\n* artist username\n\nFor more details on how cast are listed [see here][ref].\n[ref]: https://etmdb.com/en/cast-list/-updated_date",
        "operationId": "people_search_read",
        "parameters": [
          {
            "description": "",
            "in": "path",
            "name": "user",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": ""
          }
        },
        "summary": "Return cast search result",
        "tags": [
          "people"
        ]
      }
    },
    "/api/v1/showtime/searchall/{param}": {
      "get": {
        "description": "Return showtime search result\n\n### Response Class (Status 200)\n__{param}__ argument can be\n* show time or\n* day of the week [Mon=1, Tue=2, Wed=3, Thu=4, Fri=5, Sat=6, Sun=7]\n\nFor more details about showtime, check each cinema from the cinema list [see here][ref].\n[ref]: https://etmdb.com/en/movie-list/-updated_date",
        "operationId": "showtime_searchall_read",
        "parameters": [
          {
            "description": "",
            "in": "path",
            "name": "param",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": ""
          }
        },
        "summary": "Return showtime search result",
        "tags": [
          "showtime"
        ]
      }
    },
    "/api/v1/watchlist/search/{movie_title}": {
      "get": {
        "description": "Return watchlist search result\n\n### Response Class (Status 200)\n\n* __{movie_title}__: Used as a key word to search movies on watchlist\n* You can use both Amharic or English charset/font to search\n\nFor more details on how watchlist are listed [see here][ref].\n[ref]: https://etmdb.com/en/movies/watchlist/id",
        "operationId": "watchlist_search_read",
        "parameters": [
          {
            "description": "",
            "in": "path",
            "name": "movie_title",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": ""
          }
        },
        "summary": "Return watchlist search result",
        "tags": [
          "watchlist"
        ]
      }
    },
    "/api/v1/watchlist/searchall/{param}": {
      "get": {
        "description": "Return watchlist search result\n\n### Response Class (Status 200)\n__{param}__ argument can be\n* artist first name\n* artist last name\n* artist username\n* movie title or\n\nFor more details on how watchlist are listed [see here][ref].\n[ref]: https://etmdb.com/en/movies/watchlist/id",
        "operationId": "watchlist_searchall_read",
        "parameters": [
          {
            "description": "",
            "in": "path",
            "name": "param",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": ""
          }
        },
        "summary": "Return watchlist search result",
        "tags": [
          "watchlist"
        ]
      }
    }
  },
  "components": {
    "securitySchemes": {
      "oauth2": {
        "description": "OAuth2.0 Authorization for the EtMDB API",
        "flows": {
          "authorizationCode": {
            "authorizationUrl": "https://etmdb.com/api/oauth/authorize/",
            "scopes": {
              "admin": "Grants read and write access to administrative information",
              "groups": "Grants access to groups",
              "read": "Grants read access",
              "write": "Grants write access"
            },
            "tokenUrl": "https://etmdb.com/api/oauth/token/"
          }
        },
        "type": "oauth2"
      }
    }
  }
}