All-in-one Collaborative API Development Platform

API Design

API Documentation

API Debugging

API Mock

API Automated Testing

Sign up for free

What is X www form URL-encoded Requests

Start for free
Home / Basic Knowledge / What is X www form URL-encoded Requests

What is X www form URL-encoded Requests

Unlocking the intricacies of data transmission, we delve into the realm of "X www form URL-encoded Requests." In this article, we unravel the significance and application of this encoding method, shedding light on its role in secure and efficient data exchange over the web.

URL-encoded requests involve encoding data in the URL or request body to ensure that special characters are represented in a format that is safe and easily transmitted over the web. This encoding is commonly used when making HTTP requests, particularly with the application/x-www-form-urlencoded media type.

In Apidog, when sending data in the body of a POST request, you can choose the "x-www-form-urlencoded" option as the data format. This is particularly useful when you need to simulate form submissions or interact with APIs that expect data in the URL-encoded format.

In a URL-encoded request, data is formatted as key-value pairs, separated by "&" characters. Each key and value are URL-encoded, meaning that special characters are replaced with a percent sign "%" followed by two hexadecimal digits. Additionally, spaces may be encoded as "+" characters.

For example, consider a simple form with the fields "username" and "password." If a user submits the form with the username "user123" and the password "pass@word," the data may be URL-encoded as follows:


This encoded string can be included in the URL for a GET request or in the body of a POST request with the application/x-www-form-urlencoded content type.

What is Content Type URL-encoded Form Data?

The content type "application/x-www-form-urlencoded" is used to specify the media type for URL-encoded form data when sending it in the body of an HTTP request, typically with the POST method. This content type is widely used when submitting forms on the web.

When a form is submitted with this content type, the form data is encoded in a specific way. Each field-value pair in the form is separated by an ampersand (&) character, and special characters in both the field names and values are percent-encoded. Spaces may be encoded as plus (+) characters.

Here's an example:

Suppose you have a form with two fields: "username" and "password," and a user submits the form with the values "user123" for the username and "pass@word" for the password. The encoded form data would look like this:


In the above example:

  • The equal sign (=) separates each field from its corresponding value.
  • The ampersand (&) separates different key-value pairs.
  • The %40 represents the percent-encoded form of the at symbol (@) in the password.

When the server receives this data, it can decode it to retrieve the original form values. This encoding is necessary to ensure that the data is transmitted safely over the web, as it may contain special characters that have reserved meanings in URLs or could be misinterpreted if not properly encoded.

Differences between HTTP body form data and X www form URL-encoded

HTTP body form data and x-www-form-urlencoded are terms associated with sending form data in an HTTP request.

HTTP body form data refers to the information transmitted in the body of an HTTP request when submitting form-like data to a server. This can encompass various content types, including JSON, XML, or the traditional form-urlencoded format. The choice of content type depends on the specific requirements of the application.

On the other hand, x-www-form-urlencoded is a specific content type (application/x-www-form-urlencoded) used to encode form data in the body of an HTTP request. In this format, data is URL-encoded, with key-value pairs separated by "&" characters. This encoding is particularly useful for submitting simple text/ASCII data, although it has limitations when dealing with large binary or non-ASCII text.

x-www-form-urlencoded in Apidog

Using x-www-form-urlencoded in Apidog allows you to easily simulate form submissions by specifying key-value pairs as you would in a traditional HTML form.

This is especially valuable when testing APIs that expect data in this specific format, such as when interacting with web forms or processing form data on the server.