API - Early Access
Last updated
Was this helpful?
Last updated
Was this helpful?
We're thrilled to announce that our API is currently in early preview! This is a unique opportunity to be among the first to explore our new features, and it's completely free. We understand the importance of building a tool that meets your needs, and we're dedicated to making our API the best it can be.
Monitoro API is designed to extend your projects and automations with the ability to retrieve data from any website in your personal browser, with minimal scraping or even coding experience.
To get started with an API token or to share your feedback, please don't hesitate to reach out to us at . Your input will be instrumental in shaping the future of our API, and we're excited to embark on this journey together. Let's create something amazing!
All Monitoro API endpoints use a Bearer token authentication. During the alpha phase you can request a token by contacting us at .
Once you get your API token from us, send an Authorization
header with Bearer mtat-abc123
with every request you make.
https://api.monitoro.app/v1/monitors/{monitorId}/extract
How does it work? This method lets you extract or scrape data directly using your own browser. Using the data selection and automation from any of your monitors, this method will extract data and optionally run your monitor's automations with it.
First, open your monitor in and retrieve the monitorId from the address at the top. It is the long text after https://monitoro.app/monitors/...
.
Make sure your browser is running and the extension is installed & logged in before calling this API method, since it is made to let you automate your browser. Extraction will fail immediately if you don't have the extension running and you will receive an error response.
You then have two options to call this method's endpoint:
The Extract data from URL
method extracts data and sends it to your automations if noIngest
is false
or not defined.
This endpoint does not wait for the automations to run and returns data as soon as it is extracted.
You have access to the full array of apps supported by Monitoro.
Example payload:
The Extract data from URL
can also simply return data without running automations. Specify noIngest
as true
to achieve this.
Make sure to respect your local laws and the terms of the website. Example payload:
In both cases the endpoint will return data it extracted, and any error encountered during the process.
Error status codes
This API can return responses with the status 200, 400, 404 and 500. Please look at the response block below, and click on the dropdown with "200" in it to see Error codes.
This endpoint allows for the manual extraction of data from a specified URL, using the settings configured for a given monitor. It can also optionally run the automations associated with the monitor.
The ID of the monitor whose settings are to be used for extraction
The URL from which data is to be extracted
https://example.com/page
Determines if the monitor's automations are executed. Set to false to skip automations. Note: Ensure automations do not depend on past data comparisons.
false