How do you access the query string in Flask routes?

Naveera A.

The Problem

How do you access the query string in Flask routes?

The Solution

Query strings are usually made of query parameters. Flask provides an out-of-the-box solution to access parsed query parameters. In most cases, accessing query parameters is enough. But if you want to access the query string itself, you can do so by accessing the query_string property of the request object.

Difference Between Query String and Query Parameters

Adding a query string to the URL is a common way to pass data to a web app. The query string is made up of arbitrary keys and values that are added to the URL after a question mark (?) character.

For example, in the following URL:

http://example.com?language=python

The query string is language=python. Inside our app, we refer to ‘language’ as a query parameter and ‘python’ as its value.

Query parameters can be separated by an ampersand (&) character, like so:

http://example.com/?language=python&framework=flask

Request Object

Flask provides a request object that contains all sorts of information about the current HTTP request.

For example, you can access the complete URL with the query string by accessing the url property. Like so:

# import main Flask class and request object from flask import Flask, request # create the Flask app app = Flask(__name__) @app.route('/') def query_example(): print(request.url) # request.url property return 'Query String Example' if __name__ == '__main__': app.run(debug=True, port=5000)

If you run the above code, and send a request to

http://127.0.0.1:5000/?language=python&framework=flask

You will get the following output on your terminal:

http://127.0.0.1:5000/?language=python&framework=flask

Accessing Query String

If you want just the query string, you can access it like so:

print(request.query_string)

You will get the following output:

b'language=python&framework=flask'

This is the raw value of the query string. The preferred way to access the query parameters is to use the args property:

print(request.args.get('framework'))

Loved by over 4 million developers and more than 90,000 organizations worldwide, Sentry provides code-level observability to many of the world’s best-known companies like Disney, Peloton, Cloudflare, Eventbrite, Slack, Supercell, and Rockstar Games. Each month we process billions of exceptions from the most popular products on the internet.

Share on Twitter
Bookmark this page
Ask a questionJoin the discussion

Related Answers

A better experience for your users. An easier life for your developers.

    TwitterGitHubDribbbleLinkedinDiscord
© 2024 • Sentry is a registered Trademark
of Functional Software, Inc.