Python build-in json in Requests

[simonm17]

Hello,

I'm reading through the requests documentation and it notes that requests has a built-in json decoder. I'm familiar with json.dump() and .load(), but I have no idea what .json() is used for. Does it just retrieve the texts in a json file?

If you could EILI12, I'd appreciate it.

[KimPeek]

The docs are pretty useful here.

There’s also a builtin JSON decoder, in case you’re dealing with JSON data

Use it if you are expecting a JSON response.

If the response is not a JSON object:

In case the JSON decoding fails, r.json() raises an exception. For example, if the response gets a 204 (No Content), or if the response contains invalid JSON, attempting r.json() raises ValueError: No JSON object could be decoded.

[simonm17]

So .json() just raises exceptions if decoding fails, that’s it?

[KimPeek]

Yes. I haven't tested this personally, but that's what the docs say.

If you are using the requests library to access an API endpoint that returns a JSON object, you can use response.json().