Web & Systems

Query String Builder

Convert a flat JSON object into a URL query string.

Read the guide

Run the tool

The calculation runs in your browser. This tool does not send your input to JVR Software.

More information

Back to the tool

What it is and when to use it

Query Builder turns individual names and values into a URL query string. It is useful for creating filter links, simple integration fixtures and documentation when some values contain spaces, ampersands or non-ASCII text that should survive the trip to a web application.

How it works

The browser serialises name and value pairs using URL query-parameter encoding. It escapes characters belonging to the data and inserts the ampersands and equals signs that form the query structure. Spaces can appear as plus signs under this standard representation.

How to use it

  1. Enter a flat JSON object with parameter names as keys and simple values.
  2. Generate the query and attach it to the destination using the appropriate separator.
  3. Parse the final URL to check that each name and value arrived as intended.

Worked example

Enter a q field for Graphic Design & Layout and a city field for Cape Town. The output escapes the ampersand inside the job phrase, allowing the receiving app to distinguish that ampersand from the separator between q and city.

Reading the result

Preserve the whole generated value for each field. To add parameters to an existing URL, consider each field already present. Insert them before any fragment and follow the application’s rules for repeating a name. A URL library can manage those steps during automated link generation.

Common mistakes and limits

Query parameters can be visible in browser history, proxy logs and links. Keep sensitive content in the appropriate authenticated request mechanism instead. Confirm whether your destination expects repeated keys, array brackets or another structure when sending multiple values for one filter.