API authentication

Managing your API keys

To start using the API, you will need to create an API key for your account.  Only administrators can manage API keys.  Use the Insites API control panel to create a key, or follow these instructions:

  1. Go to “Account settings”
  2. Go to “API & integrations”
  3. Go to “API”
  4. Click “Create new key”

You can create multiple keys if necessary, and you can revoke a key if necessary.

Authenticating a request

Send your API key as a header named “api-key” with each request.  Here’s a cURL example you can run in your command line which will start a Insites report running:

curl "https://api.insites.com/api/v1/report" --header "api-key: [YOUR API KEY]" --data "{\"url\":\"mywebsite.com\"}"

If successful, you would expect a 202 response, with a body like this:

  • Was this helpful?
  • Yes   No