Overview
The Botsi Pricing API is a developer-first platform designed to automate monetization and user-level paywall selection. All features available in the Botsi Dashboard are programmatically accessible, allowing you to integrate AI-driven paywall variant selection directly into your mobile or web applications.
AI Pricing Model: a model that selects which of your pre-configured paywall variants to show each user. It does not set prices.
Every endpoint below works with paywall variant identifiers. None of them return, compute, or change a price, see the AI Pricing Models overview.
API Capabilities
The Botsi API is structured into three primary functional areas to support different stages of the user lifecycle:
Profile Management
Used to create and update user profiles. This layer allows you to sync Custom Attributes (like user_level or attributionSource) which the Botsi AI uses to determine the most effective paywall variant for each specific user.
Create a Profile
Access the Create a Profile endpoint to get started.
Add Single Custom Attribute
Create a single custom attribute for a profile.
Update Custom Attribute
Update an existing custom attribute for a profile.
Add Multiple Custom Attributes
Create multiple custom attributes for a single profile in one request.
Pricing & Paywalls
The core engine of the API. Use these endpoints to retrieve the paywall variant selected for a given user and placement. The response carries variant identifiers, not prices. Your app resolves those identifiers to the products and prices you configured for that variant.
Event & Purchase Validation
Ensures data integrity between store providers and Botsi. This layer handles the validation of Google Play and Apple App Store purchases, allowing the AI to close the feedback loop and improve future paywall variant predictions.
Send Profile Event
Record one or more user interaction events related to paywall exposure.
Validate Apple App Store Purchase
Validate an in-app purchase or subscription completed through the Apple App Store.
Validate Google Play Store Purchase
Validate an in-app purchase or subscription completed through the Google Play Store.