Blog

By javinfo team

API redesign: /query and /movie replace /search

The old /search endpoint is deprecated. Use /query for lists and /movie for single results. Cleaner semantics, lower cost, and explicit source control.

POST /search is being replaced by two endpoints: POST /query and POST /movie. The old endpoint still works but is deprecated.

The problem with /search was it did two different things. Sometimes it returned a list of matches for a broad search; sometimes it returned a single record when the code was exact. That ambiguity made writing predictable clients harder than it needed to be.

Now there’s no ambiguity:

The request body format didn’t change. Just the URL. The providers field now also accepts a comma-separated string in addition to a JSON array. Migrating is a URL swap.

The split fixed a pricing inconsistency too. Broad searches are cheaper because they return less data. Full movie lookups cost more because they aggregate across providers. Either way, you only pay for HTTP 200. Failures are free.

/search currently routes to /query internally. It will be removed in the next release. For the full API spec, see javinfo.dev/llms.txt.

GoalOld endpointNew endpoint
Broad query, want a list/search (deprecated)POST /query
Exact code, want full details/search (deprecated)POST /movie