Options¶

Content type flags¶

Flag	Description
`--json`, `-j`	Serialize data items as JSON (default)
`--form`, `-f`	Serialize data items as form fields
`--multipart`	Force multipart form data

Output control¶

When connected to a terminal, the default output includes response headers and body with syntax highlighting (JSON, HTML, XML). When piped, only the body is printed as plain text.

Flag	Description
`--verbose`, `-v`	Print request headers, request body, response headers, and response body
`--headers`	Print response headers only
`--body`, `-b`	Print response body only
`--print`, `-p`	Fine-grained control using a string of characters: `H` (request headers), `B` (request body), `h` (response headers), `b` (response body). Example: `--print=Hh` for headers only.

# Headers only
curl-cffi get --headers https://httpbin.org/get

# Body only (no headers)
curl-cffi get --body https://httpbin.org/get

# Full verbose output
curl-cffi post -v https://httpbin.org/post name=test

# Custom: request headers + response headers
curl-cffi get -p Hh https://httpbin.org/get

Download¶

Downloads display a progress bar with transfer speed. Filenames are automatically sanitized to remove unsafe characters.

Flag	Description
`--download`, `-d`	Download response body to a file (filename from `Content-Disposition` header or URL path)
`--output`, `-o`	Specify output file path

# Download a file
curl-cffi get --download https://example.com/file.zip

# Download to a specific path
curl-cffi get --download -o myfile.zip https://example.com/file.zip

Connection options¶

Flag	Description
`--auth`, `-a`	HTTP authentication (`user:password`)
`--verify` / `--no-verify`	Enable/disable SSL certificate verification (default: enabled)
`--proxy`	Proxy URL
`--timeout`	Request timeout in seconds
`--follow` / `--no-follow`	Follow/don’t follow redirects (default: follow)
`--max-redirects`	Maximum number of redirects (default: 30)

# Basic auth
curl-cffi get -a user:password https://httpbin.org/basic-auth/user/password

# Skip SSL verification
curl-cffi get --no-verify https://self-signed.example.com

# Use a proxy
curl-cffi get --proxy http://proxy:8080 https://httpbin.org/get

# Set timeout
curl-cffi get --timeout 5 https://httpbin.org/delay/3

Browser impersonation¶

Flag	Description
`--impersonate`, `-i`	Browser to impersonate (default: `chrome`)

# Impersonate Chrome (default)
curl-cffi get https://tls.browserleaks.com/json

# Impersonate Safari
curl-cffi get -i safari https://tls.browserleaks.com/json

# Impersonate Firefox
curl-cffi get -i firefox https://tls.browserleaks.com/json