Whenever your have a doubt use man. Issue man curl and read about -d switch.-d, -data (HTTP) Sends the specified data in a POST request to the HTTP cause curl to pass the data to the server using the content-type -d, -data is the same as -data-ascii.data-raw is almost the ter. When telling curl to do something, you invoke curl with zero, one or several command-line options to accompany the URL or set of URLs you want the transfer to be about. The above curl syntax assumes that the endpoint contains request body parameters. If the desired endpoint does not contain a request body, then you should use the following syntax: curl -sk -X HTTPMethod Replace this variable with the desired endpoint's HTTP method.
What is CURL ?
CURL is a tool for data transfer. It is also available as a library for developers and as a CLI for terminal-based use cases. Both have the same engine inside (Truth is that CLI tool is just the program that uses the library under the hood).
@tom-wijsman explanation: curl -X POST implies an HTTP POST request, the -d parameter (long version: -data) tells curl that what follows will be POST parameters, and @filename designates the contents of the file filename as parameter. This approach works best with RESTful HTTP APIs as found at Twitter, Facebook, various other web services including Ruby on Rails as well as HTTP APIs of. If the parameter is to contain white spaces, the parameter must be inclosed within quotes. If the first column of a config line is a '#' character, the rest of the line will be treated as a comment. Specify the filename as '-' to make curl read the file from stdin.
CURL works with every protocol you might have used. Head over this site to check whether CURL works with your target protocol or not.
What CURL can do?
Hmm… Everything that is related to data transfer. Everyone must have used a browser. Even now, you are reading this article through your browser. What browser does, it requests a page and gets it as a response. It can write and read cookies. And then it renders(displaying the content, images and executing JS scripts) it.
CURL can do everything a browser except for the last part rendering because it is not related to data transfer.
As wrap up, CURL can download HTML pages, fill HTML forms and submit them, download files from a FTP/HTTP server and upload files to the same and read/write cookies.
This makes it an excellent tool to be used in scripting, debugging and forensic analysis etc.
Curl command examples
Let’s see what can you do with Curl.
1. Get a response from a server
Everything from server is a response to the request. So getting a HTML page is same as downloading a file.
To get a HTML response from http://info.cern.c,
To get the list of posts as a response from a server ( https://jsonplaceholder.typicode.com/posts),
Since we know how to get a response from a server, you can download a file ( say Google logo ).
Above command will dump binary image data which you can’t view in the terminal. You need to save them and then use a photo viewer to see them.
Note that various option flags can be placed anywhere on the command instead of the strict ordering. So no worry if you placed any option in the last while the examples had the flag in the beginning.
2. Save the file with a default file name
Every file that is served on the internet has a filename. To use the same filename as the downloaded filename use -O flag.
3. Save the file with custom name
To save the filename with your own custom name, use -o flag followed (strictly) by a custom name.
Curl Command Parameters
4. Download multiple files
To download multiple files, separate them with a white space.
If you want to use -O flag for all the URL’s, use
The same workaround should be done for any flag. This is because the first occurrence of a certain flag is for the first URL, the second flag is for the second URL and so on.
5. Download a range of files
curl has the in-built ability to download a range of files from the server. This can be illustrated from the following example.
Above command downloads files from logo1.png, logo2.png, logo3.png and up to logo9.png.
6. Download a file only if latest
To download a file only if the file’s modification time is latest than the given time.
7. Resume Downloading
If you have already partially transferred a file, you can resume the transfer by using the -C flag. Offset from which transfer needs to be continued should be passed as a parameter to the -C flag.
8. Upload a file
To upload a file to the server, one needs to use -T flag followed by the file path on your local system.
9. Delete a file
To delete a file named deleteFile.txt in a server, one can use -X flag which is intended for any HTTP verb/method(like GET, POST, PUT, DELETE, PATCH). Most of the FTP servers will have configured DELETE method if not all advanced HTTP methods.
You can also modify the above command for any HTTP method to do the corresponding task. For Example, if your server allows TRUNCATE method ( this is made-up HTTP method, not a standard one) which removes only the content in the file and not the file, one can use the command similar to the below one.
Above mentioned are the main uses of curl. But there might be difficulties which needed to be fought such as redirects, user authentication, SSL certificates, etc., We can call them add-ons as they are only optional but still remain crucial for certain purposes. Let’s see some of those addons and how to handle it with curl in the next section.
10. Avoid redirects
When you request http://www.google.com , you will be served only the regional page such as www.google.co.in. This is done with the help of redirects (HTTP packets with status codes in the range 300-399).
You can avoid redirects with the option L.
11. Authentication
When the server is configured to serve for only certain individuals with credentials, they will be provided with username and password. One can make login with the help of -u flag.
12. Limit data transfer
If you want to impose a data transfer limit use –limit-rate flag. Following command tries to download the file with rate limit as 10K.
13. Show/Hide transfer Status
If the response is redirected from the terminal such as downloading, uploading then curl automatically shows the status/progress meter for the transfer.
If you do not want to see the progress meter, just append the command with -s flag. Progress will not be shown for response directed for the terminal.
14. Ignore SSL certificates
Do you remember the situations in which you need to give security certificate exception to visit some websites? If you trust the sources and you want to do a data transfer, you can ignore SSL certificate validation by using -k flag.
15. Get Header Information also
To display the header information along with transferred data, use the -i flag.
16. Get Header information Only
If you want only the headers and not the data, use the -I flag
17. Change User Agent
Some websites and servers don’t allow certain kinds of devices to access their systems. But how do they know that we are using a specific kind of device? This is due to the User-Agent HTTP header field. We can change this User Agent with -A flag.
Curl Query Parameters
18. Sending data to the Server
If the server needs some data such as token or API key, use -d flag to send the data. Data that needs to be sent should follow the flag in the command. One can use “&” to combine multiple data. This is usually done by GET and POST requests in browsers. This is one of the ways by which you can send your form information.
19. Write Cookies to a File
Cookies are some small information that allows maintaining a session with a stateless HTTP protocol. If you want to know more about Cookies, refer to this great resource.
To write cookies to a file, -c flag followed by the cookie filename should be used.
20. Reading Cookies from a File
To read a cookie from the file, -b flag followed by cookie filename can be used.
Note that -b flag only reads the cookie from the file. So if the server resends another cookie, you might need to use -c option to write them.
21. Start a new Session
If you want to initiate a new session by discarding the cookies, use -j flag. It starts a new session even if you have provided the cookie file to read with -b flag.
Congratulations! You made it to the end. If you find this article useful, share it with your friends and follow us on Social media. If you have any suggestions about this article or any other topic, feel free to drop them below.
Become a Member for FREE
Curl Parameters -i
Join the conversation.