OpenWebcamDB API
The webcams in this directory as JSON: titles, places, coordinates, categories and thumbnails, plus the stream URL for each webcam. You need an API key, which you can create with a free account.
What you can request
Every endpoint lives under https://openwebcamdb.com/api/v1 and answers with JSON.
- GET /webcams
- Webcams, filtered by country, category, status, search text or a bounding box. Sortable and paginated, up to 100 per page.
- GET /webcams/{slug}
- One webcam with all its details, including the stream URL.
- GET /webcams/random
- A random webcam, including the stream URL.
- GET /webcams/popular
- Webcams by popularity. Also available: /webcams/trending and /webcams/recently-viewed.
- GET /webcams/map
- Up to 500 webcams inside a latitude and longitude bounding box.
- GET /countries
- Countries with webcams and how many each has. /countries/{iso_code} lists one country’s webcams.
- GET /categories
- Kinds of view, such as beaches or cities. /categories/{slug} lists the webcams in one.
List endpoints leave out the stream URL; request a single webcam to get it. Full API reference
Your first request
Ten webcams in Belgium:
curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://openwebcamdb.com/api/v1/webcams?country=belgium&per_page=10"The country filter takes the last part of a country page’s address on this site: belgium for /countries/belgium. Replace YOUR_API_KEY with a key from your account.
Plans
Prices are per month. Limits apply per account, across all of its API keys.
| Plan | Free | Pro |
|---|---|---|
| Price | €0 a month | €50 a month |
| Requests per day | 25 | 10,000 |
| Requests per minute | 5 | 1,000 |
| API keys | 1 | 5 |
| Includes |
|
|
| Availability | Create a free account | Not available yet |
Need higher limits? Email [email protected].
Rules for using the data
- Attribution on the free plan
- Show a visible link, such as “Powered by OpenWebcamDB.com”, on pages that display data from the API. Paid plans don’t need attribution.
- How long you may cache
- Up to 1 hour on the free plan and up to 24 hours on paid plans, so places and stream URLs stay current.
- Fair use of images
- Thumbnails and image URLs are subject to fair use. Heavy bandwidth use or abuse can lead to stricter limits or a suspended key, so cache images where you can.
What the API may and may not be used for is set out in the terms of use.