docs: ppr announced as legacy model, ppr to ppe migration #2144

VojtaKai · 2025-12-12T10:23:29Z

Documentation explaining to users that PPR pricing model is now a legacy pricing model. There is an option to migrate to PPE using a migration button.

Other minor fixes.

Note

Marks PPR as a legacy model with a one-click migration to PPE; clarifies PPE spending-limit behavior and updates quality score categories.

Monetization
- sources/platform/actors/publishing/monetize/pay_per_result.mdx:
  - Add warning that PPR is deprecated and will be replaced by PPE by Jan 2026.
  - Add “One click migration to PPE” section with instructions and migration button screenshot.
- sources/platform/actors/publishing/monetize/pay_per_event.mdx:
  - Clarify eventChargeLimitReached description to reflect user-set limit behavior.
  - Note that the SDK ChargeResult already respects ACTOR_MAX_TOTAL_CHARGE_USD.
Quality score
- sources/platform/actors/publishing/quality_score.mdx:
  - Minor copy tweak for category intro; add “Trustworthiness” to the category list.

^{Written by Cursor Bugbot for commit e396273. Configure here.}

apify-service-account · 2025-12-12T10:26:26Z

Preview for this PR was built for commit e396273 and is ready at https://pr-2144.preview.docs.apify.com!

metalwarrior665

lgtm but wait for other reviews pls

apify-service-account · 2025-12-12T14:47:19Z

Preview for this PR was built for commit ea15b67f and is ready at https://pr-2144.preview.docs.apify.com!

apify-service-account · 2025-12-12T15:04:42Z

Preview for this PR was built for commit 6facd194 and is ready at https://pr-2144.preview.docs.apify.com!

apify-service-account · 2025-12-15T15:02:21Z

Preview for this PR was built for commit 499d4e80 and is ready at https://pr-2144.preview.docs.apify.com!

apify-service-account · 2025-12-15T15:09:58Z

Preview for this PR was built for commit 12d9de3a and is ready at https://pr-2144.preview.docs.apify.com!

mhamas

In general, it looks good to me, pre-approving. Please, consider the comments and have the docs team do the final pass of the text.

mhamas · 2025-12-15T16:52:32Z

sources/platform/actors/publishing/monetize/pay_per_result.mdx


