How to use the RandomFox API in Python

Random pictures of foxes. A free animals API by randomfox.ca. This guide calls it from Python with code we've run against the live endpoint.

Online · 1546 msEndpoint tested Oct 24, 2026

1. What you need

Python 3.8+ and the requests library: `pip install requests`.

No API key or sign-up. Endpoint: https://randomfox.ca/floof/

Python

import requests

res = requests.get("https://randomfox.ca/floof/", timeout=10)
res.raise_for_status()
data = res.json()
print(data)

Trimmed from the live response on Oct 24, 2026.

JSON

{
  "image": "https://randomfox.ca/images/77.jpg",
  "link": "https://randomfox.ca/?i=77"
}

Set a timeout and handle non-200 responses: free APIs can rate-limit or go down.
Cache responses where you can, instead of calling the API on every page view.
Read the official documentation ↗ for rate limits and terms of use.

No. The RandomFox API works without an API key, so the Python example runs as-is.

Yes. It sends CORS headers, so front-end JavaScript can call it directly.

JSON. The example response on this page is trimmed from a real response our health check received on Oct 24, 2026.