From fb453f40dd6ca212c0c873c1d9b4e94a571ca097 Mon Sep 17 00:00:00 2001 From: szaganek Date: Thu, 22 Oct 2026 15:32:18 +0200 Subject: [PATCH] docs: Clean up slugs for monetization topics, add redirects --- .../components/objects/actor-runs/charge.yaml | 9 +-------- nginx.conf | 10 +++++++--- sources/_partials/_agentic-payments-eligibility.mdx | 6 +++--- sources/academy/ai/ai-agents.mdx | 2 +- .../apify-store-basics/how_store_works.md | 2 +- .../apify_actors/adding_rapidapi_project.md | 2 +- .../scraping_with_ai/05_before_publishing.md | 2 +- .../actors/development/actor_definition/index.md | 2 +- .../programming_interface/actor_standby.md | 2 +- .../development/quick-start/develop-ai-agents.md | 4 ++-- .../actors/development/quick-start/web-ide.md | 2 +- sources/platform/actors/monetizing/index.mdx | 8 ++++---- .../platform/actors/monetizing/monthly-payouts.mdx | 2 +- sources/platform/actors/monetizing/pay_per_event.mdx | 12 ++++++------ .../actors/monetizing/pricing-and-costs/index.mdx | 2 +- .../monetizing/pricing-and-costs/pricing-tips.mdx | 4 ++-- .../actors/monetizing/set-up-monetization.mdx | 10 +++++----- sources/platform/actors/publishing/index.mdx | 2 +- sources/platform/actors/publishing/publish-task.mdx | 2 +- sources/platform/actors/publishing/publish/index.mdx | 2 +- sources/platform/actors/publishing/quality_score.mdx | 2 +- sources/platform/actors/running/actor_standby.md | 2 +- .../actors/running/store/actor-developers.mdx | 2 +- sources/platform/actors/running/store/index.md | 2 +- sources/platform/integrations/ai/x402.md | 2 +- .../platform/storage/dataset/multiple_datasets.mdx | 2 +- 26 files changed, 48 insertions(+), 51 deletions(-) diff --git a/apify-api/openapi/components/objects/actor-runs/charge.yaml b/apify-api/openapi/components/objects/actor-runs/charge.yaml index 5169f8a8c4..1fc9b790b6 100644 --- a/apify-api/openapi/components/objects/actor-runs/charge.yaml +++ b/apify-api/openapi/components/objects/actor-runs/charge.yaml @@ -3,16 +3,9 @@ byRunId: - Actor runs summary: Charge events in Actor run description: | - Charge for events in the run of your [pay per event Actor](https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event). + Charge for events in the run of your [pay-per-event Actor](/actors/monetize/pay-per-event). The event you are charging for must be one of the configured events in your Actor. If the Actor is not set up as pay per event, or if the event is not configured, the endpoint will return an error. The endpoint must be called from the Actor run itself, with the same API token that the run was started with. - - :::info Learn more about pay-per-event pricing - - For more details about pay-per-event (PPE) pricing, refer to our [PPE documentation](/actors/publishing/monetize/pay-per-event). - - ::: - operationId: PostChargeRun parameters: - $ref: "../../parameters/runAndBuildParameters.yaml#/runId" diff --git a/nginx.conf b/nginx.conf index 9a21fe483d..ae4c975f34 100644 --- a/nginx.conf +++ b/nginx.conf @@ -449,7 +449,7 @@ server { rewrite ^/academy/apify-platform/deploying-your-code/input-schema$ /academy/deploying-your-code/input-schema permanent; rewrite ^/academy/apify-platform/deploying-your-code/inputs-outputs$ /academy/deploying-your-code/inputs-outputs permanent; rewrite ^/academy/apify-platform/get-most-of-actors/actor-readme$ /actors/publishing/actor-readme permanent; - rewrite ^/academy/apify-platform/get-most-of-actors/monetizing-your-actor$ /platform/actors/publishing/monetize permanent; + rewrite ^/academy/apify-platform/get-most-of-actors/monetizing-your-actor$ /actors/monetize permanent; rewrite ^/academy/apify-platform/get-most-of-actors/naming-your-actor$ /academy/actor-marketing-playbook/actor-basics/name-your-actor permanent; rewrite ^/academy/apify-platform/get-most-of-actors/seo-and-promotion$ /academy/actor-marketing-playbook/promote-your-actor/seo permanent; rewrite ^/academy/apify-platform/getting-started/actors$ /academy/getting-started/actors permanent; @@ -805,13 +805,17 @@ server { # Actor marketing playbook redirects (index page removed) rewrite ^/academy/get-most-of-actors$ /academy/actor-marketing-playbook/promote-your-actor/checklist permanent; rewrite ^/academy/actor-marketing-playbook$ /academy/actor-marketing-playbook/promote-your-actor/checklist permanent; - rewrite ^/academy/get-most-of-actors/monetizing-your-actor$ /platform/actors/publishing/monetize permanent; + rewrite ^/academy/get-most-of-actors/monetizing-your-actor$ /actors/monetize permanent; # Actor README guide moved from the Academy to Publishing section rewrite ^/academy/actor-marketing-playbook/actor-basics/how-to-create-an-actor-readme$ /actors/publishing/actor-readme permanent; # Monetization overview moved from the Academy to Monetize section - rewrite ^/academy/actor-marketing-playbook/store-basics/how-actor-monetization-works$ /actors/publishing/monetize permanent; + rewrite ^/academy/actor-marketing-playbook/store-basics/how-actor-monetization-works$ /actors/monetize permanent; + + # Monetization section moved out of Publishing: /actors/publishing/monetize/* -> /actors/monetize/* + # Covers the /platform-prefixed URLs too, so they redirect in one hop, including .md twins. + rewrite ^/(platform/)?actors/publishing/monetize(\.md|/.*)?$ /actors/monetize$2 permanent; # Misc rewrite ^/platform/integrations/llama$ /platform/integrations/llama-index permanent; diff --git a/sources/_partials/_agentic-payments-eligibility.mdx b/sources/_partials/_agentic-payments-eligibility.mdx index 824465d113..7852ffb5fc 100644 --- a/sources/_partials/_agentic-payments-eligibility.mdx +++ b/sources/_partials/_agentic-payments-eligibility.mdx @@ -1,8 +1,8 @@ To be eligible for per-request agentic payments, an Actor must: -- Use the [pay-per-event](/actors/publishing/monetize/pay-per-event) pricing model. Pay-per-usage Actors are not supported. -- Charge only for events, not for [platform usage](/actors/publishing/monetize/pay-per-event#platform-usage-costs). Actors with the **Pay per event + usage** option switched on are excluded. +- Use the [pay-per-event](/actors/monetize/pay-per-event) pricing model. Pay-per-usage Actors are not supported. +- Charge only for events, not for [platform usage](/actors/monetize/pay-per-event#platform-usage-costs). Actors with the **Pay per event + usage** option switched on are excluded. - Run with [limited permissions](/actors/development/permissions). Actors that request full permissions are excluded. - Not use [Standby](/actors/running/standby) mode. -The Actor's developer must also have completed [identity verification (KYC)](/actors/publishing/monetize/monthly-payouts#verify-your-identity). Until they do, none of their Actors are eligible. +The Actor's developer must also have completed [identity verification (KYC)](/actors/monetize/monthly-payouts#verify-your-identity). Until they do, none of their Actors are eligible. diff --git a/sources/academy/ai/ai-agents.mdx b/sources/academy/ai/ai-agents.mdx index 391eb524ef..df3ccc37f2 100644 --- a/sources/academy/ai/ai-agents.mdx +++ b/sources/academy/ai/ai-agents.mdx @@ -253,7 +253,7 @@ Apify's pay-per-event (PPE) pricing model allows charging users based on specifi :::info How pay-per-event pricing works -If you want more details about PPE pricing, refer to our [PPE documentation](/actors/publishing/monetize/pay-per-event). +If you want more details about PPE pricing, refer to our [PPE documentation](/actors/monetize/pay-per-event). ::: diff --git a/sources/academy/build-and-publish/apify-store-basics/how_store_works.md b/sources/academy/build-and-publish/apify-store-basics/how_store_works.md index 5d310f11b0..46f10046f5 100644 --- a/sources/academy/build-and-publish/apify-store-basics/how_store_works.md +++ b/sources/academy/build-and-publish/apify-store-basics/how_store_works.md @@ -37,7 +37,7 @@ Actors on Apify Store can be public or private: ## How Actor monetization works (briefly) -You can monetize your Actors using pay-per-event pricing, where users pay for specific events triggered by the Actor. For details, see [Monetize Actors](/actors/publishing/monetize). +You can monetize your Actors using pay-per-event pricing, where users pay for specific events triggered by the Actor. For details, see [Monetize Actors](/actors/monetize). ## Actor ownership on Store diff --git a/sources/academy/tutorials/apify_actors/adding_rapidapi_project.md b/sources/academy/tutorials/apify_actors/adding_rapidapi_project.md index 4a2f70b839..6244e7c21f 100644 --- a/sources/academy/tutorials/apify_actors/adding_rapidapi_project.md +++ b/sources/academy/tutorials/apify_actors/adding_rapidapi_project.md @@ -120,7 +120,7 @@ Once you’ve saved the settings, go to the **Endpoints** tab, and click the **T Ready to monetize your Actor and start earning? Check out these guides: -- [Set up monetization for your Actor](https://docs.apify.com/actors/publishing/monetize) +- [Set up monetization for your Actor](https://docs.apify.com/actors/monetize) - [Publish your Actor on Apify Store](https://docs.apify.com/actors/publishing/publish) You can also extend your Actor with custom logic and leverage additional Apify platform features, such as storage or web scraping capabilities. diff --git a/sources/academy/webscraping/scraping_with_ai/05_before_publishing.md b/sources/academy/webscraping/scraping_with_ai/05_before_publishing.md index cb0c4eb996..436f5f0ad9 100644 --- a/sources/academy/webscraping/scraping_with_ai/05_before_publishing.md +++ b/sources/academy/webscraping/scraping_with_ai/05_before_publishing.md @@ -126,7 +126,7 @@ If you plan to charge for the Actor, ask the AI agent to help you think through ```text Read the Actor monetization and pricing guide: -https://docs.apify.com/actors/publishing/monetize +https://docs.apify.com/actors/monetize Then inspect this repository and recommend the most suitable pricing model for this Actor. Explain your reasoning and flag anything we should fix before publishing. diff --git a/sources/platform/actors/development/actor_definition/index.md b/sources/platform/actors/development/actor_definition/index.md index 00cfca8fb9..d14b045573 100644 --- a/sources/platform/actors/development/actor_definition/index.md +++ b/sources/platform/actors/development/actor_definition/index.md @@ -20,7 +20,7 @@ Actors have the following elements: The documentation and the input and output schemas make it possible for people to easily understand what the Actor does, enter the required inputs both in the user interface or API, and integrate the Actor's results with their other workflows. Actors can easily call and interact with each other, enabling building more complex systems on top of simple ones. -The Apify platform provides an open [API](/api/v2), cron-style [scheduler](/actors/running/schedules), [webhooks](../../../integrations/programming/webhooks/index.md), and [integrations](../../integrations) to services such as Zapier or Make, which make it easy for users to integrate Actors with their existing workflows. Anyone is welcome to [publish Actors](/actors/publishing) in [Apify Store](https://apify.com/store), and you can even [monetize your Actors](/actors/publishing/monetize). +The Apify platform provides an open [API](/api/v2), cron-style [scheduler](/actors/running/schedules), [webhooks](../../../integrations/programming/webhooks/index.md), and [integrations](../../integrations) to services such as Zapier or Make, which make it easy for users to integrate Actors with their existing workflows. Anyone is welcome to [publish Actors](/actors/publishing) in [Apify Store](https://apify.com/store), and you can even [monetize your Actors](/actors/monetize). Actors can be developed and run locally and then easily deployed to the Apify platform using the [Apify CLI](/cli) or a [GitHub integration](../../../integrations/programming/github.md). For more details, see the [Deployment](../deployment/index.md) section. diff --git a/sources/platform/actors/development/programming_interface/actor_standby.md b/sources/platform/actors/development/programming_interface/actor_standby.md index dede463ff9..345b07e281 100644 --- a/sources/platform/actors/development/programming_interface/actor_standby.md +++ b/sources/platform/actors/development/programming_interface/actor_standby.md @@ -207,4 +207,4 @@ Requests to the Standby URL require an Apify API token. See [how to authenticate You can monetize Standby Actors just like any other Actor. -For best results with Standby workflows, use the [pay-per-event pricing model](/actors/publishing/monetize/pay-per-event). In this model, users cover both the platform usage costs of their runs, as well as the event costs. +For best results with Standby workflows, use the [pay-per-event pricing model](/actors/monetize/pay-per-event). In this model, users cover both the platform usage costs of their runs, as well as the event costs. diff --git a/sources/platform/actors/development/quick-start/develop-ai-agents.md b/sources/platform/actors/development/quick-start/develop-ai-agents.md index f012012820..d918a38c7e 100644 --- a/sources/platform/actors/development/quick-start/develop-ai-agents.md +++ b/sources/platform/actors/development/quick-start/develop-ai-agents.md @@ -122,7 +122,7 @@ Pay-per-event pricing can charge users per token. To do this, extract token coun ## Monetize with pay-per-event pricing -[Pay-per-event (PPE)](/actors/publishing/monetize/pay-per-event) pricing lets you charge users for specific actions your agent performs. Use `Actor.charge()` from the [JavaScript SDK](/sdk/js/reference/class/Actor#charge) or [Python SDK](/sdk/python/reference/class/Actor#charge) to bill users for events like API calls, generated results, or token usage. +[Pay-per-event (PPE)](/actors/monetize/pay-per-event) pricing lets you charge users for specific actions your agent performs. Use `Actor.charge()` from the [JavaScript SDK](/sdk/js/reference/class/Actor#charge) or [Python SDK](/sdk/python/reference/class/Actor#charge) to bill users for events like API calls, generated results, or token usage. ### PPE for AI agents @@ -143,7 +143,7 @@ If an Actor's net profit goes negative (for example, from free-tier users consum ::: -For detailed pricing guidance, see the [pay-per-event documentation](/actors/publishing/monetize/pay-per-event). +For detailed pricing guidance, see the [pay-per-event documentation](/actors/monetize/pay-per-event). ## Deploy to Apify diff --git a/sources/platform/actors/development/quick-start/web-ide.md b/sources/platform/actors/development/quick-start/web-ide.md index d9eb2ad768..49833e0c35 100644 --- a/sources/platform/actors/development/quick-start/web-ide.md +++ b/sources/platform/actors/development/quick-start/web-ide.md @@ -91,4 +91,4 @@ Now it's time to iterate. Each change follows the same cycle: edit the code, bui - If you need inspiration, see [Find ideas for new Actors](/academy/build-and-publish/actor-ideas/find-actor-ideas). - To understand Actors in detail, read the [Actor Whitepaper](https://whitepaper.actor/). -- When your first Actor is ready, you can [publish](/actors/publishing) it on Apify Store and [monetize](/actors/publishing/monetize) it to earn revenue. +- When your first Actor is ready, you can [publish](/actors/publishing) it on Apify Store and [monetize](/actors/monetize) it to earn revenue. diff --git a/sources/platform/actors/monetizing/index.mdx b/sources/platform/actors/monetizing/index.mdx index 41b63ed8e3..7168dea04e 100644 --- a/sources/platform/actors/monetizing/index.mdx +++ b/sources/platform/actors/monetizing/index.mdx @@ -1,7 +1,7 @@ --- title: Monetize Actors description: Monetize your Actors on Apify Store and earn regular passive income. -slug: /actors/publishing/monetize +slug: /actors/monetize sidebar_position: 4 sidebar_label: Monetize --- @@ -17,20 +17,20 @@ You can monetize your automation, AI agent, and web scraping projects by publish You can publish Actors on Apify Store under one of the following pricing models: -- [Pay per event (PPE)](/actors/publishing/monetize/pay-per-event): Users pay for specific events that are programmatically triggered from the Actor's source code. You can define these events and include actions such as generating a single result or starting an Actor. You can also choose whether to pass the platform usage costs on to users. +- [Pay per event (PPE)](/actors/monetize/pay-per-event): Users pay for specific events that are programmatically triggered from the Actor's source code. You can define these events and include actions such as generating a single result or starting an Actor. You can also choose whether to pass the platform usage costs on to users. - Pay per usage: Users can run the Actor without any additional charges beyond the platform usage costs generated by the Actor. For a detailed comparison of pricing models from the perspective of your users, see [Actors in Store](/actors/running/actors-in-store). ## Fees and costs -Your payout is your Actor's revenue minus Apify's commission and platform usage costs. For details, see [Pricing and costs](/actors/publishing/monetize/pricing-and-costs). +Your payout is your Actor's revenue minus Apify's commission and platform usage costs. For details, see [Pricing and costs](/actors/monetize/pricing-and-costs). ### Platform usage Running Actors generates platform usage costs for infrastructure, proxies, and storage. Who covers these costs depends on the pricing model and the mode in which the Actor runs. -For pay-per-event Actors, Apify deducts platform usage costs from your payout. If your Actor pricing doesn't cover these costs, you might run into a [negative profit](/actors/publishing/monetize/pay-per-event#avoid-negative-profit). However, you'll never have to pay Apify for other users running your Actors. +For pay-per-event Actors, Apify deducts platform usage costs from your payout. If your Actor pricing doesn't cover these costs, you might run into a [negative profit](/actors/monetize/pay-per-event#avoid-negative-profit). However, you'll never have to pay Apify for other users running your Actors. ### Testing costs diff --git a/sources/platform/actors/monetizing/monthly-payouts.mdx b/sources/platform/actors/monetizing/monthly-payouts.mdx index a8a77b6d74..ee46720cd7 100644 --- a/sources/platform/actors/monetizing/monthly-payouts.mdx +++ b/sources/platform/actors/monetizing/monthly-payouts.mdx @@ -1,7 +1,7 @@ --- title: Manage payouts description: Learn about the monthly payouts and how to become eligible for them. -slug: /actors/publishing/monetize/monthly-payouts +slug: /actors/monetize/monthly-payouts sidebar_position: 5 --- diff --git a/sources/platform/actors/monetizing/pay_per_event.mdx b/sources/platform/actors/monetizing/pay_per_event.mdx index b4595811da..ed9fdabdf7 100644 --- a/sources/platform/actors/monetizing/pay_per_event.mdx +++ b/sources/platform/actors/monetizing/pay_per_event.mdx @@ -1,7 +1,7 @@ --- title: Pay-per-event pricing model description: Learn how to monetize your Actor with pay-per-event (PPE) pricing, charging users for specific actions like Actor starts, dataset items, or API calls. -slug: /actors/publishing/monetize/pay-per-event +slug: /actors/monetize/pay-per-event sidebar_position: 1.1 sidebar_label: Pay per event pricing model --- @@ -27,7 +27,7 @@ An event is a specific, measurable action that your Actor triggers programmatica - Processing an item. - Calling an external API. -You define the events and can set different pricing for each event type and [discount tier](/actors/publishing/monetize/pricing-and-costs#discount-tiers). +You define the events and can set different pricing for each event type and [discount tier](/actors/monetize/pricing-and-costs#discount-tiers). ### Synthetic events @@ -75,7 +75,7 @@ where: Only revenue and cost generated by users on paid plans count toward your profit. Users on the free plan are excluded from the calculation. They don't bring you revenue and Apify covers their platform usage costs. -For details, see [Actor pricing and costs](/actors/publishing/monetize/pricing-and-costs). +For details, see [Actor pricing and costs](/actors/monetize/pricing-and-costs). ### Avoid negative profit @@ -102,7 +102,7 @@ To avoid negative profit margins during initial development or when testing pric :::caution Reduced pricing transparency -Charging platform usage separately is less transparent for users and may discourage them from using your Actor. It also negatively impacts your [**Actor quality score**](../quality-score). Use this approach only until you determine accurate event prices. +Charging platform usage separately is less transparent for users and may discourage them from using your Actor. It also negatively impacts your [**Actor quality score**](/actors/publishing/quality-score). Use this approach only until you determine accurate event prices. ::: @@ -348,7 +348,7 @@ To stop charging for default dataset items automatically, remove this event from Memory allocation is the user's choice. By setting an upper limit, you prevent users from selecting more memory than your Actor needs and avoid higher platform costs. -To set memory limits, use the `minMemoryMbytes` and `maxMemoryMbytes` properties in your [`actor.json`](https://docs.apify.com/actors/development/actor-definition/actor-json) file: +To set memory limits, use the `minMemoryMbytes` and `maxMemoryMbytes` properties in your [`actor.json`](/actors/development/actor-definition/actor-json) file: ```json { @@ -458,7 +458,7 @@ Limit the number of events. Fewer events make it easier for users to understand Avoid cases where producing a single result triggers too many events. It makes your Actor more expensive. -### Make events produce visible results {#actor-events} +### Make events produce visible results Don't charge users for actions they don't see. For Actors that produce data, events should map to concrete results in the user's dataset or storage. diff --git a/sources/platform/actors/monetizing/pricing-and-costs/index.mdx b/sources/platform/actors/monetizing/pricing-and-costs/index.mdx index 57c5063d91..3c4b268a9d 100644 --- a/sources/platform/actors/monetizing/pricing-and-costs/index.mdx +++ b/sources/platform/actors/monetizing/pricing-and-costs/index.mdx @@ -2,7 +2,7 @@ title: Actor pricing and costs sidebar_label: Pricing and costs description: Learn how to set Actor pricing and calculate your costs, including platform usage rates, discount tiers, and profit formulas for the PPE model. -slug: /actors/publishing/monetize/pricing-and-costs +slug: /actors/monetize/pricing-and-costs sidebar_position: 4 --- diff --git a/sources/platform/actors/monetizing/pricing-and-costs/pricing-tips.mdx b/sources/platform/actors/monetizing/pricing-and-costs/pricing-tips.mdx index de7cdcdd2e..cd579e349f 100644 --- a/sources/platform/actors/monetizing/pricing-and-costs/pricing-tips.mdx +++ b/sources/platform/actors/monetizing/pricing-and-costs/pricing-tips.mdx @@ -2,7 +2,7 @@ title: Tips for defining the Actor price sidebar_label: Pricing tips description: Learn how to price your Actor by comparing competing tools, accounting for the platform features, and adjusting the pricing based on conversion rates. -slug: /actors/publishing/monetize/pricing-tips +slug: /actors/monetize/pricing-tips sidebar_position: 1 --- @@ -36,7 +36,7 @@ Use your [Actor README](/actors/publishing/actor-readme) to communicate the bene ## Adapt your pricing -Don’t be afraid to experiment with pricing, especially at the beginning. You can also [pass platform usage costs to users](/actors/publishing/monetize/pay-per-event#platform-usage-costs) while figuring out the right price. +Don’t be afraid to experiment with pricing, especially at the beginning. You can also [pass platform usage costs to users](/actors/monetize/pay-per-event#platform-usage-costs) while figuring out the right price. Keep an eye on SEO. If you monitor the volume of the keywords your Actor is targeting as well as how well your Actor's page is ranking for those keywords, you can estimate the number of people who actually end up trying your tool. It's called the conversion rate. diff --git a/sources/platform/actors/monetizing/set-up-monetization.mdx b/sources/platform/actors/monetizing/set-up-monetization.mdx index e5223209e6..252bce9b36 100644 --- a/sources/platform/actors/monetizing/set-up-monetization.mdx +++ b/sources/platform/actors/monetizing/set-up-monetization.mdx @@ -21,10 +21,10 @@ To set up monetization for your Actor, first complete your billing and payment d 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). + - Modify or delete the [`apify-actor-start`](/actors/monetize/pay-per-event#synthetic-start-event) event. + - Modify or delete the [`apify-default-dataset-item`](/actors/monetize/pay-per-event#synthetic-default-dataset-item-event) event. + - Define [custom events](/actors/monetize/pay-per-event#actor-events) and their prices. + - [Transfer the platform usage costs on to users](/actors/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. @@ -39,7 +39,7 @@ Be careful about increasing prices. If you make your Actor too expensive, users :::tip Negative profit -If your Actor generates negative profit, [follow the recommendations](/actors/publishing/monetize/pay-per-event#avoid-negative-profit) before increasing the price. +If your Actor generates negative profit, [follow the recommendations](/actors/monetize/pay-per-event#avoid-negative-profit) before increasing the price. ::: diff --git a/sources/platform/actors/publishing/index.mdx b/sources/platform/actors/publishing/index.mdx index 72a66aabc9..d51a48f080 100644 --- a/sources/platform/actors/publishing/index.mdx +++ b/sources/platform/actors/publishing/index.mdx @@ -13,7 +13,7 @@ slug: /actors/publishing To build & publish an Actor on [Apify Store](https://apify.com/store), you'll go through the following main stages: 1. [Development](../development/index.md). -2. [Publication](./publishing/publish) and set up of [monetization](./publishing/monetize). +2. [Publication](./publishing/publish) and set up of [monetization](/actors/monetize). 3. [Testing](../development/automated_tests.md). 4. [Promotion](https://apify.notion.site/3fdc9fd4c8164649a2024c9ca7a2d0da?v=6d262c0b026d49bfa45771cd71f8c9ab). diff --git a/sources/platform/actors/publishing/publish-task.mdx b/sources/platform/actors/publishing/publish-task.mdx index a91010c8d7..b8899da293 100644 --- a/sources/platform/actors/publishing/publish-task.mdx +++ b/sources/platform/actors/publishing/publish-task.mdx @@ -282,5 +282,5 @@ When a user clicks the call-to-action button, Apify creates a new task under the ## Next steps -- Set up [monetization](/actors/publishing/monetize) for your Actor. +- Set up [monetization](/actors/monetize) for your Actor. - Track quality with the [Actor quality score](./quality_score.mdx). diff --git a/sources/platform/actors/publishing/publish/index.mdx b/sources/platform/actors/publishing/publish/index.mdx index 6e6538435b..5d94539185 100644 --- a/sources/platform/actors/publishing/publish/index.mdx +++ b/sources/platform/actors/publishing/publish/index.mdx @@ -25,7 +25,7 @@ To make your Actor available on Apify Store: Complete all required fields in the following sections: 1. In the **Display information** section, add an Actor logo and [description](/academy/actor-marketing-playbook/actor-basics/actor-description). -1. In the **Monetization** section, [set up monetization](/actors/publishing/monetize) for your Actor. +1. In the **Monetization** section, [set up monetization](/actors/monetize) for your Actor. 1. In the **Sample output** section, add a sample output for your Actor. If the [input schema](/actors/development/actor-definition/input-schema) already includes the sample output, it's added automatically. 1. In the **Output schema** section, define the [output schema](/actors/development/actor-definition/output-schema) of your Actor. Optionally, define also the following schemas: - [Dataset schema](/storage/dataset-schema) diff --git a/sources/platform/actors/publishing/quality_score.mdx b/sources/platform/actors/publishing/quality_score.mdx index c3d58c3ff9..e0b4c95220 100644 --- a/sources/platform/actors/publishing/quality_score.mdx +++ b/sources/platform/actors/publishing/quality_score.mdx @@ -71,7 +71,7 @@ Ease of use evaluates how quickly users can understand and successfully run your ### Pricing transparency -Pricing transparency evaluates how clearly users can understand and predict the costs of running your Actor. Transparent pricing models help users make informed decisions and budget accordingly. The [pay-per-event (PPE)](/actors/publishing/monetize/pay-per-event) monetization model provides predictable, event-based pricing that makes costs explicit and easier to estimate. +Pricing transparency evaluates how clearly users can understand and predict the costs of running your Actor. Transparent pricing models help users make informed decisions and budget accordingly. The [pay-per-event (PPE)](/actors/monetize/pay-per-event) monetization model provides predictable, event-based pricing that makes costs explicit and easier to estimate. Consider offering discounts for Bronze, Silver, and Gold subscription tiers. These incentives reward committed platform users and can increase your Actor's adoption among engaged customers. diff --git a/sources/platform/actors/running/actor_standby.md b/sources/platform/actors/running/actor_standby.md index 92d0cad383..0ae933cde5 100644 --- a/sources/platform/actors/running/actor_standby.md +++ b/sources/platform/actors/running/actor_standby.md @@ -105,7 +105,7 @@ sure to use that in your application if you wish to use the custom configuration No, the Standby runs are billed in the same fashion as the normal runs. However, running Actors in Standby mode might have unexpected costs, as the Actors run in the background and consume resources even when no requests are being sent until they are terminated after the idle timeout period. -For Actors monetized with the [pay-per-event pricing model](/actors/publishing/monetize/pay-per-event), you pay the platform usage costs of the Standby runs in addition to the event charges. +For Actors monetized with the [pay-per-event pricing model](/actors/monetize/pay-per-event), you pay the platform usage costs of the Standby runs in addition to the event charges. ## Are the Standby runs shared among users diff --git a/sources/platform/actors/running/store/actor-developers.mdx b/sources/platform/actors/running/store/actor-developers.mdx index 0d597669ab..ddf7971ed3 100644 --- a/sources/platform/actors/running/store/actor-developers.mdx +++ b/sources/platform/actors/running/store/actor-developers.mdx @@ -22,7 +22,7 @@ To see who owns an Actor: ### Verified developers -A blue badge next to a developer's name means that Apify has [verified their identity](/actors/publishing/monetize/monthly-payouts#verify-your-identity). +A blue badge next to a developer's name means that Apify has [verified their identity](/actors/monetize/monthly-payouts#verify-your-identity). A missing badge doesn't mean the Actor is unsafe. A developer's verified identity is only one of many signals to consider before you run the Actor. diff --git a/sources/platform/actors/running/store/index.md b/sources/platform/actors/running/store/index.md index bcf30891bd..38d706b21c 100644 --- a/sources/platform/actors/running/store/index.md +++ b/sources/platform/actors/running/store/index.md @@ -10,7 +10,7 @@ toc_max_heading_level: 4 :::info Publishing and monetizing Actors -Anyone is welcome to [publish Actors](/actors/publishing) in the store, and you can even [monetize your Actors](/actors/publishing/monetize). For more information about how to monetize your Actor, best practices, SEO, and promotion tips and tricks, head over to the [Marketing checklist](/academy/actor-marketing-playbook/promote-your-actor/checklist) section of the Apify Developers Academy. +Anyone is welcome to [publish Actors](/actors/publishing) in the store, and you can even [monetize your Actors](/actors/monetize). For more information about how to monetize your Actor, best practices, SEO, and promotion tips and tricks, head over to the [Marketing checklist](/academy/actor-marketing-playbook/promote-your-actor/checklist) section of the Apify Developers Academy. ::: diff --git a/sources/platform/integrations/ai/x402.md b/sources/platform/integrations/ai/x402.md index b19f1e3260..2c791ad781 100644 --- a/sources/platform/integrations/ai/x402.md +++ b/sources/platform/integrations/ai/x402.md @@ -152,5 +152,5 @@ A prepaid token works like a regular API token, so it runs any Actor that uses l ## Next steps - Browse [Apify Store](https://apify.com/store) for supported Actors to use with x402. -- Learn more about [pay-per-event](/actors/publishing/monetize/pay-per-event) pricing for Actors. +- Learn more about [pay-per-event](/actors/monetize/pay-per-event) pricing for Actors. - Read the [x402 protocol specification](https://www.x402.org/) for technical details on the payment standard. diff --git a/sources/platform/storage/dataset/multiple_datasets.mdx b/sources/platform/storage/dataset/multiple_datasets.mdx index af00d9614b..4a24d0c0da 100644 --- a/sources/platform/storage/dataset/multiple_datasets.mdx +++ b/sources/platform/storage/dataset/multiple_datasets.mdx @@ -161,4 +161,4 @@ The Storage tab shows data but doesn't surface it clearly to end users. To prese When an Actor uses multiple datasets, only items pushed to the `default` dataset trigger the built-in `apify-default-dataset-item` event. Items in other datasets are not charged automatically. -To charge for items in other datasets, implement custom billing in your Actor code. Refer to the [billing documentation](/actors/publishing/monetize/pay-per-event) for implementation details. +To charge for items in other datasets, implement custom billing in your Actor code. Refer to the [billing documentation](/actors/monetize/pay-per-event) for implementation details.