Excellence Center

Global Insights and Amazing Tools for Joomla! Professionals

Watch the tour

Watchful Explained
in 120 seconds

Start free trial

30 days. No commitment
No credit Card

Main Support

How do I use the Watchful REST API?

Users on all plans can use the REST (API) to query and update their Watchful data. Please review this video before proceeding:

 

Note: To test the API, please visit the interactive documentation.

Four HTTP verbs are supported:

  • GET requests to retrieve information
  • POST to add new records
  • PUT to update records
  • DELETE requests to remove records

API endpoint

All API requests must be made over HTTPS to the following endpoint:

https://app.watchful.li/api/v1

Calls made over plain HTTP will be redirected to HTTPS.

The API version is shown in the URLs of the endpoint, e.g. /api/v1.

Resources

You will find all the resources of the API on our interactive documentation.

API keys

To use the API with your Watchful account, select the API tab in your Profile and click the Request new API key button as shown in the screenshot below.

12-api-key

Authentication

You have three different methods to authenticate yourself to the API:

  1. HTTP Header
  2. Query parmeter
    • API Key in the query string
    • GET https://app.watchful.li/api/v1/sites?api_key=6a7c274802f2344196b44c
  3. Session Login
    • You can access to all the resources  if you are logged into Watchful . To use your session login, just provide your user name and password at the login screen and then make a request through your browser or with the interactive documenation.

Formats

Date and time values are of the form YYYY-MM-DD HH:MM:SS.

Booleans are either 1 (true) or 0 (false).

Search fields can use % like in SQL and a “!” before the the value for "not".

Inputs are always in JSON.

We support 4 differents format for output. If you don’t specify an accept header, the API will return JSON format by default:

  • XML
    • HTTP-Header Accept: application/xml
  • JSON
    • HTTP-Header Accept: application/json
  • JSONP
    • HTTP-Header Accept: application/json
    • For JSONP, add the ?callback parameter to any GET call to have the results wrapped in a JSON function. For example: https://app.watchful.li/api/v1/sites?callback=myfunction
  • Serialized
    • HTTP-Header Accept: text/plain

Errors

All status types can be views in the interactive documentation.

Examples:

  • XML return
  • JSON return

Calls per day

We currently restrict your API usage to 2000 requests per day. Please open a support ticket if you need more calls.

PHP examples

Testimonials

Martijn Boomsma
It's great to have Watchful.li as an easy, timesaving and useful tool for professional managing (many) Joomla websites. Martijn Boomsma / perfectwebteam.com
Kristoffer Sandven
Watchful.li saves me from manually monitoring dozens of websites - I can keep them updated with just a few clicks from a single, slick interface! Kristoffer Sandven / joomlablogger.net
Rene Kreijveld
I just upgraded 35 websites to latest Joomla version and extensions in 10 minutes with Watchful's awesome tool! Rene Kreijveld / dsdeurne.nl
Jonathan Frewin

Watchful cut my monthly [maintenance] time down from days to hours. Jonathan Frewin / frewindesign.co.uk

All Testimonials

Global Insights

Extension Tracker

Keep track of all your components, plugins and modules

Server Status

Be on the lookout for changes in your primary server status

Uptime Monitor

Be notified when a site goes down

White-Label Reports

Generate great looking reports for your clients to showcase the value of your services

Customized Apps

Expand your insights with customizable Apps to cater to your specific needs

Google Analytics

Keep track of traffic and search terms

Extension Tracker

Keep track of all your components, plugins and modules

Server Status

Be on the lookout for changes in your primary server status

Uptime Monitor

Be notified when a site goes down

White-Label Reports

Generate great looking reports for your clients to showcase the value of your services

Customized Apps

Expand your insights with customizable Apps to cater to your specific needs

Google Analytics

Keep track of traffic and search terms

Amazing Tools

Backup Manager
Backup Manager

Always know if your site has been backed up recently

Software Updates
Software Updates

Seamless updates for both free and commercial add-ons

Remote Installer
Remote Installer

Install extensions in bulk for standardized or customized changes to your websites

Site Audit
Site Audit

Be sure that website best-practices are followed and remain in effect

Single Sign-On
Single Sign-On

Manage your agency developers in a central location

API
API

Develop your own custom applications with watchful

Watchful News and CMS Blog

Did you miss these three summer features in your Joomla Dashboard?

24 August 2016 / Blog

With warm weather and longer days, most of us step back a little during the summer months to get outside more often, spend time with friends and family, and take some time off.

All News