Disclaimer: This website requires JavaScript to function properly. Some features may not work as expected. Please enable JavaScript in your browser settings for the best experience.

The availability of features may depend on your plan type. Contact your Customer Success Manager if you have any questions.

Dev GuideAPI Reference
Dev GuideAPI ReferenceUser GuideLegal TermsGitHubDev CommunityOptimizely AcademySubmit a ticketLog In
Dev Guide

API reference overview

Describes more information about Optimizely Web Experimentation version 2 REST API.

You can use Optimizely Web Experimentation API to access resources in your Optimizely Web Experimentation projects. This API closely mirrors the functionality of the Optimizely Web Experimentation user interface; its endpoints have predictable, resource-oriented URLs.

Product Support

The REST API supports both Optimizely Web Experimentation and Optimizely Feature Experimentation. Both products share many of the same data models, so endpoints like Experiments and Projects can be used for both. Some fields are shared between Optimizely Web Experimentation and Optimizely Feature Experimentation while others are specific to one product. See the field's description for the applicable product or products.

API usage

The Optimizely Web Experimentation API endpoints are defined using the OpenAPI Specification. This enables you to create API clients in any programming language using the Swagger Generator, or use any off-the-shelf HTTP client to compose and send requests. See OpenAPI / Swagger for more information.

The API returns JSON in the body of responses. If a value is not set for a field (meaning, the value is null), the field will not appear in the JSON response.

The preferred method of authenticating with the API is using OAuth 2.0. However, to make our API easily explorable, we have implemented Personal tokens.

Review the API Conventions in our documentation. If you have any questions, you can ask the developer community, or you can submit a ticket to the developer support team. We'll be happy to assist you.

API endpoint

https://api.optimizely.com