404 is a successful query and will be charged, failed requests such as 503, 429 meanwhile won't be.
404 is a successful query and will be charged, failed requests such as 503, 429 meanwhile won't be.

/ faq

Why Do We Charge Credits for 404s?

Subscribe to our newsletter

Get the latest news from Proxycurl

In our API, a 404 is considered a successful query, despite being classified as an error code. You can check our API reference manual sections on credits and status codes for official documentation at any time, but here we will explain the why of this policy.

When a request comes in, we don't know if it will be a typical success (200) or missing (404). We have to do work on our servers to run a query, and only then can we return a status code to you. Assuming our query runs successfully and we determine if data exists or not, we'll forward that existence status, along with all available data (which may be nothing), and charge you accordingly.

Should your request fail for any reason, we will never bill you for a failure such as 503 (service unavailable), 429 (rate limited), etc. But 404 means a successful query that did work on our servers and successfully returned nothing.

Subscribe to our newsletter

Get the latest news from Proxycurl

Featured Articles

Here’s what we’ve been up to recently.