About the Premium Features API

The Premium Features API lets you check whether a site can perform social media marketing actions and how much quota remains on its plan. Publishing, scheduling, and AI content generation are gated by premium features. Call this API before you publish, schedule, or generate content to avoid failed requests when a site has reached its limit.

With the Premium Features API, you can:

• Check eligibility and remaining quota for a single feature, such as publishing or scheduling a post.
• Retrieve eligibility and quota for multiple features in one call.

Common features include:

• PUBLISH_POST: Required before you publish an item.
• SCHEDULE_POST: Required before you schedule an item for a future date.
• AI_TOOLS: Required before you call methods in the Generated Content API.

Wix includes a free monthly quota for social media marketing actions, and sites can upgrade to a paid plan for higher limits. See Upgrading your social media marketing plan.

Before you begin

It's important to note the following points before starting to code:

• A valid request to publish or schedule can still fail if the site is not eligible for the feature or has no remaining quota. Always check the relevant feature before calling the Items API or Generated Content API.
• Quota is consumed when a publish or schedule succeeds. If the action fails or a scheduled post is canceled, quota may be restored depending on the outcome.

Use cases

• Create and publish a post.
• Schedule a post for a future date.
• Generate post content and publish it.
• Generate a caption for a post.

Terminology

• Premium feature: A capability, such as publishing or scheduling a post, whose availability and quota depend on the site's social media marketing plan.
• Eligibility: Whether the site is allowed to use a feature on its current plan.
• Quota: How many times the site can use a feature in the current billing period.

See also

• About the Items API.
• About the Generated Content API.