+:::warning Legacy pricing model
+
+Pay per result is a deprecated and will be replaced by Pay per event by the end of January 2026. [Migrate to PPE in one click](#one-click-migration-to-ppe)


Suggested change

Pay per result is a deprecated and will be replaced by Pay per event by the end of January 2026. [Migrate to PPE in one click](#one-click-migration-to-ppe)

Pay per result is deprecated and will be superseded by Pay per event early in 2026. [Migrate to PPE in one click - fully backward compatible](#one-click-migration-to-ppe)

mhamas · 2025-12-15T17:03:18Z

sources/platform/actors/publishing/monetize/pay_per_result.mdx

+Select your PPR Actor, go to the Publication tab, open the Monetization section, and click the `Migrate to Pay per event` button.
+
+![Migration button](../images/ppr-to-ppe-migration-button.png)
+


Suggested change

### Why should I migrate?

The pay-per-event pricing model offers superior flexibility in charging not only for the results but also for any event. This helps you to pass on the costs of external APIs or additional processing directly to your users, price different functionalities of your Actor differently, avoid revenue loss from small but usage-heavy runs, and more.

Given that the Pay per event model is fully compatible with Pay per result, and to bring more simplicity to users of your Actors, we are fully deprecating PPR in favour of PPE. But no worries, the migration is completely automatic and fully backward compatible.

mhamas · 2025-12-15T17:04:00Z

sources/platform/actors/publishing/monetize/pay_per_result.mdx

+
+### What happens during migration
+
+The migration switches your pricing model from Pay per result to Pay per event. Your price per 1,000 results is automatically converted to an equivalent `apify-default-dataset-item` [event](./pay-per-event#use-synthetic-default-dataset-item-event-apify-default-dataset-item) price.


Suggested change

The migration switches your pricing model from Pay per result to Pay per event. Your price per 1,000 results is automatically converted to an equivalent `apify-default-dataset-item` [event](./pay-per-event#use-synthetic-default-dataset-item-event-apify-default-dataset-item) price.

The migration switches your pricing model from Pay per result to Pay per event. Your price per 1,000 results is automatically converted to an equivalent `apify-default-dataset-item` [event](./pay-per-event#use-synthetic-default-dataset-item-event-apify-default-dataset-item) price. This change does not count towards the pricing change limits that you are allowed to do once every 30 days.

I was thinking of adding this exact line but then I removed it.
It's back in now :]

mhamas · 2025-12-15T17:09:05Z

sources/platform/actors/publishing/monetize/pay_per_result.mdx

+
+**After migration:** With Pay per event, you can define additional custom events beyond dataset items. See [PPE best practices](./pay-per-event#best-practices-for-ppe-actors) for guidance.
+
+**Respecting user spending limits:** You can continue using the `ACTOR_MAX_PAID_DATASET_ITEMS` environment variable to respect user-specified price limits. However, we recommend using the Apify SDK's built-in methods, which automatically handle spending limits for you. [Learn more](./pay-per-event#respect-user-spending-limits)


Suggestion: Please, do not add the part about using Apify SDK's built-in methods, because it's currently broken for synthetic events: apify/apify-sdk-js#528

I'd just add that if they decide to add any more events in the future, they should read all pay-per-event docs.

Suggested change

**Respecting user spending limits:** You can continue using the `ACTOR_MAX_PAID_DATASET_ITEMS` environment variable to respect user-specified price limits. However, we recommend using the Apify SDK's built-in methods, which automatically handle spending limits for you. [Learn more](./pay-per-event#respect-user-spending-limits)

**Respecting user spending limits:** You can continue using the `ACTOR_MAX_PAID_DATASET_ITEMS` environment variable to respect user-specified price limits. If you decide to add more events in the future, please read our Pay per event documentation [link].

I actually removed this all together because two lines above I talk about additional events so I just referenced the PPE documentation there.

apify-service-account · 2025-12-16T08:37:22Z

Preview for this PR was built for commit d2add141 and is ready at https://pr-2144.preview.docs.apify.com!

apify-service-account · 2025-12-16T12:24:34Z

Preview for this PR was built for commit d4ef2ef9 and is ready at https://pr-2144.preview.docs.apify.com!

marcel-rbro · 2025-12-16T12:45:03Z

sources/platform/actors/publishing/monetize/pay_per_result.mdx

+
+**Respecting user spending limits:** You can continue using the `ACTOR_MAX_PAID_DATASET_ITEMS` environment variable to respect user-specified price limits.
+
+Bleu sky and flying high free as a bird


What is this? Is this some sort of Lorem Ipsum?

It should not be there. I was testing the tool vale.sh and commited the testing text.. :D

I am super pleased to hear you were testing Vale :D

marcel-rbro · 2025-12-16T12:56:07Z

sources/platform/actors/publishing/monetize/pay_per_result.mdx


+## One click migration to PPE
+
+Select your PPR Actor, go to the Publication tab, open the Monetization section, and click the `Migrate to Pay per event` button.


Suggested change

Select your PPR Actor, go to the Publication tab, open the Monetization section, and click the `Migrate to Pay per event` button.

Select your PPR Actor, go to the **Publication** tab, open the **Monetization** section, and click the **Migrate to Pay per event** button.

marcel-rbro · 2025-12-16T12:57:29Z

sources/platform/actors/publishing/monetize/pay_per_result.mdx

+
+### Why should I migrate?
+
+The Pay per event pricing model offers superior flexibility in charging not only for the results but also for any event.


Suggested change

The Pay per event pricing model offers superior flexibility in charging not only for the results but also for any event.

The pay per event pricing model offers superior flexibility in charging not only for the results but also for any event.

You can also use italics to highlight: price per event model offers...

This is valid for the entire PR, there's several locations where capital P is used unnecessarily

sources/platform/actors/publishing/monetize/pay_per_result.mdx

TC-MO · 2025-12-18T08:40:10Z

sources/platform/actors/publishing/monetize/pay_per_result.mdx

+:::warning Legacy pricing model
+
+Pay per result is deprecated and will be superseded by Pay per event early in 2026. [Migrate to PPE in one click](#one-click-migration-to-ppe) (backward compatible)
+
+:::


PPR is depracted & considered legacy right now, but will be superseded by PPE early in 2026? That doesn't make sense to me.

It has been deprecated now and will be completely replaced with PPE. Not sure how to word that the best.

Perhaps something like this:

Suggested change

:::warning Legacy pricing model

Pay per result is deprecated and will be superseded by Pay per event early in 2026. [Migrate to PPE in one click](#one-click-migration-to-ppe) (backward compatible)

:::

:::warning Pay per result is deprecated

Pay per result is deprecated and will be removed in 2026. You can migrate to pay per event with one click, and the migration is backward compatible.

[Migrate to pay per event](#one-click-migration-to-ppe)

:::

or

Suggested change

:::warning Legacy pricing model

Pay per result is deprecated and will be superseded by Pay per event early in 2026. [Migrate to PPE in one click](#one-click-migration-to-ppe) (backward compatible)

:::

:::warning Pay per result is deprecated

Pay per result is deprecated and will be removed. You can migrate to pay per event with one click, and the migration is backward compatible.

[Migrate to pay per event](#one-click-migration-to-ppe)

:::

In v1 we mention just a year, reason being to give reasonable timeframe, but not commit to anything specific.

In v2 I've skipped a year completely to just reflect current state, without mentioning any future possibilities.

thanks @TC-MO! I'll go with the v1

I got inspired by v1

apify-service-account · 2025-12-19T11:38:25Z

Preview for this PR was built for commit 3e132e9b and is ready at https://pr-2144.preview.docs.apify.com!

PPR announced as legacy model, minor doc fixes

e396273

VojtaKai requested a review from metalwarrior665 December 12, 2025 10:23

VojtaKai self-assigned this Dec 12, 2025

VojtaKai requested a review from TC-MO as a code owner December 12, 2025 10:23

github-actions bot added this to the 129th sprint - Cash & Community team milestone Dec 12, 2025

github-actions bot added the t-c&c Team covering store and finance matters. label Dec 12, 2025

metalwarrior665 requested a review from patrikbraborec December 12, 2025 11:10

metalwarrior665 approved these changes Dec 12, 2025

View reviewed changes

zoom in on PPR to PPE migration

ea15b67

VojtaKai requested a review from mhamas December 12, 2025 14:57

fixed linter error

6facd19

TC-MO requested a review from marcel-rbro December 15, 2025 13:29

improved wording

499d4e8

better wording

12d9de3

mhamas approved these changes Dec 15, 2025

View reviewed changes

polished texts

d2add14

fixed linter error

d4ef2ef

patrikbraborec approved these changes Dec 16, 2025

View reviewed changes

marcel-rbro requested changes Dec 16, 2025

View reviewed changes

TC-MO reviewed Dec 18, 2025

View reviewed changes

implemented pr suggestions

3e132e9

VojtaKai requested a review from marcel-rbro December 19, 2025 11:40


		:::warning Legacy pricing model

		Pay per result is a deprecated and will be replaced by Pay per event by the end of January 2026. [Migrate to PPE in one click](#one-click-migration-to-ppe)

	Pay per result is a deprecated and will be replaced by Pay per event by the end of January 2026. [Migrate to PPE in one click](#one-click-migration-to-ppe)
	Pay per result is deprecated and will be superseded by Pay per event early in 2026. [Migrate to PPE in one click - fully backward compatible](#one-click-migration-to-ppe)

		Select your PPR Actor, go to the Publication tab, open the Monetization section, and click the `Migrate to Pay per event` button.

		![Migration button](../images/ppr-to-ppe-migration-button.png)

+### Why should I migrate?
+The pay-per-event pricing model offers superior flexibility in charging not only for the results but also for any event. This helps you to pass on the costs of external APIs or additional processing directly to your users, price different functionalities of your Actor differently, avoid revenue loss from small but usage-heavy runs, and more.
+Given that the Pay per event model is fully compatible with Pay per result, and to bring more simplicity to users of your Actors, we are fully deprecating PPR in favour of PPE.  But no worries, the migration is completely automatic and fully backward compatible.


		### What happens during migration

		The migration switches your pricing model from Pay per result to Pay per event. Your price per 1,000 results is automatically converted to an equivalent `apify-default-dataset-item` [event](./pay-per-event#use-synthetic-default-dataset-item-event-apify-default-dataset-item) price.


		After migration: With Pay per event, you can define additional custom events beyond dataset items. See [PPE best practices](./pay-per-event#best-practices-for-ppe-actors) for guidance.

		Respecting user spending limits: You can continue using the `ACTOR_MAX_PAID_DATASET_ITEMS` environment variable to respect user-specified price limits. However, we recommend using the Apify SDK's built-in methods, which automatically handle spending limits for you. [Learn more](./pay-per-event#respect-user-spending-limits)


		Respecting user spending limits: You can continue using the `ACTOR_MAX_PAID_DATASET_ITEMS` environment variable to respect user-specified price limits.

		Bleu sky and flying high free as a bird


		## One click migration to PPE

		Select your PPR Actor, go to the Publication tab, open the Monetization section, and click the `Migrate to Pay per event` button.

	Select your PPR Actor, go to the Publication tab, open the Monetization section, and click the `Migrate to Pay per event` button.
	Select your PPR Actor, go to the Publication tab, open the Monetization section, and click the Migrate to Pay per event button.


		### Why should I migrate?

		The Pay per event pricing model offers superior flexibility in charging not only for the results but also for any event.

-:::warning Legacy pricing model
-Pay per result is deprecated and will be superseded by Pay per event early in 2026. [Migrate to PPE in one click](#one-click-migration-to-ppe) (backward compatible)
-:::
+:::warning Pay per result is deprecated
+Pay per result is deprecated and will be removed in 2026. You can migrate to pay per event with one click, and the migration is backward compatible.
+[Migrate to pay per event](#one-click-migration-to-ppe)
+:::

docs: ppr announced as legacy model, ppr to ppe migration #2144

Are you sure you want to change the base?

docs: ppr announced as legacy model, ppr to ppe migration #2144

Uh oh!

Conversation

VojtaKai commented Dec 12, 2025 • edited by cursor bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

apify-service-account commented Dec 12, 2025

Uh oh!

metalwarrior665 left a comment

Choose a reason for hiding this comment

Uh oh!

apify-service-account commented Dec 12, 2025

Uh oh!

apify-service-account commented Dec 12, 2025

Uh oh!

apify-service-account commented Dec 15, 2025

Uh oh!

apify-service-account commented Dec 15, 2025

Uh oh!

mhamas left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

apify-service-account commented Dec 16, 2025

Uh oh!

apify-service-account commented Dec 16, 2025

Uh oh!

Choose a reason for hiding this comment

Uh oh!

VojtaKai Dec 19, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

apify-service-account commented Dec 19, 2025

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

8 participants

VojtaKai commented Dec 12, 2025 •

edited by cursor bot

Loading

VojtaKai Dec 19, 2025 •

edited

Loading