Python 101: How to submit a web form

Posted by Mike on June 8th, 2012 filed in Python, Web

Today we’ll spend some time looking at three different ways to make Python submit a web form. In this case, we will be doing a web search with searching on the term “python” and saving the result as an HTML file. We will use Python’s included urllib modules and two 3rd party packages: requests and mechanize. We have three small scripts to cover, so let’s get cracking!

Submitting a web form with urllib

We will start with urllib and urllib2 since they are included in Python’s standard library. We’ll also import the webbrowser to open the search results for viewing. Here’s the code:

import urllib
import urllib2
import webbrowser
data = urllib.urlencode({'q': 'Python'})
url = ''
full_url = url + '?' + data
response = urllib2.urlopen(full_url)
with open("results.html", "w") as f:

The first thing you have to do when you want to submit a web form is figure out what the form is called and what the url is that you will be posting to. If you go to duckduckgo’s website and view the source, you’ll notice that its action is pointing to a relative link, “/html”. So our url is “”. The input field is named “q”, so to pass duckduckgo a search term, we have to concatenate the url to the “q” field. The results are read and written to disk. Finally, we open our saved results using the webbrowser module. Now let’s find out how this process differs when using the requests package.

Submitting a web form with requests

The requests package does form submissions a little bit more elegantly. Let’s take a look:

import requests
url = ''
payload = {'q':'python'}
r = requests.get(url, params=payload)
with open("requests_results.html", "w") as f:

With requests, you just need to create a dictionary with the field name as the key and the search term as the value. Then you use requests.get to do the search. Finally you use the resulting requests object, “r”, and access its content property which you save to disk. We skipped the webbrowser part in this example (and the next) for brevity. Now we should be ready to see how mechanize does its thing.

Submitting a web form with mechanize

The mechanize module has lots of fun features for browsing the internet with Python. Sadly it doesn’t support javascript. Anyway, let’s get on with the show!

import mechanize
url = ""
br = mechanize.Browser()
br.set_handle_robots(False) # ignore robots
br["q"] = "python"
res = br.submit()
content =
with open("mechanize_results.html", "w") as f:

As you can see, mechanize is a little more verbose than the other two methods were. We also need to tell it to ignore the robots.txt directive or it will fail. Of course, if you want to be a good netizen, then you shouldn’t ignore it. Anyway, to start off, you need a Browser object. Then you open the url, select the form (in this case, “x”) and set up a dictionary with the search parameters as before. Note that in each method, the dict setup is a little different. Next you submit the query and read the result. Finally you save the result to disk and you’re done!

Wrapping Up

Of the three, requests was probably the simplest with urllib being a close follow-up. Mechanize is made for doing a lot more then the other two though. It’s made for screen scraping and website testing, so it’s no surprise it’s a little more verbose. You can also do form submission with selenium, but you can read about that in this blog’s archives. I hope you found this article interesting and perhaps inspiring. See you next time!

Further Reading

Source Code

Print Friendly

  • Pingback: Links « Frackmente()

  • Pingback: Scraping with Mechanize and BeautifulSoup | A geek with a hat()

  • Choperro

    The first example causes a strange little query web to open in my browser. But no results about a “python” search.

  • Choperro

    How do you import the 3rd party libs without installing them, just for testing?

  • Mike Driscoll

    It looks like they changed their interface slightly. Not sure how to fix it though…

  • Mike Driscoll

    You should use virtualenv. Then you can create a virtual environment in Python where you can install modules for testing before you install them to your main Python installation.

  • Mike Driscoll

    Sorry for the delay, but I figured it out and updated the urllib and requests examples.