jsschools

req.query

An object of the parsed URL query string parameters.

Since Express 4 Spec ↗

Syntax

req.query

Returns

object — Parsed query parameters; values are strings, arrays, or nested objects.

Examples

// GET /search?q=node&page=2
app.get('/search', (req, res) => {
  res.json({ q: req.query.q, page: Number(req.query.page) });
});
Output 
{"q":"node","page":2}

// GET /items?tag=a&tag=b
app.get('/items', (req, res) => {
  res.send(Array.isArray(req.query.tag) ? req.query.tag.join() : req.query.tag);
});
Output 
a,b

Notes

In Express 5 `req.query` is a read-only getter and defaults to the simple parser; repeated keys become arrays. Never trust query input in DB queries or `eval`. Coerce types explicitly - everything arrives as a string.

See also