Instapage offers a public API that your team can use to pull in data such as workspace data, team member information, analytics data, leads, and so on. This feature has two components: the authorization key and the documentation.
The authorization key
Each Instapage account (including team members) will have its own Personal API Token. This token is capable of fetching information about all of the workspaces the user has access to, whether they own it or not. It will also have the same permission level to access things as the team member who generated it. For this reason, we strongly recommend getting this token as the Account Owner and sharing it with your team internally. The Instapage Support Team is unable to see or generate your API token.
It is crucial that you treat the token as confidential information, as it can provide access to all of your Instapage account data, including leads!
To find the token, click on your workspace name in the upper left corner, then click on My Account Admin. Alternatively, you can click this link https://app.instapage.com/account.
If you do not have a token yet, first click on Create New Token.
If you have already created one, you can click on Copy to clipboard.
The documentation
The technical documentation that is linked in the same section contains all the information that you need to know for a developer to use the public API for custom requests. You can also find it at this direct link: https://devdocs.instapage.com/#instapage-api
It includes information about the type of data you can fetch, examples in shell, javascript and typescript, and information about potential error codes.
It also mentions the rate limit: you are limited to 200 requests per minute. Exceeding this limit will result in a 429 Too Many Requests response status. Please note that there is also a daily API calls limit that can be checked in the Subscription section of the app by the account owner.
Use case examples
The Personal API Token can be used in numerous ways. The API allows you to pull in data about your workspaces, team members, pages, and more to manipulate with a user-written program or application.
Some examples of how you could use it:
- Bulk page generation and management with Collections
- Audit team member usage by workspace
- Generate a complete list of your pages within a workspace
- Publish/unpublish pages
- Get analytics data based on the list of workspaces and pages
- Retrieve a list of images in a specific folder within a workspace's image assets
- Upload an image to a specific folder
NOTE: Operations performed using your API key are subject to the same restrictions as those imposed by your team member status, subscription status, and other relevant circumstances. For instance, users who cannot download pages because they are on a free plan will not be able to do so with the API.