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. If rich is installed, JSON, HTML, and XML bodies are syntax highlighted. 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 when rich is installed. Without rich, the download is written with plain text output. 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