Rate limits and error handling

Refer to our list of error codes, rate limits, and ingestion limits for troubleshooting help.

Rate limits

To ensure stability and performance, the LoudCrowd Storefront API enforces rate limits on all endpoints. These limits help prevent excessive traffic bursts while maintaining a reliable experience for all users.

How Rate Limits Work

  • All endpoints are rate limited – If you exceed the allowed request rate, you will receive a 429 Too Many Requests response.
  • Rate limits are account-wide – All requests made by a single account contribute to a shared limit, regardless of the endpoint.

Requesting a Limit Increase

If your application requires a higher rate limit, you can request an increase by contacting our sales team at [email protected].


Errors

Our API uses conventional HTTP response codes to indicate success or failure of an API request. Errors typically fall into three ranges:

  • 2xx - Success
  • 4xx - Error as a result of information provided as part of the request, such as a requested object that doesn't exist, an invalid setting, etc.
  • 5xx - Error due to LoudCrowd
    The response of all API errors contain a message parameter which has developer-facing information about why the request failed.

See the table below for a list of error codes and their corresponding descriptions:


CodeSummaryDescription
200OKThe request completed successfully.
400Bad RequestRequest is missing or has a bad parameter
401Not AuthorizedKey is valid, but the account does not have permissions to perform this action.
403ForbiddenRequest is missing or has an invalid API key
404Not FoundThe requested resource doesn't exist.
429Rate LimitYou hit the rate limit for this account. All endpoints share the same rate limit for an account.
500Server ErrorSomething is wrong on LoudCrowd's end.
503Bad GatewayService unavailable.