# goodrecmovies public API API

**Canonical:** https://apis.io/apis/goodrecmovies-com/goodrecmovies-public-api-api/  
**Provider:** goodrecmovies — https://apis.io/providers/goodrecmovies-com/  
**Base URL:** https://goodrecmovies.com  
**Documentation:** https://goodrecmovies.com/docs

goodrecmovies public API API is one of 2 APIs that [goodrecmovies](https://apis.io/providers/goodrecmovies-com/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. The published artifact set on APIs.io includes an OpenAPI specification.

Read-only access to the goodrecmovies ranking (only the good stuff, zero filler). Versioning policy: the current version is served at /api/*; breaking changes move to /api/v2/* with this spec updated first — no breaking change ships in place. Deprecation policy: when an endpoint or version is schedu

## Operations (4)

| Method | Path | Summary |
|---|---|---|
| GET | `/api/list` | Ranked titles, best first |
| GET | `/api/search` | Fuzzy title and people search |
| POST | `/api/movies/batch` | Fetch up to 100 titles by IMDb id |
| POST | `/ask` | Natural-language question over the ranking (NLWeb) |

## Machine-readable artifacts (1)

- **OpenAPI** — https://artifacts.apis.io/goodrecmovies-com/openapi/_original/goodrecmovies-com-api-openapi.json

## Other goodrecmovies APIs (1)

- [goodrecmovies API](https://apis.io/apis/goodrecmovies-com/goodrecmovies-api/)

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/goodrecmovies-com/goodrecmovies-public-api-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/goodrecmovies-com/.
