The Database Talks Back
Hollywood Metrics has always been a data platform. 20,391 films. 100 years of cinema. 1.1 million critic reviews. Twenty measurable screenplay features per script. All of it indexed, searchable, and cross-referenced.
But until now, accessing that data meant using our dashboard. Today, we are opening the full database via a REST API that any AI assistant, automation tool, or custom application can talk to directly.
This is not a chatbot. This is a structured, queryable interface to the most comprehensive cinema analytics database available anywhere. Your AI tools query our endpoints. Our endpoints return precise, structured data. The AI interprets it in context. No hallucination. No approximation. Real numbers from real films.
What You Can Query
The API exposes every dataset in the platform:
- 158,000+ films with ratings, box office, budgets, genres, cast, crew, and our proprietary Master Score
- 4,800+ analyzed screenplays with 20 quantitative features (scene count, dialogue ratio, vocabulary richness, sentiment arc, and more)
- Quality tier predictions for any screenplay via our Random Forest classifier
- Comparable film analysis based on budget, genre, cast, and keyword similarity
- Box office intelligence including current releases, trending data, and social sentiment
- 90+ screenwriter style guides for AI-powered screenplay rewrites
Rate Limits by Plan
API access is available on paid plans only:
| Plan | Daily API Calls | Price |
|---|---|---|
| Free / Creative | 1 request/day (sign-in required) | Free |
| Writer | 10 requests/day | $9/month |
| Producer | 100 requests/day | $99/month |
| Studio | 10,000 requests/day | $999/month |
How It Works With AI Assistants
The API is designed for integration with any AI tool that supports external data sources. The workflow is simple:
- Get your API key from the Dashboard (API tab)
- Point your AI tool at our OpenAPI spec:
https://hollywoodmetrics.ai/openapi.json - Start querying. Ask questions in natural language. Your AI translates them into API calls. Our endpoints return structured data. The AI interprets the results.
A screenwriter working on a period horror film can, in a single conversation, analyze their screenplay's structural features, find comparable films that succeeded at the box office, look up the cinematography styles most associated with the genre, and identify which budget range historically produces the best ROI for that specific category. That is four separate research tasks completed in about thirty seconds of conversation.
This is what it looks like when a database stops being a product you visit and starts being a capability your tools possess. The data goes where you work, not the other way around.
Getting Started
The API is live now. The OpenAPI spec is at https://hollywoodmetrics.ai/openapi.json. Your API key is waiting in the dashboard's API tab.
Set up takes five minutes. The first query takes five seconds. Everything after that is just you and your AI assistant having a very well-informed conversation about cinema.
API documentation is available in the Dashboard under the API tab, or at hollywoodmetrics.ai/api-docs.