openapi: 3.1.0 info: title: Instapage Analytics API description: 'Bulk visit, conversion and lead statistics for pages and experiences. The Instapage Public API is a REST API over the Instapage landing page and post-click optimization platform. It exposes workspaces, team members, landing pages, page groups, personalized experiences, collections and collection pages, experiments, analytics, form submissions (leads), custom domains and image assets. Authentication is a personal API token sent as an HTTP Bearer token in the Authorization header. A personal token inherits all permissions from its creator and cannot exceed them; expired or revoked tokens return 401. Rate limiting is 200 requests per minute enforced per token and per IP address, on top of a daily plan quota that resets at 00:00 UTC; exceeding either returns 429 with a Retry-After header. List endpoints are page-number paginated via the `page` query parameter and return a `meta.pagination` block; form submissions instead use an opaque `meta.nextPageToken` cursor. Errors are returned as a `{title, details, meta}` envelope. Instapage does not publish an OpenAPI description. This document was transcribed by API Evangelist from the published API reference at https://devdocs.instapage.com/ and is not an official Instapage artifact.' version: '1' contact: name: Instapage Developer Docs url: https://devdocs.instapage.com/ termsOfService: https://instapage.com/terms-of-service x-provenance: method: derived source: https://devdocs.instapage.com/ generated: '2026-08-13' note: Instapage publishes no OpenAPI. Transcribed from the published API reference; not an official Instapage artifact. servers: - url: https://api.instapage.com/v1 description: Instapage Public API v1 security: - BearerAuth: [] tags: - name: Analytics description: Bulk visit, conversion and lead statistics for pages and experiences. paths: /workspaces/{workspaceId}/analytics: post: summary: Get statistical data description: Retrieve statistical data related to pages and experiences in bulk. All dates are in UTC; daily, monthly and yearly grouping windows are aligned to UTC. operationId: getAnalytics tags: - Analytics parameters: - in: path name: workspaceId required: true description: The ID of the workspace. schema: type: number requestBody: required: true content: application/json: schema: type: object properties: pages: type: array maxItems: 100 description: Specifies the pages for which the API should return statistical data. Up to 100 page IDs per request. items: type: number interval: type: string default: monthly enum: - daily - hourly - monthly - yearly description: Time interval for aggregating data. device: type: string default: any enum: - any - desktop - mobile description: Device type filter. timeframe: type: object properties: start: type: number default: 0 description: Starting timestamp (in seconds) for fetching data. end: type: number description: Ending timestamp (in seconds) for the data retrieval period. Defaults to the current time. traffic: type: string default: blended enum: - blended - organic - paid description: Type of traffic to include. grouping: type: array description: Additional grouping for the data. items: type: string enum: - pageId - variationId visited: type: number description: Filters data based on unique actions. 1 includes only returning visitors; 0 includes only unique actions. responses: '200': description: The request was processed successfully. content: application/json: schema: type: object properties: data: type: array items: $ref: '#/components/schemas/AnalyticsRow' '400': description: Bad request. Validation error — review input parameters. content: application/json: schema: $ref: '#/components/schemas/Error' '401': description: Unauthorized. Authentication failed or missing credentials. content: application/json: schema: $ref: '#/components/schemas/Error' '403': description: Forbidden. The user does not have the necessary permissions. content: application/json: schema: $ref: '#/components/schemas/Error' '404': description: Not Found. The requested resource could not be located. content: application/json: schema: $ref: '#/components/schemas/Error' '429': description: Too Many Requests. Request was blocked due to rate limit or plan restrictions. See the Retry-After header. content: application/json: schema: $ref: '#/components/schemas/Error' headers: Retry-After: description: Number of seconds to wait before retrying, returned when the daily plan quota or the 200 requests/minute limit is exceeded. schema: type: integer '500': description: Internal Server Error. An unexpected condition prevented the request from being fulfilled. content: application/json: schema: $ref: '#/components/schemas/Error' components: securitySchemes: BearerAuth: type: http scheme: bearer bearerFormat: Personal API Token description: 'Personal API token generated from Instapage account settings, sent as `Authorization: Bearer `.' schemas: Error: type: object description: Error envelope returned by the Instapage API. properties: title: type: string description: The type of error that occurred. details: type: string description: A human-readable description of the error. meta: type: object properties: requestedUserId: type: number description: ID of the user who made the request. requestedWorkspaceId: type: number description: ID of the workspace involved. requestedPageId: type: number description: ID of the page involved, when the error concerns a page. AnalyticsRow: type: object properties: key: type: object description: Object containing unique identifiers. Structure varies based on the request grouping. properties: pageId: type: number description: Page ID, part of the key. date: type: number description: Date in UNIX timestamp (seconds), part of the key. variationId: type: number description: Variation ID, part of the key. visit: type: number description: Total number of visits associated with the key. conversion: type: number description: Total number of conversions associated with the key. leads: type: number description: Total number of leads associated with the key.