Python requests exception handling


How to handle exceptions with python library requests?
For example how to check is PC connected to internet?

When I try

except ConnectionError:
    # handle the exception

it gives me error name ConnectionError is not defined

Asked By: user1159798



Assuming you did import requests, you want requests.ConnectionError. ConnectionError is an exception defined by requests. See the API documentation here.

Thus the code should be:

except requests.ConnectionError:
   # handle the exception

The original link to the Python v2 API documentation from the original answer no longer works.

Answered By: kindall

for clarity, that is

except requests.ConnectionError:


import requests.ConnectionError


You can also catch a general exception (although this isn’t recommended) with

except Exception:
Answered By: StackG

Actually, there are much more exceptions that requests.get() can generate than just ConnectionError. Here are some I’ve seen in production:

from requests import ReadTimeout, ConnectTimeout, HTTPError, Timeout, ConnectionError

    r = requests.get(url, timeout=6.0)
except (ConnectTimeout, HTTPError, ReadTimeout, Timeout, ConnectionError):
Answered By: kravietz

Include the requests module using import requests .

It is always good to implement exception handling. It does not only help to avoid unexpected exit of script but can also help to log errors and info notification. When using Python requests I prefer to catch exceptions like this:

    res = requests.get(adress,timeout=30)
except requests.ConnectionError as e:
    print("OOPS!! Connection Error. Make sure you are connected to Internet. Technical Details given below.n")
except requests.Timeout as e:
    print("OOPS!! Timeout Error")
except requests.RequestException as e:
    print("OOPS!! General Error")
except KeyboardInterrupt:
    print("Someone closed the program")
Answered By: Tanmoy Datta

As per the documentation, I have added the below points:

  1. In the event of a network problem (refused connection e.g internet issue), Requests will raise a ConnectionError exception.

    except requests.ConnectionError:
       # handle ConnectionError the exception
  2. In the event of the rare invalid HTTP response, Requests will raise an HTTPError exception.
    Response.raise_for_status() will raise an HTTPError if the HTTP request returned an unsuccessful status code.

       r = requests.get('')
    except requests.exceptions.HTTPError as err:
       #handle the HTTPError request here
  3. In the event of times out of request, a Timeout exception is raised.

You can tell Requests to stop waiting for a response after a given number of seconds, with a timeout arg.

    requests.get('', timeout=0.001)
    # timeout is not a time limit on the entire response download; rather, 
    # an exception is raised if the server has not issued a response for
    # timeout seconds
  1. All exceptions that Requests explicitly raises inherit from requests.exceptions.RequestException. So a base handler can look like,

       r = requests.get(url)
    except requests.exceptions.RequestException as e:
       # handle all the errors here

The original link to the Python v2 documentation no longer works, and now points to the new documentation.

Answered By: abhishek kasana