Add rate limiting for caching

**Problem**
When working with api, the error messages could be more descriptive.

**Suggestion**
Improve error handling and add detailed error messages.

**Context**
This would help with debugging and maintenance.

The issue names no files, tests, or entry points. Start by locating the API caching implementation and its existing error-handling tests; confirm whether the intended change is rate limiting, more descriptive API errors, or both, then define tests that demonstrate the agreed behavior.

Written by the indexing model from the issue text.