How to connect to the Siteimprove API

Modified on: Mon, 4 Oct, 2021 at 10:14 AM

The Siteimprove API (Application Programming Interface) allows developers to integrate with the Siteimprove platform.

Detailed information and API reference documentation can be found on the Siteimprove Developer page.

The API requires the client to log in with a username and an API-key using Basic Access Authentication.

The client acts on behalf of the username supplied during authentication and receives the same permissions as if the username was logged into the Siteimprove platform.

You can create and manage API keys from the Integrations menu in the Siteimprove platform.

Note: You must have Account owner or Administrator permissions to setup an API key.

To set up a connection to the API

  1. Go to Integrations > API > API KeysAPI_key_configuration_page
  2. Click on "Add user"
  3. Create a user with the rights and roles you want the API user to have in the platform.
    (For further information on adding a user read the article - How do I add a user?)
  4. Click on "Create API Key"
  5. Give your Key a description and choose the user which you created earlier.Create_API_setup_page
  6. Select "Create API Key"
  7. The API Key can now be seen in the API Key table and used to gain access to the Siteimprove API

Note: You can visit the Siteimprove API website and log in with the API user name and API key as shown in the API Key table to access the Siteimprove API and API documentation.

API Reference

All URLs referenced in this documentation have the following base URL:

https://api.siteimprove.com/v2

The Siteimprove REST API is served over HTTPS for improved data privacy. HTTP is not supported.

Three endpoints will assist you in exploring the API:

The API itself provides HAL-style navigation links to explore the full API.

The documentation contains descriptions of all endpoints, parameters, and returned values. It also offers the ability to try out all the endpoints.

The OpenAPI spec (formerly Swagger) is a formal definition of the API, suitable for use in e.g. code generation.

You must authenticate with your account credentials in order to access any part of the API, including the links above.

Did you find it helpful? Yes No

Send feedback
Sorry we couldn't be helpful. Help us improve this article with your feedback.