Error Handling

The API returns standard HTTP status codes and JSON error objects for failed requests.

• 404 Not Found:

  • Returned when the requested resource (e.g., lyrics or horoscope) is not found.

  • Example:

    {
      "error": "LYRICS_NOT_FOUND"
    }

    json Copy Copied!

    or

    {
      "error": "HOROSCOPE_NOT_FOUND"
    }

    json Copy Copied!

• 400 Bad Request: May be returned for invalid query parameters (e.g., missing q for /lyrics or invalid horoscope value).

Always check the error field in the response to handle errors programmatically.