Exporting via the REST API
This page describes how to export content using the REST API. To export content you have to:
- Create an access token for authentication (once).
- Start the export job (the server will return the ID of the job).
- Fetch the status of the export job repeatedly until it finished.
- Download the exported file when the export job has finished.
For more details, read on or take a look at the example script (tested with Python 3.9).
Personal Access Token(s) can be created in your user profile. Simply navigate to: User Profile Icon (top right) > Settings > Scroll HTML Exporter API Tokens
This token can be used for as many exports as you want, as long as it exists.
Once created, the token is must be added via the
Authorization header to all HTTP requests:
Authorization: Bearer <my-token>
IDs used in Export Parameters
When starting an export, you may need to provide several IDs to the API. Here's how to locate them:
|Page / Blog Post ID|
Can be found by opening the Page Information screen via ... → Advanced details → Page Information
The ID is contained in the URL of this screen, for example:
|Template ID||Can be retrieved by inspecting the template information in the space / global template list's Action menu.|
|Scroll Documents: Variant ID||Can be found for a Scroll Document by opening the document reader, selecting the variant and then click Share. This produces a URL that contains the variant ID, for example |