Data from the web
An internote can draw its graphs from data another site publishes, instead of an attachment.
#How it works
Many sites publish data at a web address, often called an API. An internote can name that address in place of an attachment, and its graphs and tables use whatever the address returns. The manual’s page on datasets shows how to write one.
Internote collects the data when you publish, and keeps a copy. Everyone reading your internote sees that copy, so they all see the same numbers, and the site you’re reading from is asked once rather than every time someone opens the page.
While you’re working on a draft, the data is collected fresh for you, so a change shows straight away. Nobody else sees it until you publish.
#What readers see
A scene that draws data from the web says when the data was collected, such as Data fetched 24 Oct 2026, at the bottom of its canvas. That tells readers the numbers are a fixed copy, not live.
#Keeping the data up to date
Publishing again collects the data again. To update the data without changing anything else, select the internote in Studio and choose Refresh data. It works on several internotes at once, and on internotes published from GitHub too.
An internote published from GitHub also collects its data each time you push.
#Services that need a key
Some services only share their data with people who have a key, a code they give you when you sign up with them. Save it once under Preferences, API keys, with a short name such as weather, and your internotes can use it by that name.
- Internote uses a key only when you publish or refresh. Readers never see it.
- Once saved, a key can be replaced or deleted but not viewed again, so keep your own copy.
- When an internote has several authors, whoever publishes it uses their own key of that name.
- Internotes published from an organisation’s GitHub repository can’t use keys, since no one person publishes them.
#When the data doesn't update
If a service can’t be reached, or sends back something unexpected, the publish still goes ahead. You’ll see Published, but some data didn’t update, naming the dataset and what went wrong, and readers keep the data collected last time.
Common reasons:
- The server answered 401 or 403: the service wants a key, or the key you saved has expired.
- You have no key named …: add one with that name under Preferences, API keys.
- The new data no longer fits: the service changed the shape of what it returns, so a column your internote uses is gone.
- Not a public address: Internote only collects data from the public internet.