fix: handle fetch target not found errors

src/linkup/__init__.py

@@ -4,6 +4,7 @@
     LinkupBudgetLimitExceededError,
     LinkupFailedFetchError,
     LinkupFetchResponseTooLargeError,
+    LinkupFetchTargetNotFoundError,
     LinkupFetchTargetUnreachableError,
     LinkupFetchUnsupportedContentTypeError,
     LinkupFetchUrlIsFileError,
@@ -52,6 +53,7 @@
 FetchImageExtraction = LinkupFetchImageExtraction
 FetchResponse = LinkupFetchResponse
 FetchResponseTooLargeError = LinkupFetchResponseTooLargeError
+FetchTargetNotFoundError = LinkupFetchTargetNotFoundError
 FetchTargetUnreachableError = LinkupFetchTargetUnreachableError
 FetchUnsupportedContentTypeError = LinkupFetchUnsupportedContentTypeError
 FetchTask = LinkupFetchTask
@@ -93,6 +95,7 @@
     "FetchImageExtraction",
     "FetchResponse",
     "FetchResponseTooLargeError",
+    "FetchTargetNotFoundError",
     "FetchTargetUnreachableError",
     "FetchTask",
     "FetchTaskInput",
@@ -109,6 +112,7 @@
     "LinkupFetchImageExtraction",
     "LinkupFetchResponse",
     "LinkupFetchResponseTooLargeError",
+    "LinkupFetchTargetNotFoundError",
     "LinkupFetchTargetUnreachableError",
     "LinkupFetchTask",
     "LinkupFetchTaskInput",

src/linkup/_client.py

@@ -14,6 +14,7 @@
     LinkupBudgetLimitExceededError,
     LinkupFailedFetchError,
     LinkupFetchResponseTooLargeError,
+    LinkupFetchTargetNotFoundError,
     LinkupFetchTargetUnreachableError,
     LinkupFetchUnsupportedContentTypeError,
     LinkupFetchUrlIsFileError,
@@ -1030,8 +1031,9 @@ def fetch(
 
         Raises:
             LinkupInvalidRequestError: If the provided URL is not valid.
-            LinkupFailedFetchError: If the provided URL is not found or can't be fetched.
+            LinkupFailedFetchError: If the provided URL can't be fetched.
             LinkupFetchResponseTooLargeError: If the fetch response is too large.
+            LinkupFetchTargetNotFoundError: If the target URL is not found.
             LinkupFetchTargetUnreachableError: If the target URL cannot be reached.
             LinkupFetchUnsupportedContentTypeError: If the URL resolves to an unsupported content
                 type.
@@ -1090,8 +1092,9 @@ async def async_fetch(
 
         Raises:
             LinkupInvalidRequestError: If the provided URL is not valid.
-            LinkupFailedFetchError: If the provided URL is not found or can't be fetched.
+            LinkupFailedFetchError: If the provided URL can't be fetched.
             LinkupFetchResponseTooLargeError: If the fetch response is too large.
+            LinkupFetchTargetNotFoundError: If the target URL is not found.
             LinkupFetchTargetUnreachableError: If the target URL cannot be reached.
             LinkupFetchUnsupportedContentTypeError: If the URL resolves to an unsupported content
                 type.
@@ -1338,6 +1341,12 @@ def _raise_linkup_error(self, response: httpx.Response) -> None:
                         "The provided URL's response is too large to be processed.\n"
                         f"Original error message: {error_msg}."
                     )
+                if code == "FETCH_TARGET_NOT_FOUND":
+                    raise LinkupFetchTargetNotFoundError(
+                        "The Linkup API returned a fetch target not found error (400). "
+                        "The target URL was not found.\n"
+                        f"Original error message: {error_msg}."
+                    )
                 if code == "FETCH_TARGET_UNREACHABLE":
                     raise LinkupFetchTargetUnreachableError(
                         "The Linkup API returned a fetch target unreachable error (400). "

src/linkup/_errors.py

@@ -82,6 +82,15 @@ class LinkupFetchResponseTooLargeError(Exception):
     pass
 
 
+class LinkupFetchTargetNotFoundError(Exception):
+    """Fetch target not found error.
+
+    Raised when the API reports that the target URL was not found.
+    """
+
+    pass
+
+
 class LinkupFetchTargetUnreachableError(Exception):
     """Fetch target unreachable error, raised when the Linkup API returns a 400 status code.
 

tests/unit/client_test.py

@@ -1122,6 +1122,19 @@ async def test_async_fetch(
         """,
         linkup.FetchResponseTooLargeError,
     ),
+    (
+        400,
+        b"""
+        {
+            "error": {
+                "code": "FETCH_TARGET_NOT_FOUND",
+                "message": "The target URL was not found",
+                "details": []
+            }
+        }
+        """,
+        linkup.FetchTargetNotFoundError,
+    ),
     (
         400,
         b"""