# API - Early Access #### Early Preview Access to Our API 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. {% hint style="info" %} As we are in the alpha stage, please be aware that you might encounter some rough edges, and we're actively working on improvements. Your feedback is invaluable to us during this phase. Whether you have questions, suggestions, or just want to share your thoughts, we're all ears. {% endhint %} ## Getting started with Monitoro API 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 [**support@monitoro.co**](mailto:support@monitoro.co). 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! *** ## Authentication 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. *** ## Extract data from URL ** **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 [Monitoro](#https-api.monitoro.app-v1-monitors-monitorid-extract) and retrieve the monitorId from the address at the top. It is the long text after `https://monitoro.app/monitors/...`. {% hint style="warning" %} 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. {% endhint %} You then have two options to call this method's endpoint: #### Extract & Run automations 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: ``` { "url": "https://example.com" } ``` #### Extract only 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: ``` { "url": "https://example.com", "noIngest": true } ``` 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. {% openapi src="/files/5AejEaB99TVusWeiDUiv" path="" method="post" %} [openapi.yml](https://4133542631-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnQWIBwmIWAqqWM90FfsX%2Fuploads%2Fy5aed03vXHiHN0opdBs7%2Fopenapi.yml?alt=media\&token=b3060100-2af9-4c05-9a35-b7afc7c39fd8) {% endopenapi %} *** ## Need help? {% content-ref url="/pages/1lnlBLH6HfwEK7PvqADD" %} [Common questions (FAQ)](/resources/common-questions-faq.md) {% endcontent-ref %} {% content-ref url="/pages/dKtMy5pNOGJkipAL18ta" %} [Troubleshooting](/resources/troubleshooting.md) {% endcontent-ref %} {% content-ref url="/pages/Vuu3jOA6KDUwIos8cci0" %} [Support](/resources/support.md) {% endcontent-ref %} --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.monitoro.co/reference/api-early-access.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.