POST /search está siendo reemplazado por dos endpoints: POST /query y POST /movie. El antiguo endpoint sigue funcionando pero está obsoleto.
El problema con /search es que hacía dos cosas diferentes. A veces devolvía una lista de coincidencias para una búsqueda amplia; a veces devolvía un único registro cuando el código era exacto. Esa ambigüedad dificultaba escribir clientes predecibles.
Ahora no hay ambigüedad:
POST /querydevuelve una lista de coincidencias ($0.0002/llamada). Úsalo cuando tengas un nombre de actriz, un título parcial o un estudio. Cada resultado tieneid,dvdId,title,coveryreleaseDate.POST /moviedevuelve un único registro completo normalizado ($0.001/resultado). Mismo cuerpoq+providers, pero devuelve el mejor resultado con todos los campos.
El formato del cuerpo de la solicitud no cambió. Solo la URL. El campo providers ahora también acepta una cadena separada por comas además de un array JSON. Migrar es solo cambiar la URL.
La división también solucionó una inconsistencia de precios. Las búsquedas amplias son más baratas porque devuelven menos datos. Las búsquedas completas cuestan más porque agregan metadatos de múltiples proveedores. De cualquier forma, solo pagas por HTTP 200. Los fallos son gratis.
/search actualmente redirige a /query internamente. Se eliminará en la próxima versión. Para la especificación completa de la API, consulta javinfo.dev/llms.txt.
| Objetivo | Endpoint antiguo | Nuevo endpoint |
|---|---|---|
| Consulta amplia, quiero una lista | /search (obsoleto) | POST /query |
| Código exacto, quiero detalles completos | /search (obsoleto) | POST /movie |