Developer API

Base URL

https://api.menascreendb.com/api/v1

Authenticate with a bearer key (Authorization: Bearer msdb_live_…). Errors follow RFC 7807; pagination is cursor-based; every response carries an X-MSDB-API version header plus X-RateLimit-Limit/X-RateLimit-Remaining (per-key read and write budgets; a 429 includes Retry-After). Keys carry scopes — read endpoints need read:public; write endpoints list their scope below. Everything written through the API lands in the unverified lane with provenance and is publicly visible with its trust status — being first never bypasses being honest. TMDB-sourced fields are attributed per TMDB terms.

Endpoints

• GET/api/v1/search?q=
  Search titles and people (any spelling, any script).
• GET/api/v1/autocomplete?q=
  Fast prefix + fuzzy suggestions.
• GET/api/v1/discover
  Faceted browse: type/country/genre/status/platform/year filters, facet counts, cursor.
• GET/api/v1/projects/{id}
  A title with its fields, rating summary, trust status, and provenance.
• GET/api/v1/projects/{id}/credits
  Full cast & crew for a title.
• GET/api/v1/projects/{id}/artwork
  Approved artwork (self-hosted URLs, licence per row).
• GET/api/v1/projects/{id}/availability
  Where a title streams/plays, per region.
• GET/api/v1/people/{id}
  A person record with known-for titles. Merged records answer 308 → keeper.
• GET/api/v1/people/{id}/credits
  A person’s filmography.
• GET/api/v1/companies/{id}
  A production/distribution company.
• GET/api/v1/external-ids/resolve
  Resolve an external ID (Wikidata, TMDB…) to a record.
• POST/api/v1/search/semanticread:embeddings
  Embedding-similarity search ("what is this ABOUT"). Live on the site as the "closest we have" band; see /benchmark for the measured recall.
• GET/api/v1/projects/{id}/embeddingread:embeddings
  A title’s 1024-dim voyage-3 vector.
• GET/api/v1/people/{id}/embeddingread:embeddings
  A person’s 1024-dim voyage-3 vector.
• GET/api/v1/meta/coverage
  Coverage metrics.
• GET/api/v1/meta/freshness
  Freshness / first-listed latency metrics.
• GET/api/v1/meta/attribution
  Machine-readable source attribution requirements.
• GET/api/v1/health
  Liveness + API version (unauthenticated).
• POST/api/v1/productionswrite:productions
  Pre-release registration — list your production first (unverified lane).
• POST/api/v1/creditswrite:credits
  Attach a verified-consumer credit assertion (unverified lane).
• POST/api/v1/claimswrite:claims
  Person claims a profile via a vouching consumer.
• POST/api/v1/gap-ticketswrite:gap_tickets
  Report a missing title/person or a correction.
• POST/api/v1/artwork/upload-intentwrite:artwork
  Rights-holder artwork upload (moderated before serving).

Access

API keys are issued to licensed consumers. To request access, contact corrections@menascreendb.com. Read more about sourcing and attribution on the About page.