External API

Our API is currently in Beta.

Have thoughts on how to make our API better? Email your feature suggestions to [e-mail].

What is the External API?

The Intelligems External API provides programmatic access to your Intelligems experiences and analytics data. This RESTful API allows you to integrate Intelligems functionality into your own applications, workflows, and data pipelines.

What can you do with the External API?

The External API enables you to:

Retrieve & Analyze Data

• List all tests and experiences in your account

• Get detailed configuration for specific tests and experiences, including variations, targeting rules, offer details, and content modifications

• Pull performance metrics for any test or experience, with results broken down by audience segments (device type, visitor type, traffic source, geography, etc.)

• Fetch sitewide analytics including revenue per visitor, net revenue, and visitor counts for any date range

Manage Experiences

• Create new experiences and experiments programmatically

• Update existing experience configurations, variations, and targeting rules

• Control experience lifecycles — start, pause, or end experiences via API

Automate Workflows

• Integrate Intelligems data into your business intelligence tools

• Build custom dashboards combining Intelligems metrics with other data sources

• Automate reporting and alerting based on test performance

Common Use Cases

• Custom Reporting: Build internal dashboards that combine Intelligems test results with proprietary business metrics.

• Automated Monitoring: Create alerts to notify you if there's an issue with a test or give you a daily summary.

• Automated Reporting: Create automation engines that give you insights during key stages of a test (7 days live, 14 days live, test ended).

Checkout our Automations & Guides sections for how-tos of common use cases.

Getting Started

To generate your API key, in your Intelligems account, navigate to Integrations > Intelligems External API > Select Enable. A pop-up will appear with your API key. You can also navigate back here at any time to grab that same API key again.

Once you have your API key, you can authenticate requests by including it in the intelligems-access-token header.

Available Endpoints

Experiences

• GET /v25-10-beta/experiences-list — Retrieve a paginated list of experiences with optional filtering by category and status

• GET /v25-10-beta/experiences/{experienceId} — Get complete details for a specific experience

• POST /v25-10-beta/experiences — Create a new experience or experiment

• PUT /v25-10-beta/experiences/{experienceId} — Update an existing experience's configuration, variations, or targeting

• POST /v25-10-beta/experiences/{experienceId}/actions/{action} — Perform a lifecycle action on an experience (start, pause, or end)

Experience & Experiment Analytics

• POST /v25-10-beta/analytics/resource/{experienceId} — Retrieve analytics for an experience (metrics, variations, optional graphs). Accepts filters and all request settings in the JSON body. Use this for all new integrations.

• POST /v25-10-beta/analytics/experience/{experienceId}/timeseries — Metric-over-time data for a single experience

• POST /v25-10-beta/analytics/experience/{experienceId}/export — Export an experience's analytics dataset

• GET /v25-10-beta/analytics/resource/{experienceId} — Deprecated. Legacy query-parameter analytics endpoint, kept only as a beta compatibility path and removed when the beta ends. Use the POST variant above instead.

Sitewide Analytics

• POST /v25-10-beta/analytics/sitewide/snapshot — Summary KPI metrics with period-over-period percent changes and optional audience segmentation

• POST /v25-10-beta/analytics/sitewide/timeseries — Metric-over-time data with configurable granularity and optional audience segmentation

• POST /v25-10-beta/analytics/sitewide/order-distribution — Order-value histogram (KDE/CDF) and unit-mix breakdown

• POST /v25-10-beta/analytics/sitewide/conversion-funnel — Sitewide conversion funnel as a Sankey graph (traffic source → landing page → cart → checkout → conversion)

Holiday Benchmark

• POST /v25-10-beta/analytics/event/snapshot — Benchmark event snapshot metrics

• POST /v25-10-beta/analytics/event/timeseries — Benchmark event metric-over-time data

For detailed endpoint documentation including parameters, request examples, and response schemas, see the API Reference.