Our link API lets you easily and quickly integrate Insites into your CRM or other existing tool.
Simply add a button onto your customer record that when clicked, redirects the agent to the Insites platform and passes the customer details to Insites as parameters.
This is a great way to save agents time since they no longer have to use the search functionality within Insites or copy the business details over manually.
How to build a link
Building a link to run a report is trivial. Here’s one that should work straight away:
As you can see, this link simply includes the website to be analysed using the query parameter url.
For a full list of possible parameters, see the Detailed specification below.
This API works with a GET request or a POST request containing the same parameters – use whichever option that fits your use-case.
If you are on an enterprise plan with a custom host name configured, you can swap app.insites.com for your own white-label domain and no other changes are necessary.
Full specification
Method: GET or POST
Endpoint: https://app.insites.com/report/submit or https://[YOUR CUSTOM HOSTNAME].com/report/submit
These parameters should be passed as standard GET parameters, or as form encoded in a POST body:
Property | Definition | Required |
url | String – URL to analyze | No |
on_completion | String – Insites will make a POST callback to this URL with the JSON report data. | No |
allow_path | Boolean – if true, Insites will run an audit on a subsection of a site, e.g. https://mywebsite.com/part-of-my-site. Note that this feature is currently experimental. | No (defaults to false) |
name | String – Business name, some checks will not work without this, e.g Local presence, Reviews | No |
phone | String – Business phone number, some checks will not work without this, e.g Local presence, Reviews | No |
address | String – First line of business address, some checks will not work without this, e.g Local presence, Reviews | No |
number | String – Building number, enhances accuracy in some checks, e.g Local presence, Reviews | No |
street | String – Street, enhances accuracy in some checks, e.g Local presence, Reviews | No |
city | String – City, enhances accuracy in some checks, e.g Local presence, Reviews | No |
state | String – State or county, enhances accuracy in some checks, e.g Local presence, Reviews | No |
zip | String – Zip of postcode, enhances accuracy in some checks, e.g Local presence, Reviews | No |
country_code | ISO 2 letter code – Country, enhances accuracy in some checks, e.g Local presence, Reviews | No |
lat | String – Latitude, enhances accuracy in some checks, e.g Local presence, Reviews | No |
lng | String – Longitude, enhances accuracy in some checks, e.g Local presence, Reviews | No |
products | String – Products and services this business offers, some checks will not work without this, e.g Content keywords. Note: multiple products and services should be comma separated | No |
locations | String – Locations served, some checks will not work without this, e.g Content keywords. Note: multiple locations should be comma separated | No |
_[custom_field_name] | String – Pass values to set as one of your custom report fields. Note: custom report fields must be prefixed with an underscore. | No |
Expected response
If successful, you would expect a 301 redirect to a page with a progress bar, so the user can wait while Insites generates the SEO audit.
Authentication
If the user is already logged in, the report will start running straight away. If the user is not logged in, they will be prompted to log in before the report is generated. Only logged in users can use this functionality.