Skip to content

req

4,781 1 94 MIT
v3.57.0 (16 Dec 2025) Nov 20 2023 58.1 thousand (month)

The Go library "req" is a simple and easy-to-use library for making HTTP requests in Go. It is designed to make working with HTTP requests as simple as possible, by providing a clean and consistent API for handling various types of requests, including GET, POST, PUT, and DELETE.

One of the key features of req is its support for handling JSON data. The library automatically serializes and deserializes JSON data, making it easy to work with JSON data in your Go applications. Additionally, it supports multipart file uploads and automatic decompression of gzip and deflate encoded responses.

req also includes a number of convenience functions for working with common HTTP request types, such as sending GET and POST requests, handling redirects, and setting headers and query parameters. The library can also be easily extended with custom middleware and request handlers.

Overall, req is a powerful and flexible library that makes it easy to work with HTTP requests in Go. It is well-documented and actively maintained, making it a great choice for any Go project that needs to work with HTTP requests.

Example Use


```go req.DevMode() // Use Client.DevMode to enable debugging details

// There are 2 ways to use req (like many other http clients) // First way is to create a persistent session client: client := req.C(). // defaults like timeout and headers can be set for the whole session SetUserAgent("my-custom-client"). SetTimeout(5 * time.Second) // defaults can be overriden and extended in each request resp, err := client.R(). // Use R() to create a request and set with chainable request settings. SetHeader("Accept", "application/vnd.github.v3+json"). SetPathParam("username", "imroc"). SetQueryParam("page", "1"). SetResult(&result). // Unmarshal response into struct automatically if status code >= 200 and <= 299. SetError(&errMsg). // Unmarshal response into struct automatically if status code >= 400. EnableDump(). // Enable dump at request level to help troubleshoot, log content only when an unexpected exception occurs. Get("https://api.github.com/users/{username}/repos")

// Alternatively, it can be used as is without establishing a client

resp := client.Get("https://api.github.com/users/{username}/repos"). // Create a GET request with specified URL. SetHeader("Accept", "application/vnd.github.v3+json"). SetPathParam("username", "imroc"). SetQueryParam("page", "1"). SetResult(&result). SetError(&errMsg). EnableDump(). Do() // Send request with Do. ```

Alternatives / Similar


11,632 v2.17.2 (2026-02-14 22:43:18 ago) Aug 05 2024 compare

Other Languages

53,883 2.33.1 (2026-03-30 16:09:13 ago) Feb 14 2011 compare
8,860 3.3.2 (2023-11-30 14:10:12 ago) Dec 28 2012 compare
15,183 0.28.1 (2024-12-06 15:37:21 ago) Jul 26 2019 compare
16,395 3.13.5 (2026-03-31 21:56:30 ago) Jul 26 2019 compare
108,987 1.15.0 (2026-04-08 16:09:38 ago) Aug 29 2014 compare
got
14,897 15.0.1 (2026-04-08 16:15:35 ago) Mar 27 2014 compare
5,944 v0.6.1 (2024-03-02 18:08:29 ago) Feb 23 2022 compare
1,631 3.5.0 (2026-03-12 22:24:55 ago) Dec 11 2011 compare
16,610 10.1.1 (2024-10-22 17:26:05 ago) Aug 22 2011 compare
primp new
504 1.2.2 (2026-04-03 07:11:15 ago) Jun 01 2024 compare
5,927 2.14.1 (2026-02-07 15:17:15 ago) Dec 19 2009 compare
1,147 7.45.7 (2025-09-24 13:35:56 ago) Feb 25 2003 compare
1,172 1.4.2 (2026-03-20 19:18:25 ago) Oct 31 2009 compare
707 2.9.0 (2025-02-22 01:13:49 ago) Jul 25 2009 compare
5,889 0.24.2 (2026-01-14 22:54:36 ago) Jul 25 2009 compare
4,131 1.6.0 (2026-03-10 12:58:26 ago) Oct 06 2009 compare
985 1.4.8 (2023-08-15 11:00:00 ago) May 06 2012 compare
1,751 0.7.1 (2024-07-13 09:07:25 ago) Feb 23 2022 compare
23,447 7.10.0 (2025-08-23 22:36:01 ago) Nov 14 2011 compare
1,517 1.0.5 (2024-02-12 21:10:00 ago) Nov 22 2014 compare
378 18.1.0 (2025-07-24 23:01:15 ago) Aug 06 2011 compare
1,219 1.1.7 (2020-08-31 21:38:00 ago) Oct 25 2009 compare
2,033 v8.0.8 (2026-03-30 15:14:47 ago) Apr 28 2019 compare
mechanize new
4,440 2.14.0 (2025-01-05 18:30:46 ago) Jul 25 2009 compare
605 25.5.0 (2025-06-03 03:42:30 ago) Dec 28 2012 compare
908 1.1.3 (2026-03-05 00:04:35 ago) Sep 25 2013 compare
505 1.1.4 (2020-02-07 22:04:51 ago) Apr 20 2010 compare
1,001 0.9.2 (2024-12-01 02:55:27 ago) Feb 23 2022 compare
107 1.6.0 (2024-07-19 19:50:00 ago) Nov 09 2016 compare
3,577 v2.0.17 (2025-12-12 17:47:19 ago) Oct 06 2013 compare
1,924 1.3.0 (2024-09-23 13:16:34 ago) Nov 11 2011 compare
1,803 1.0.0 (2024-05-01 11:33:16 ago) Apr 14 2012 compare
165 2.3.0 (2021-03-18 00:10:00 ago) Dec 22 2019 compare
3,104 0.17.0 (2026-03-25 01:20:02 ago) Mar 20 2015 compare
Was this page helpful?