Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

IMDb-API Search API

Free-text and faceted search across titles, names, companies and keywords.

IMDb-API Search API is one of 6 APIs that IMDb-API publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 8 JSON Schema definitions.

Tagged areas include Search. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, authentication docs, a JSON-LD context, rate-limit docs, and 8 JSON Schemas.

This API exposes 7 operations across 7 paths, and defines 3 schemas. It is described by OpenAPI 3.1.0, at version 1.0.0.

Requests are made against 2 base URLs: https://tv-api.com, https://imdb-api.com.

7 operations 7 paths 3 schemas 7 GET

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
1.0.0
Base URL
https://tv-api.com/
Authentication
API Key
Contact
Resource Areas
1

Authentication & Security 1

IMDb-API Search API declares 1 security scheme for authenticating requests. An API key is passed in the query as apiKey (ApiKeyInPath). By default, every request must be authenticated.

  • ApiKeyInPath — API key issued at https://tv-api.com after sign-up. Embedded directly in the request path for most endpoints.

Paths & Operations 7

Across 7 paths, the API surfaces 7 operations — 7 GET. Each is listed below with its method, path, parameters, and response codes.

Search 7

Free-text and faceted search across titles, names, companies and keywords.

GET
/{lang}/API/Search/{apiKey}/{expression}
Search Titles, Names And Companies
search 3 params → 200
GET
/{lang}/API/SearchMovie/{apiKey}/{expression}
Search Movies
searchMovie 3 params → 200
GET
/{lang}/API/SearchSeries/{apiKey}/{expression}
Search TV Series
searchSeries 3 params → 200
GET
/{lang}/API/SearchName/{apiKey}/{expression}
Search People
searchName 3 params → 200
GET
/{lang}/API/SearchEpisode/{apiKey}/{expression}
Search Episodes
searchEpisode 3 params → 200
GET
/{lang}/API/SearchCompany/{apiKey}/{expression}
Search Companies
searchCompany 3 params → 200
GET
/{lang}/API/AdvancedSearch/{apiKey}
Advanced Search
advancedSearch 8 params → 200

Schemas 3

The contract defines 3 schemas that model the data the API accepts and returns. The most detailed are SearchResult (5 properties), SearchData (4 properties), AdvancedSearchData (2 properties). Each schema is shown below with its type and property counts.

AdvancedSearchData
object
2 properties
SearchResult
object
5 properties
SearchData
object
4 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

imdb-api-search-api-openapi.yml Raw ↑

Other APIs IMDb-API publishes across the network.

IMDb-API External API
IMDb-API Lists API
IMDb-API Name API
IMDb-API Title API
IMDb-API Tools API