Community web service (operated under the IMDb-API / TV-API brand) providing movie, TV series and cast information in JSON. Aggregates data from IMDb, TheMovieDb, Wikipedia, Rotten Tomatoes, Metacritic, TheTVDB, FilmAffinity and YouTube. Originally hosted at imdb-api.com and migrated to tv-api.com. Operated by the IMDb-API GitHub user (open source C# client library and Windows client app). NOT an official IMDb / Amazon product — IMDb itself does not expose a public API; community scrapers such as this one (alongside OMDb, TMDB and Apify's IMDb scraper) fill the gap.
IMDb-API publishes 6 API contracts indexed on the APIs.io network, including External API, Lists API, Name API, and 3 more. Tagged areas include Video, Movies, TV, Entertainment, and Metadata.
The IMDb-API catalog on APIs.io includes 1 JSON-LD context and 2 Spectral governance rulesets.
IMDb-API’s developer surface includes engineering blog, authentication, pricing, signup flow, tooling, and 15 more developer resources.
Regulatory Posture applies to this provider. Its tags matched the
Horizontal (data, software, accessibility, platform) regime, so
Regulatory Posture carries 15 points of the composite.
If this regime is wrong for your business, say so on your
provider repo — the
applicability map is public and we will correct it.
Create-or-Update Ergonomics does not apply to this provider. The published contracts declare
no write operations, and a read-only API cannot create-or-update. The facet is excluded from this provider's
denominator entirely — not scored zero. A reference or data API is not deficient for being unable to
upsert.
The six quality facets above are damped to 85 points between them,
because the conditional facet above carries the other
15. That is why each facet's contribution is shown against a damped
maximum: raising a quality facet moves the composite by 85% of its nominal
weight, not 100%. The full arithmetic is at apis.io/rating/.
Show this score on your site.
It updates itself when the score changes. Paste this where you link to your API docs:
<a href="https://apis.io/providers/imdb-api/"><img src="https://apis.io/badge/imdb-api/card.svg" alt="IMDb-API on APIs.io — Kin Score by API Evangelist"></a>
Other styles, a README pill and a shields.io endpoint are on the badge page.
Raise your score.
Agent readiness — checks not met, largest first (exact, from this profile):
MCP Server+12 pts — deployment.mode + probe verdict on the mcp/ manifest, not the pointer; an unprobed slug falls back to authorship
Stable Error Semantics+8 pts — OpenAPI $refs a shared error schema across 4xx/5xx responses (verified), else common[].type includes ErrorCatalog / ErrorCodes / DeclineCodes
A2A Agent Card+8 pts — a2a/-a2a.yml manifest, graded on conformance.grade against A2A 1.0.0
Delegated User Identity+6 pts — a served discovery document listing authorization_code in grant_types_supported (served), else an oauth2 authorizationCode flow or openIdConnect declared in an OpenAPI (documented)
Typed Event Surface+6 pts — AsyncAPI document, OR webhooks/callbacks objects in the as-published OpenAPI, OR common[].type includes Webhooks
6 more unmet checks in the Agent Readiness table above.
Kin Score — facets with the most composite points still available (weight × headroom):
The Kin Score Market layer reads a provider inside its market:
its position, and how deep its integrations go. Depth is only comparable within a position. Provisional and unweighted:
not part of the Kin Score or agent readiness.
Registered MCP server and declares compatibility are report only — not weighted.
Undeclared means we found nothing we can read, so there is no number: we never infer integrations.
Standards this provider implements or carries. De facto ones are profiled and measured by the API Commons; formal ones come from the standards directory and are linked by the provider's own tags. The evidence column says how each claim was established — not that it was made.
aid: imdb-api
name: IMDb-API
description: Community web service (operated under the IMDb-API / TV-API brand) providing movie, TV series and cast information
in JSON. Aggregates data from IMDb, TheMovieDb, Wikipedia, Rotten Tomatoes, Metacritic, TheTVDB, FilmAffinity and YouTube.
Originally hosted at imdb-api.com and migrated to tv-api.com. Operated by the IMDb-API GitHub user (open source C# client
library and Windows client app). NOT an official IMDb / Amazon product — IMDb itself does not expose a public API; community
scrapers such as this one (alongside OMDb, TMDB and Apify's IMDb scraper) fill the gap.
url: https://tv-api.com/
deliveryModel:
model: saas
license_evidence:
not_product:
- imdb-api/imdbapiclient
- imdb-api/imdbapilib
open_source: unknown
commercial: true
callable_host: true
label: Hosted service · you call their endpoint
confidence: low
source:
- openapi
- pricing
- repository-not-product
generated: '2026-09-25'
method: derived
accessModel:
pricing: freemium
onboarding: self-serve
trial: false
try_now: true
public: false
gated: none
gated_source:
- onboarding
label: Freemium · Self-serve signup
confidence: medium
source:
- plans
- authentication
- security
generated: '2026-11-06'
method: derived
image: https://tv-api.com/images/original/Apple-TV-Plus-Logo.png
humanURL: https://tv-api.com/
baseURL: https://tv-api.com/
specificationVersion: '0.23'
created: '2026-05-28'
modified: '2026-10-06'
x-source: public-apis/public-apis
x-category: Video
x-tier: 2
x-tier-reason: enriched-with-real-openapi-and-pricing
tags:
- Video
- Movies
- TV
- Entertainment
- Metadata
- Ratings
- Public APIs
apis:
- aid: imdb-api:imdb-api-external-api
name: IMDb-API External API
description: Wikipedia, external sites, reviews, FAQ and other ancillary data.
humanURL: https://tv-api.com/
baseURL: https://imdb-api.com
tags:
- External
properties:
- type: OpenAPI
url: openapi/imdb-api-external-api-openapi.yml
- type: Documentation
url: https://tv-api.com/api
- type: APIReference
url: https://tv-api.com/api
- type: Signup
url: https://tv-api.com/Identity/Account/Register
- type: Authentication
url: https://tv-api.com/api#authentication
- type: JSONSchema
url: json-schema/imdb-api-title-schema.json
- type: JSONSchema
url: json-schema/imdb-api-rating-schema.json
- type: JSONSchema
url: json-schema/imdb-api-name-schema.json
- type: JSONSchema
url: json-schema/imdb-api-search-result-schema.json
- type: JSONSchema
url: json-schema/imdb-api-usage-schema.json
- type: JSONStructure
url: json-structure/imdb-api-title-structure.json
- type: JSONStructure
url: json-structure/imdb-api-rating-structure.json
- type: JSONStructure
url: json-structure/imdb-api-name-structure.json
- type: JSONLD
url: json-ld/imdb-api-context.jsonld
- type: Examples
url: examples/imdb-api-search-example.json
- type: Examples
url: examples/imdb-api-title-example.json
- type: Examples
url: examples/imdb-api-ratings-example.json
- type: Examples
url: examples/imdb-api-fullcast-example.json
- type: Examples
url: examples/imdb-api-top250movies-example.json
- type: Examples
url: examples/imdb-api-usage-example.json
- type: RateLimits
url: rate-limits/imdb-api-rate-limits.yml
- type: Plans
url: plans/imdb-api-plans-pricing.yml
- aid: imdb-api:imdb-api-lists-api
name: IMDb-API Lists API
description: Curated and aggregated lists (Top 250, Most Popular, In Theaters, Coming Soon, Box Office).
humanURL: https://tv-api.com/
baseURL: https://imdb-api.com
tags:
- List
tags_raw:
- Lists
properties:
- type: OpenAPI
url: openapi/imdb-api-lists-api-openapi.yml
- type: Documentation
url: https://tv-api.com/api
- type: APIReference
url: https://tv-api.com/api
- type: Signup
url: https://tv-api.com/Identity/Account/Register
- type: Authentication
url: https://tv-api.com/api#authentication
- type: JSONSchema
url: json-schema/imdb-api-title-schema.json
- type: JSONSchema
url: json-schema/imdb-api-rating-schema.json
- type: JSONSchema
url: json-schema/imdb-api-name-schema.json
- type: JSONSchema
url: json-schema/imdb-api-search-result-schema.json
- type: JSONSchema
url: json-schema/imdb-api-usage-schema.json
- type: JSONStructure
url: json-structure/imdb-api-title-structure.json
- type: JSONStructure
url: json-structure/imdb-api-rating-structure.json
- type: JSONStructure
url: json-structure/imdb-api-name-structure.json
- type: JSONLD
url: json-ld/imdb-api-context.jsonld
- type: Examples
url: examples/imdb-api-search-example.json
- type: Examples
url: examples/imdb-api-title-example.json
- type: Examples
url: examples/imdb-api-ratings-example.json
- type: Examples
url: examples/imdb-api-fullcast-example.json
- type: Examples
url: examples/imdb-api-top250movies-example.json
- type: Examples
url: examples/imdb-api-usage-example.json
- type: RateLimits
url: rate-limits/imdb-api-rate-limits.yml
- type: Plans
url: plans/imdb-api-plans-pricing.yml
- aid: imdb-api:imdb-api-name-api
name: IMDb-API Name API
description: People (actors, directors, writers) information and awards.
humanURL: https://tv-api.com/
baseURL: https://imdb-api.com
tags:
- Name
properties:
- type: OpenAPI
url: openapi/imdb-api-name-api-openapi.yml
- type: Documentation
url: https://tv-api.com/api
- type: APIReference
url: https://tv-api.com/api
- type: Signup
url: https://tv-api.com/Identity/Account/Register
- type: Authentication
url: https://tv-api.com/api#authentication
- type: JSONSchema
url: json-schema/imdb-api-title-schema.json
- type: JSONSchema
url: json-schema/imdb-api-rating-schema.json
- type: JSONSchema
url: json-schema/imdb-api-name-schema.json
- type: JSONSchema
url: json-schema/imdb-api-search-result-schema.json
- type: JSONSchema
url: json-schema/imdb-api-usage-schema.json
- type: JSONStructure
url: json-structure/imdb-api-title-structure.json
- type: JSONStructure
url: json-structure/imdb-api-rating-structure.json
- type: JSONStructure
url: json-structure/imdb-api-name-structure.json
- type: JSONLD
url: json-ld/imdb-api-context.jsonld
- type: Examples
url: examples/imdb-api-search-example.json
- type: Examples
url: examples/imdb-api-title-example.json
- type: Examples
url: examples/imdb-api-ratings-example.json
- type: Examples
url: examples/imdb-api-fullcast-example.json
- type: Examples
url: examples/imdb-api-top250movies-example.json
- type: Examples
url: examples/imdb-api-usage-example.json
- type: RateLimits
url: rate-limits/imdb-api-rate-limits.yml
- type: Plans
url: plans/imdb-api-plans-pricing.yml
- aid: imdb-api:imdb-api-search-api
name: IMDb-API Search API
description: Free-text and faceted search across titles, names, companies and keywords.
humanURL: https://tv-api.com/
baseURL: https://imdb-api.com
tags:
- Search
properties:
- type: OpenAPI
url: openapi/imdb-api-search-api-openapi.yml
- type: Documentation
url: https://tv-api.com/api
- type: APIReference
url: https://tv-api.com/api
- type: Signup
url: https://tv-api.com/Identity/Account/Register
- type: Authentication
url: https://tv-api.com/api#authentication
- type: JSONSchema
url: json-schema/imdb-api-title-schema.json
- type: JSONSchema
url: json-schema/imdb-api-rating-schema.json
- type: JSONSchema
url: json-schema/imdb-api-name-schema.json
- type: JSONSchema
url: json-schema/imdb-api-search-result-schema.json
- type: JSONSchema
url: json-schema/imdb-api-usage-schema.json
- type: JSONStructure
url: json-structure/imdb-api-title-structure.json
- type: JSONStructure
url: json-structure/imdb-api-rating-structure.json
- type: JSONStructure
url: json-structure/imdb-api-name-structure.json
- type: JSONLD
url: json-ld/imdb-api-context.jsonld
- type: Examples
url: examples/imdb-api-search-example.json
- type: Examples
url: examples/imdb-api-title-example.json
- type: Examples
url: examples/imdb-api-ratings-example.json
- type: Examples
url: examples/imdb-api-fullcast-example.json
- type: Examples
url: examples/imdb-api-top250movies-example.json
- type: Examples
url: examples/imdb-api-usage-example.json
- type: RateLimits
url: rate-limits/imdb-api-rate-limits.yml
- type: Plans
url: plans/imdb-api-plans-pricing.yml
- aid: imdb-api:imdb-api-title-api
name: IMDb-API Title API
description: Movie and series metadata, posters, images, trailers, cast, ratings.
humanURL: https://tv-api.com/
baseURL: https://imdb-api.com
tags:
- Title
properties:
- type: OpenAPI
url: openapi/imdb-api-title-api-openapi.yml
- type: Documentation
url: https://tv-api.com/api
- type: APIReference
url: https://tv-api.com/api
- type: Signup
url: https://tv-api.com/Identity/Account/Register
- type: Authentication
url: https://tv-api.com/api#authentication
- type: JSONSchema
url: json-schema/imdb-api-title-schema.json
- type: JSONSchema
url: json-schema/imdb-api-rating-schema.json
- type: JSONSchema
url: json-schema/imdb-api-name-schema.json
- type: JSONSchema
url: json-schema/imdb-api-search-result-schema.json
- type: JSONSchema
url: json-schema/imdb-api-usage-schema.json
- type: JSONStructure
url: json-structure/imdb-api-title-structure.json
- type: JSONStructure
url: json-structure/imdb-api-rating-structure.json
- type: JSONStructure
url: json-structure/imdb-api-name-structure.json
- type: JSONLD
url: json-ld/imdb-api-context.jsonld
- type: Examples
url: examples/imdb-api-search-example.json
- type: Examples
url: examples/imdb-api-title-example.json
- type: Examples
url: examples/imdb-api-ratings-example.json
- type: Examples
url: examples/imdb-api-fullcast-example.json
- type: Examples
url: examples/imdb-api-top250movies-example.json
- type: Examples
url: examples/imdb-api-usage-example.json
- type: RateLimits
url: rate-limits/imdb-api-rate-limits.yml
- type: Plans
url: plans/imdb-api-plans-pricing.yml
- aid: imdb-api:imdb-api-tools-api
name: IMDb-API Tools API
description: Image utilities and account usage.
humanURL: https://tv-api.com/
baseURL: https://imdb-api.com
tags:
- Tools
properties:
- type: OpenAPI
url: openapi/imdb-api-tools-api-openapi.yml
- type: Documentation
url: https://tv-api.com/api
- type: APIReference
url: https://tv-api.com/api
- type: Signup
url: https://tv-api.com/Identity/Account/Register
- type: Authentication
url: https://tv-api.com/api#authentication
- type: JSONSchema
url: json-schema/imdb-api-title-schema.json
- type: JSONSchema
url: json-schema/imdb-api-rating-schema.json
- type: JSONSchema
url: json-schema/imdb-api-name-schema.json
- type: JSONSchema
url: json-schema/imdb-api-search-result-schema.json
- type: JSONSchema
url: json-schema/imdb-api-usage-schema.json
- type: JSONStructure
url: json-structure/imdb-api-title-structure.json
- type: JSONStructure
url: json-structure/imdb-api-rating-structure.json
- type: JSONStructure
url: json-structure/imdb-api-name-structure.json
- type: JSONLD
url: json-ld/imdb-api-context.jsonld
- type: Examples
url: examples/imdb-api-search-example.json
- type: Examples
url: examples/imdb-api-title-example.json
- type: Examples
url: examples/imdb-api-ratings-example.json
- type: Examples
url: examples/imdb-api-fullcast-example.json
- type: Examples
url: examples/imdb-api-top250movies-example.json
- type: Examples
url: examples/imdb-api-usage-example.json
- type: RateLimits
url: rate-limits/imdb-api-rate-limits.yml
- type: Plans
url: plans/imdb-api-plans-pricing.yml
common:
- url: https://tv-api.com/blog/
type: Blog
- type: IssueTracker
url: https://github.com/IMDb-API/IMDbApiLib/issues
- type: AgenticAccess
url: agentic-access/imdb-api-agentic-access.yml
- type: DomainSecurity
url: security/imdb-api-domain-security.yml
- type: Authentication
url: authentication/imdb-api-authentication.yml
- type: Website
url: https://tv-api.com/
- type: LegacyWebsite
url: https://imdb-api.com/
- type: Pricing
url: https://tv-api.com/pricing
- type: Signup
url: https://tv-api.com/Identity/Account/Register
- type: GitHubOrganization
url: https://github.com/IMDb-API
- type: GitHubRepository
url: https://github.com/IMDb-API/IMDbApiLib
- type: GitHubRepository
url: https://github.com/IMDb-API/IMDbApiClient
- type: SDKs
name: IMDbApiLib (C# / NuGet)
url: https://github.com/IMDb-API/IMDbApiLib
- type: Client
name: IMDbApiClient (Windows desktop)
url: https://github.com/IMDb-API/IMDbApiClient
- type: PublicAPIsListing
url: https://github.com/public-apis/public-apis
- type: SpectralRules
url: rules/imdb-api-rules.yml
- type: Vocabulary
url: vocabulary/imdb-api-vocabulary.yml
- type: Plans
url: plans/imdb-api-plans-pricing.yml
- type: RateLimits
url: rate-limits/imdb-api-rate-limits.yml
- type: FinOps
url: finops/imdb-api-finops.yml
- type: Features
data:
- name: Title metadata
description: Full movie / series / episode metadata by IMDb tt-id.
- name: Aggregated ratings
description: IMDb, Metacritic, Rotten Tomatoes, TMDB and FilmAffinity scores in a single response.
- name: Full cast and crew
description: Directors, writers, actors and other crew with IMDb nm-ids.
- name: Search
description: Title, movie, series, name, episode, company and keyword search; plus faceted advanced search.
- name: Curated lists
description: Top 250 movies and TV, Most Popular, In Theaters, Coming Soon, Weekend & All-Time Box Office.
- name: Media assets
description: Posters, image galleries, trailers and YouTube trailer URLs.
- name: External links
description: Cross-platform identifiers (Netflix, FilmAffinity, TheTVDB) and Wikipedia plot summaries.
- name: Reviews
description: User reviews and Metacritic critic reviews.
- name: Image utilities
description: Server-side resize for arbitrary URLs and preset-token poster resizing.
- name: Usage telemetry
description: Per-key daily quota consumption via /API/Usage.
- type: UseCases
data:
- name: Media catalog enrichment
description: Hydrate an in-house movie or TV catalog with posters, plots, cast and ratings.
- name: Recommendation systems
description: Drive what-to-watch suggestions from Top 250, Most Popular and similar-titles signals.
- name: Review aggregation
description: Surface IMDb, Metacritic and Rotten Tomatoes scores in a single UI.
- name: Box office dashboards
description: Track weekend and all-time box office performance.
- name: Entertainment chatbots
description: Answer movie and cast questions from a conversational agent.
- type: Integrations
data:
- name: IMDb
description: Primary source of title and name ids.
- name: TheMovieDb (TMDB)
description: Source of secondary ratings and additional metadata.
- name: Rotten Tomatoes
description: Critic and audience scores.
- name: Metacritic
description: Metascore and critic reviews.
- name: FilmAffinity
description: Community ratings.
- name: TheTVDB
description: External TV id linkage.
- name: Wikipedia
description: Plot summaries and PlotLocal in multiple languages.
- name: YouTube
description: Trailer video resolution.
- name: Apify
description: Alternative IMDb data path documented in the broader ecosystem.
- name: OMDb API
description: Adjacent community IMDb wrapper consumers often compare.
- type: Solutions
data:
- name: Free tier
description: 100 requests/day for hobbyists and prototypes.
- name: Standard / Plus
description: Small-to-growing applications (5k-10k requests/day).
- name: Premium
description: Production applications (30k-999k requests/day, unlimited IP authorizations).
- type: Tools
data:
- name: IMDbApiLib (NuGet)
description: Official C# wrapper maintained in the IMDb-API GitHub org.
- name: IMDbApiClient
description: Free Windows desktop client app exercising the API.
maintainers:
- FN: Kin Lane
email: kin@apievangelist.com
IMDb-API — frequently asked questions
Does IMDb-API have an API?
Yes. APIs.io lists 6 APIs from IMDb-API, including IMDb-API External API, IMDb-API Lists API and IMDb-API Name API, and 3 more.
Is there an OpenAPI specification for the IMDb-API?
Yes. APIs.io indexes 6 OpenAPI specifications for IMDb-API, each linked for download from this page.
How do I authenticate with the IMDb-API?
IMDb-API uses bearer-token authentication (apiKey · 1 scheme). The details are profiled on APIs.io as Imdb Api Authentication.
How much does the IMDb-API cost?
IMDb-API publishes its prices; its Free plan is 0 requests per day as of 2026-10-28. APIs.io lists 4 pricing plans for IMDb-API, with each plan's price, limits and inclusions under Pricing on this page.
Is the IMDb-API ready for AI agents?
IMDb-API has a Kin Score of 47.2 out of 100 (developing) and an Agent Readiness score of 23.1 (agent-aware), scored by API Evangelist on 2026-11-06.
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.
Kin Score
How this is scored →
It updates itself when the score changes. Paste this where you link to your API docs: