hey is a modern, lightweight HTTP load testing tool designed to help you benchmark and stress test your web
applications, APIs, and HTTP servers.
hey sends a specified number of HTTP requests to a target URL with configurable concurrency levels, providing detailed
performance metrics and statistics. It's ideal for:
- API performance testing
- Load testing web applications
- Stress testing HTTP servers
- Benchmarking response times
- Identifying performance bottlenecks
Download latest package from Releases
hey https://example.com/- Configurable request count and concurrency
- Support for HTTP/2
- Custom HTTP methods and headers
- Request body from string or file
- Rate limiting
- Request timeouts
- Basic authentication
- HTTP proxy support
- CSV output format for further analysis
- Customizable connection options
hey [options...] <url>
| Flag | Description |
|---|---|
-n | Number of requests to run (default: 200) |
-c | Concurrent workers (default: 50) |
-q | Rate limit in QPS per worker (default: no limit) |
-z | Duration to send requests (e.g., -z 10s, -z 3m) |
-o | Output format (csv or default summary) |
-m | HTTP method (GET, POST, PUT, DELETE, HEAD, OPTIONS) |
-H | Custom HTTP header (repeatable) |
-t | Request timeout in seconds (default: 20, 0 for infinite) |
-A | HTTP Accept header |
-d | HTTP request body |
-D | HTTP request body from file |
-T | Content-type (default: "text/html") |
-a | Basic authentication (username:password) |
-x | HTTP proxy address (host:port) |
-s | SOCKS5 proxy address (host:port) |
-h2 | Enable HTTP/2 |
-host | HTTP Host header |
-disable-compression | Disable compression |
-disable-keepalive | Disable keep-alive |
-disable-redirects | Disable following HTTP redirects |
-cpus | Number of CPU cores to use |
Basic use:
hey -n 1000 -c 100 https://example.com/POST request with body:
hey -m POST -d '{"key":"value"}' -T "application/json" https://api.example.com/resourceUsing HTTP/2 with custom headers:
hey -h2 -H "Authorization: Bearer token" https://api.example.com/hey came from rakyll/hey and was originally inspired by this
tool tarekziade/boom.