Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Linkup Research is live — ranked #1 on the SealQA-0 benchmark. Try it →
Linkup API errors and how to handle them
statusCode: number - HTTP error code.
error: object - Linkup error details containing:
code: string - Error namemessage: string - Description of the errordetails: array - Details of the error. This array may be empty or include objects with the following properties:
field: string - The field that caused the errormessage: string - A description of the field error{
"statusCode": 400,
"error": {
"code": "VALIDATION_ERROR",
"message": "Validation failed",
"details": [
{
"field": "outputType",
"message": "outputType must be one of the following values: sourcedAnswer, searchResults, structured"
}
]
}
}
| Code | Possible Reasons |
|---|---|
400 - Bad Request |
|
401 - Unauthorized | API Key is missing or invalid |
402 - Payment Required | x402 payment signature is missing, invalid, or settlement failed. See x402 docs |
403 - Forbidden | API key does not have permission to access this resource |
409 - Conflict | Resource conflict (e.g., duplicate entry or conflicting request) |
429 - Too Many Requests | You have run out of credit or you are sending too many concurrent requests |
500 - Internal Server Error | Something’s up on our end |
| Type | Reason |
|---|---|
LinkupInvalidRequestError | Required parameter is missing, or invalid parameter |
LinkupNoResultError | Search query yields no result |
LinkupAuthenticationError | API Key is missing, invalid or you do not have permission to access this resource |
LinkupInsufficientCreditError | You have run out of credit |
LinkupTooManyRequestsError | You are sending too many concurrent requests |
LinkupFetchError | The provided URL might not be found or can’t be fetched |
LinkupFetchResponseTooLargeError | The provided URL’s response is too large to be processed (>20MB) |
LinkupFetchUnsupportedContentTypeError | The URL returned a content type that cannot be processed (e.g. binary, media) |
LinkupUnknownError | Anything else |