What We Shipped
Today we are launching the Hollywood Metrics REST API, a programmatic interface to the same data and intelligence that powers our dashboard. This is not a toy. It is 90+ endpoints backed by 74,571 films, 4,800+ analyzed screenplays, 6,000 craft profiles, and a machine learning prediction engine trained on a century of cinema.
The Numbers
| Metric | Value |
|---|---|
| Total Endpoints | 90+ |
| Films Indexed | 74,571 |
| Screenplays Analyzed | 4,800+ |
| Craft Profiles | 6,000 (actors, directors, writers, DPs) |
| Script Metrics | 20 quantitative features |
| Screenwriter Styles | 90+ |
| Posters Analyzed | 54,000+ |
| Rate Limit (Producer) | 200 requests/day |
| Rate Limit (Studio) | 10,000 requests/day |
What You Can Do
Film Intelligence
Query any film in our database by title, genre, decade, director, minimum rating, or master score. Every response includes IMDb rating, Rotten Tomatoes score, worldwide gross, budget, ROI, Oscar nominations and wins, and our composite Master Score. Sort by any field. Filter to exactly what you need. Request only the fields that matter to your application.
Screenplay Analysis
Send raw screenplay text and get back 20 quantitative features (scene count, dialogue ratio, sentiment arc, vocabulary richness, and 16 more), a quality tier prediction (S through E), and probability distributions across all tiers. Our prediction model was trained on 4,800+ professionally produced scripts.
Batch Processing
Submit up to 10 scripts in a single request. Get per-script results with individual error handling. Built for production pipelines where you need to process entire development slates programmatically.
Script CRUD
Save, retrieve, update, and delete your script analyses through the API. Your analyses persist across sessions. Build your own script tracking system on top of our data.
Forge Drafts
The Story Forge generates 8 deliverables from a single premise. Now you can save drafts mid-generation and resume later. No more losing 20 minutes of output because you closed a tab.
Workshop Notes
Sparring partner feedback, oracle responses, and workshop diagnostics now persist. Every conversation thread is saved and retrievable by script ID.
Craft Universe
Access 6,000 profiles across actors (500), directors (1,770+), cinematographers (710+), and screenwriters (2,900+). Every profile includes TMDB photos, biographies, filmographies with poster images, career statistics, and technique breakdowns.
Poster Intelligence
54,000+ movie posters analyzed for visual composition, mood, color palette, typography, and design quality. Submit your own poster for instant analysis.
Security
Every API call is authenticated. Rate limits are enforced per key via Firestore (persistent across deploys). Token verification uses Firebase Admin SDK with cryptographic signature validation. Credentials are encrypted at rest with AES-256-GCM. Path traversal protection on all file endpoints. Request body size limits on all proxies. CORS restricted to our domain.
Pricing
The API is available on Producer ($99/month, 200 requests/day) and Studio ($999/month, 10,000 requests/day) plans. Both include batch analysis, script CRUD, forge drafts, and workshop notes. Studio adds bulk processing, team workspace, and dedicated support.
Get Started
Generate your API key in the dashboard, read the docs at /api, and start building. Every endpoint is documented with request/response examples, authentication guides, and SDK snippets.
The data is ready. The endpoints are live. Build something.
