From 97bbce2870db0d18055284727a0f7fda5829beb3 Mon Sep 17 00:00:00 2001 From: szaganek Date: Thu, 13 Aug 2026 11:06:30 +0200 Subject: [PATCH] docs: Turn the procedure on setting up monetization into a separate topic --- sources/platform/actors/monetizing/index.mdx | 69 +------------------ .../actors/monetizing/monthly-payouts.mdx | 2 +- .../actors/monetizing/set-up-monetization.mdx | 68 ++++++++++++++++++ 3 files changed, 71 insertions(+), 68 deletions(-) create mode 100644 sources/platform/actors/monetizing/set-up-monetization.mdx diff --git a/sources/platform/actors/monetizing/index.mdx b/sources/platform/actors/monetizing/index.mdx index 22112d1258..41a7c933ac 100644 --- a/sources/platform/actors/monetizing/index.mdx +++ b/sources/platform/actors/monetizing/index.mdx @@ -10,7 +10,8 @@ import Tabs from '@theme/Tabs'; import TabItem from '@theme/TabItem'; import RentalSunset from '../../../_partials/_rental-sunsetting.mdx'; -Apify Store allows you to monetize your web scraping, automation, and AI agent projects by publishing them as paid Actors. + +You can monetize your web scraping, automation, and AI agent projects by publishing them as paid Actors on [Apify Store](https://apify.com/store). ## Pricing models @@ -21,72 +22,6 @@ You can publish Actors on Apify Store under one of the following pricing models: For a detailed comparison of pricing models from the perspective of your users, see [Actors in Store](/actors/running/actors-in-store). -## Set up monetization - -To set up monetization for your Actor, first complete your billing and payment details. Then, you can define the pricing for your Actor: - -1. Log in to [Apify Console](https://console.apify.com). -1. In the left-side panel, go to **Development** > **My Actors**. -1. From the table, select the Actor you want to monetize. -1. Go to the **Publication** tab. -1. In **Monetization** section, select **Set up monetization**. - -The monetization setup consists of three steps: - -1. In the **Actor pricing** step, you can: - - Modify or delete the [`apify-actor-start`](/actors/publishing/monetize/pay-per-event#synthetic-start-event) event. - - Modify or delete the [`apify-default-dataset-item`](/actors/publishing/monetize/pay-per-event#synthetic-default-dataset-item-event) event. - - Define [custom events](/actors/publishing/monetize/pay-per-event#actor-events) and their prices. - - [Transfer the platform usage costs on to users](/actors/publishing/monetize/pay-per-event#platform-usage-costs). - - Set the minimal cost that users can choose as max cost per run. -1. In the **Primary event** step, select the event that best represents the main value of your Actor. By default, the dataset event or the only existing event is used. -1. In the **Review** step, verify the final pricing for your Actor before confirming. - -![Publication tab in Apify Console](./images/monetization.svg) - -### Change monetization - -You can change the monetization setting of your Actor by using the same wizard as for the setup in the **Monetization** section of your Actor's **Publication** tab. - -Changes are split into two categories: _significant_ and _non-significant_. Non-significant changes take effect immediately, while significant changes require a 14-day notice period to give your users time to adjust. - -#### Significant changes - -The following changes are considered significant and require a _14-day notice period_: - -- Changing the pricing model (e.g., from rental to pay-per-event) -- Increasing prices -- Adding new paid events - -When you submit a significant change, users of your Actor are notified and the change is scheduled to take effect after 14 days. During this waiting period, the current pricing remains active. - -#### Non-significant changes - -The following changes take effect **immediately**: - -- Decreasing prices -- Removing events -- Updating event descriptions -- Adjusting other non-pricing settings - -#### Restrictions on significant changes - -:::caution You cannot cancel a planned change - -Once you commit to a significant change, you cannot cancel or modify it yourself. If you need to revert a planned change, contact [Apify support](https://apify.com/contact). - -::: - -Significant changes are limited to _once per month_ per Actor. After submitting a significant change, you must wait for the full cycle to complete before making another one: - -1. You submit a significant change. For example, a price increase. -1. The change takes effect after _14 days_. -1. You can then submit your next significant change, which also takes _14 days_ to apply. - -This means approximately _one month_ passes between committing to one significant change and having the next one take effect. Plan your pricing strategy carefully before committing. - -For full details on the rules governing monetization changes, refer to the [Store publishing terms and conditions](/legal/store-publishing-terms-and-conditions). - ## Make your Actor eligible for agentic payments Agentic payments let AI agents discover, run, and pay for your Actor without an Apify account, using protocols such as [x402](/integrations/x402) and [Skyfire](/integrations/skyfire). Eligible Actors are flagged with `allowsAgenticUsers=true` and surface in agentic discovery, for example when [searching the store via API](https://docs.apify.com/api/v2#/reference/store/store-actors-collection/get-list-of-actors-in-store) with `allowsAgenticUsers=true`. diff --git a/sources/platform/actors/monetizing/monthly-payouts.mdx b/sources/platform/actors/monetizing/monthly-payouts.mdx index 3f896b82f1..81ad6a27e5 100644 --- a/sources/platform/actors/monetizing/monthly-payouts.mdx +++ b/sources/platform/actors/monetizing/monthly-payouts.mdx @@ -2,7 +2,7 @@ title: Manage payouts description: Learn about the monthly payouts and how to become eligible for them. slug: /actors/publishing/monetize/monthly-payouts -sidebar_position: 1 +sidebar_position: 1.1 --- To be eligible for payouts, you need to complete your billing details, choose a payment method, and verify your identity. diff --git a/sources/platform/actors/monetizing/set-up-monetization.mdx b/sources/platform/actors/monetizing/set-up-monetization.mdx new file mode 100644 index 0000000000..ed45cbd822 --- /dev/null +++ b/sources/platform/actors/monetizing/set-up-monetization.mdx @@ -0,0 +1,68 @@ +--- +title: Set up monetization +description: Learn how to set up and change monetization for your Actor in Apify Console. +slug: /actors/monetize/set-up-monetization +sidebar_position: 1 +--- + +Set up monetization to earn revenue every time users run your Actors on the Apify platform. + +## Monetize your Actor + +To set up monetization for your Actor, first complete your billing and payment details. Then, you can define the pricing for your Actor: + +1. Log in to [Apify Console](https://console.apify.com). +1. In the left-side panel, go to **Development** > **My Actors**. +1. From the table, select the Actor you want to monetize. +1. Go to the **Publication** tab. +1. In **Monetization** section, select **Set up monetization**. + +The monetization setup consists of three steps: + +1. In the **Actor pricing** step, you can: + - Modify or delete the [`apify-actor-start`](/actors/publishing/monetize/pay-per-event#synthetic-start-event) event. + - Modify or delete the [`apify-default-dataset-item`](/actors/publishing/monetize/pay-per-event#synthetic-default-dataset-item-event) event. + - Define [custom events](/actors/publishing/monetize/pay-per-event#actor-events) and their prices. + - [Transfer the platform usage costs on to users](/actors/publishing/monetize/pay-per-event#platform-usage-costs). + - Set the minimal cost that users can choose as max cost per run. +1. In the **Primary event** step, select the event that best represents the main value of your Actor. By default, the dataset event or the only existing event is used. +1. In the **Review** step, verify the final pricing for your Actor before confirming. + +![Publication tab in Apify Console](./images/monetization.svg) + +## Change monetization + +To update the monetization of your Actor, follow the same steps as in the [Monetize your Actor](#monetize-your-actor) section. + +### Significant changes + +The following changes are considered significant: + +- Changing the pricing model. For example, from rental to pay per event. +- Increasing prices. +- Adding a new paid event. + +When you submit a significant change, users of your Actor are notified and the change is scheduled to take effect after 14 days. During this waiting period, the current pricing remains active. + +:::caution You can't cancel a planned change + +Once you submit a significant change, you can't cancel or modify it. To revert a planned change, [contact support](https://apify.com/contact). + +::: + +You can apply a significant change only once per month per Actor. The cycle looks the following way: + +1. You submit a significant change. +1. The change takes effect after 14 days. +1. Once the change is applied, you can submit another significant change. The new change also takes 14 days to apply. + +Plan your pricing strategy carefully. For details, see [Apify Store publishing terms and conditions](/legal/store-publishing-terms-and-conditions). + +### Non-significant changes + +The following changes take effect immediately and don't have any restrictions: + +- Decreasing prices. +- Removing events. +- Updating event descriptions. +- Adjusting settings that aren't related to pricing.