Stillio provides an API to access your URLs and screenshots. This allows you to get image deep links to be able to embed them in your own application(s).
Note 1: Using the API requires technical knowledge and programming skills. We do not provide support to your own applications that make use of our API.
Note 2: The API is designed for server-to-server calls only and does not support browser/client side calls. Cross-Origin Resource Sharing (CORS) is not possible.
Note 3: Currently it only possible to fetch URLs and screenshots. Other actions to manage your data (add, edit and delete) might be added later but is not yet supported.
Steps to take to make use of our API:
You need a private token to authenticate yourself to our API. This token needs to be added to each API request, to validate access to your data. To create a token you need to:
Now that you have an API token, you may use that to access your screenshots and URLs outside the main Stillio app. For example, you can create your own webpage and embed the screenshots that have been created by Stillio.
The current API version is version 3. Please check our Stillio API v3 documentation.
If you start using our API, only use version 3 and not the deprecated v1 below.
Please ignore everything below this line.
The information below is deprecated and only for reference for anyone using the version 1 API.
⚠️ API v1 will remain active until Dec 31, 2019. After that date, it may stop working at any moment without further announcement.
To get a list of your URLs, use the following base url where you replace YOUR-TOKEN by the actual token you created. Optionally you may add extra parameters to limit the number of URLs that are returned (default: 1000, max: 1000) or change the sort order (default: desc)
Base URL |
https://app.stillio.com/api/urls?api_token=YOUR-TOKEN
|
Limit (optional) | Number between 1 and 5000. (Default: 250) |
Sort (optional) | asc or desc. (Default: desc) |
Example URL to fetch the oldest 3 URLs in your account (replace YOUR-TOKEN with actual token):
https://app.stillio.com/api/urls?api_token=YOUR-TOKEN&limit=3&sort=asc
The returned result set contains an array with the URLs, their ID (needed for fetching screenshots) and the creation date.
When you know the unique ID of a URL you can use the API to fetch its screenshots. You can get the URL ID from the API call mentioned above, or by checking the URL in your address bar when you're logged in and have a certain URL selected.
This is your what your URL ID looks like (marked in red):
Base URL |
https://app.stillio.com/api/screenshots?api_token=YOUR-TOKEN&url_id=URL-ID
|
Limit (optional) | Number between 1 and 1000. (Default: 1000) |
Sort (optional) | asc or desc. (Default: desc) |
Example URL to fetch the latest screenshot for a certain URL (replace YOUR-TOKEN and URL-ID with actual data):
https://app.stillio.com/api/screenshots?api_token=YOUR-TOKEN&url_id=URL-ID&limit=1
The returned result set contains the path to the full-size screenshot (screenshot_image), the path to the thumbnail (screenshot_image_small) and the created date of the screenshot.
We recommend using the app Postman to test your API calls. If you get anything else than a correct JSON result set (for example, a bunch of HTML), you probably have a SPACE or a TYPO in your call. Please double check your request URL. If you keep having issues, please email us your API URL that's not working, including your unique token.
Check Stillio Support for more help documents.
Start capturing website screenshots automatically and save a lot of grunt work. You'll be set up in minutes. No credit card required.