168

I am trying to convert a Python dictionary to a string for use as URL parameters. I am sure that there is a better, more Pythonic way of doing this. What is it?

x = ""
for key, val in {'a':'A', 'b':'B'}.items():
    x += "%s=%s&" %(key,val)
x = x[:-1]
0

5 Answers 5

318

Use urllib.parse.urlencode(). It takes a dictionary of key-value pairs, and converts it into a form suitable for a URL (e.g., key1=val1&key2=val2).

For your example:

>>> import urllib.parse
>>> params = {'a':'A', 'b':'B'}
>>> urllib.parse.urlencode(params)
'a=A&b=B'

If you want to make a URL with repetitive params such as: p=1&p=2&p=3 you have two options:

>>> a = (('p',1),('p',2), ('p', 3))
>>> urllib.parse.urlencode(a)
'p=1&p=2&p=3'

or:

>>> urllib.parse.urlencode({'p': [1, 2, 3]}, doseq=True)
'p=1&p=2&p=3'

If you are still using Python 2, use urllib.urlencode().

4
  • 4
    if you want to make a url with repetitive params for example: ?p=1&p=2&p=3 then a = (('p',1),('p',2), ('p', 3)); urllib.urlencode(a) the result is 'p=1&p=2&p=3'
    – panchicore
    Jun 27, 2012 at 17:05
  • 7
    Another way to get repetitive params: urllib.urlencode({'p': [1, 2, 3]}, doseq=True) resulting in 'p=1&p=2&p=3'.
    – mbaechtold
    Apr 16, 2014 at 10:51
  • If you wonder what doeseq is about: "If any values in the query arg are sequences and doseq is true, each sequence element is converted to a separate parameter." Sep 14, 2017 at 9:43
  • 8
    Python3 users: urllib.parse.urlencode()
    – Olshansky
    Mar 15, 2021 at 0:03
39

For python 3, the urllib library has changed a bit, now you have to do:

from urllib.parse import urlencode


params = {'a':'A', 'b':'B'}

urlencode(params)
0
21

Here is the correct way of using it in Python 3.

from urllib.parse import urlencode
params = {'a':'A', 'b':'B'}
print(urlencode(params))
2
  • Since python 2 is now deprecated I would accept this answer but stack overflow is preventing me from changing the accepted answer.
    – kzh
    Dec 11, 2021 at 16:42
  • 1
    How is this different from my answer which was ~ a year earlier before this one?
    – Newskooler
    Aug 13, 2022 at 8:06
3

Use the 3rd party Python url manipulation library furl:

f = furl.furl('')
f.args = {'a':'A', 'b':'B'}
print(f.url) # prints ... '?a=A&b=B'

If you want repetitive parameters, you can do the following:

f = furl.furl('')
f.args = [('a', 'A'), ('b', 'B'),('b', 'B2')]
print(f.url) # prints ... '?a=A&b=B&b=B2'
2
  • Where do I get furl? It appears not to be a standard library Mar 27, 2017 at 20:34
  • 1
    pip install furl Its not a part of standard library Apr 4, 2017 at 11:41
-10

This seems a bit more Pythonic to me, and doesn't use any other modules:

x = '&'.join(["{}={}".format(k, v) for k, v in {'a':'A', 'b':'B'}.items()])
1
  • 19
    This won't percent encode the parameters properly. This will create unexpected results if your data includes ampersands, equals, hash symbols, etc. May 22, 2017 at 10:26

Your Answer

Reminder: Answers generated by Artificial Intelligence tools are not allowed on Stack Overflow. Learn more

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge that you have read and understand our privacy policy and code of conduct.

Not the answer you're looking for? Browse other questions tagged or ask your own question.