API

Corsfix provides several methods to proxy your requests, giving you flexibility in how you use with the CORS Proxy.

URL as Query String

A simple way to use the proxy is by inserting the target URL as query string:

https://proxy.corsfix.com/?https://api.example.com/data
# or
https://proxy.corsfix.com/?api.example.com/data

Example Usage

fetch("https://proxy.corsfix.com/?https://api.example.com/data")
  .then((response) => response.json())
  .then((data) => console.log(data));

URL in Query Parameter (alternative)

You can also use the url query parameter to specify your target:

https://proxy.corsfix.com/?url=https://api.example.com/data
# or
https://proxy.corsfix.com/?url=api.example.com/data

Example Usage

fetch("https://proxy.corsfix.com/?url=https://api.example.com/data")
  .then((response) => response.json())
  .then((data) => console.log(data));

URL as Path (alternative)

If you prefer the shortest URL possible, you can insert the target URL directly to the path:

https://proxy.corsfix.com/https://api.example.com/data
# or
https://proxy.corsfix.com/api.example.com/data

Example Usage

fetch("https://proxy.corsfix.com/https://api.example.com/data")
  .then((response) => response.json())
  .then((data) => console.log(data));

Request Headers

Corsfix uses the Origin header to validate if your application is authorized to use the CORS proxy. This header is automatically set when sending request from the browser, such as when using Fetch, Axios, or etc.

Response Headers

The proxy automatically adds the following CORS header to the responses:

Access-Control-Allow-Origin: <your-request-origin>
Access-Control-Expose-Headers: *

Timeouts

When a request takes longer than 20 seconds to complete, the proxy will return a 504 Gateway Timeout response. This status code indicates that the server did not receive a timely response from the target server.

Payload Size

The maximum payload size for a request is 5MB. If your request exceeds this limit, the proxy will return a 413 Payload Too Large response. This status code indicates that the request is larger than the allowed size.