Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs: updates & rewrites to actors in store page #878

Merged
merged 8 commits into from
Mar 18, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
118 changes: 64 additions & 54 deletions sources/platform/actors/running/store.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,129 +3,125 @@
description: Apify Store is home to hundreds of public Actors available to the Apify community. It's the easiest way for you to start with Apify.
sidebar_position: 1
slug: /actors/running/actors-in-store
#display H2 to H4 heading
toc_min_heading_level: 2
toc_max_heading_level: 4
---

**[Apify Store](https://apify.com/store) is home to hundreds of public Actors available to the Apify community. It's the easiest way for you to start with Apify.**

---

> Anyone is welcome to [publish Actors](/platform/actors/publishing) in the store, and you can even [monetize your Actors](/platform/actors/publishing/monetize). For more information about how to monetize your Actor, best practices, SEO, and promotion tips and tricks, head over to the [Getting the most of your public Actors in Apify Store](/academy/get-most-of-actors) section of the Apify Developers Academy.
:::info Publishing and monetizing Actors

Anyone is welcome to [publish Actors](/platform/actors/publishing) in the store, and you can even [monetize your Actors](/platform/actors/publishing/monetize). For more information about how to monetize your Actor, best practices, SEO, and promotion tips and tricks, head over to the [Getting the most of your public Actors in Apify Store](/academy/get-most-of-actors) section of the Apify Developers Academy.

Some Actors are free to use (you will be charged only for the Apify platform usage), while others are paid with different pricing models. This page explains all the options.
:::

## Pricing models

All Actors in [Apify Store](https://apify.com/store) fall into one of these three pricing models:
All Actors in [Apify Store](https://apify.com/store) fall into one of the three pricing models:

1. [**free**](#free-actors) - you can run the Actor freely and you only pay for the platform usage the Actor generates.
2. [**rental**](#rental-actors) - same as free, but in order to be able to run the Actor after the trial period, you need to rent the Actor from the developer and pay a flat monthly fee on the top of the platform usage the Actor generates.
3. [**paid per result**](#actors-paid-per-result) - you do not pay for platform usage the Actor generates and only pay for the results it produces.

### Free Actors

When you use a free Actor, you are only charged for the platform usage that the runs of this Actor generates. [Platform usage](./usage_and_resources.md) includes components such as compute units, operations on [storages](/platform/storage), and usage of [residential proxies](/platform/proxy/residential-proxy) or [SERPs](/platform/proxy/google-serp-proxy). You can find the details of your Actor usage on the run detail page.

![Example run usage](./images/store/example_run_usage.png)

> With this model, it's very easy to see how many platform resources each Actor run consumed, but it is quite difficult to estimate their usage beforehand. The best way to find the costs of free Actors upfront is to try out the Actor on a limited scope (for example, on a small number of pages) and evaluate the consumption. You can easily do that using our [free plan](https://apify.com/pricing).
>
> **For more information on platform usage cost see the [usage and resources](./usage_and_resources.md) page.**
1. [**Rental**](#rental-actors) - to continue using the Actor after the trial period, you must rent the Actor from the developer and pay a flat monthly fee in addition to the costs associated with the platform usage that the Actor generates.

Check warning on line 25 in sources/platform/actors/running/store.md

View workflow job for this annotation

GitHub Actions / vale

[vale] sources/platform/actors/running/store.md#L25

[write-good.Weasel] 'monthly' is a weasel word!
Raw output
{"message": "[write-good.Weasel] 'monthly' is a weasel word!", "location": {"path": "sources/platform/actors/running/store.md", "range": {"start": {"line": 25, "column": 145}}}, "severity": "WARNING"}

Check warning on line 25 in sources/platform/actors/running/store.md

View workflow job for this annotation

GitHub Actions / vale

[vale] sources/platform/actors/running/store.md#L25

[write-good.TooWordy] 'in addition' is too wordy.
Raw output
{"message": "[write-good.TooWordy] 'in addition' is too wordy.", "location": {"path": "sources/platform/actors/running/store.md", "range": {"start": {"line": 25, "column": 157}}}, "severity": "WARNING"}
2. [**Pay per result**](#pay-per-result) - you do not pay for platform usage the Actor generates and instead just pay for the results it produces.
3. [**Pay per usage**](#pay-per-usage) - you can run the Actor and you pay for the platform usage the Actor generates.

### Rental Actors

Rental Actors are like free Actors, but with a slight difference. When you use a rental Actor, you pay a fee to its developer. This empowers the developer to dedicate more time and effort to their Actors, thus ensuring they are of the **highest quality** and receive **ongoing maintenance**.
Rental Actors are Actors for which you have to pay a recurring fee to the developer after your trial period ends. This empowers the developer to dedicate more time and effort to their Actors, thus ensuring they are of the _highest quality_ and receive _ongoing maintenance_.

![Free and rental Actors in Apify Store](./images/store/free_vs_paid_actors.png)
![Rental Actor example](./images/store/rental-actor-example.png)

Each rental Actor has a **free trial,** where the trial's length is always shown for each rental Actor.
Each rental Actor has a _free trial_ period. The length of the trial is displayed on each Actor's page.

Check warning on line 35 in sources/platform/actors/running/store.md

View workflow job for this annotation

GitHub Actions / vale

[vale] sources/platform/actors/running/store.md#L35

[write-good.Passive] 'is displayed' may be passive voice. Use active voice if you can.
Raw output
{"message": "[write-good.Passive] 'is displayed' may be passive voice. Use active voice if you can.", "location": {"path": "sources/platform/actors/running/store.md", "range": {"start": {"line": 35, "column": 70}}}, "severity": "WARNING"}

![Rental Actors in Apify Store](./images/store/paid-actors-store.png)
![Rental Actors in Apify Store](./images/store/rental-actor-trial-example.png)

---
After a trial period, a flat monthly _Actor rental_ fee is automatically subtracted from your prepaid platform usage in advance for the following month. Most of this fee goes directly to the developer and is paid on top of the platform usage generated by the Actor. You can read more about our motivation for releasing rental Actors in [this blog post](https://blog.apify.com/make-regular-passive-income-developing-web-automation-actors-b0392278d085/) from Apify's CEO Jan Čurn.

Check warning on line 39 in sources/platform/actors/running/store.md

View workflow job for this annotation

GitHub Actions / vale

[vale] sources/platform/actors/running/store.md#L39

[write-good.Weasel] 'monthly' is a weasel word!
Raw output
{"message": "[write-good.Weasel] 'monthly' is a weasel word!", "location": {"path": "sources/platform/actors/running/store.md", "range": {"start": {"line": 39, "column": 30}}}, "severity": "WARNING"}

Check warning on line 39 in sources/platform/actors/running/store.md

View workflow job for this annotation

GitHub Actions / vale

[vale] sources/platform/actors/running/store.md#L39

[write-good.Passive] 'is paid' may be passive voice. Use active voice if you can.
Raw output
{"message": "[write-good.Passive] 'is paid' may be passive voice. Use active voice if you can.", "location": {"path": "sources/platform/actors/running/store.md", "range": {"start": {"line": 39, "column": 206}}}, "severity": "WARNING"}

![Rental Actors free trial](./images/store/paid-actors-trial.png)

After a trial period, a flat monthly **Actor rental** fee is automatically charged from your prepaid platform usage in advance for the following month. This fee goes directly to the developer and is paid on top of the platform usage generated by the Actor. You can read more about our motivation for releasing rental Actors in [this blog post](https://blog.apify.com/make-regular-passive-income-developing-web-automation-actors-b0392278d085/) from Apify's CEO Jan Čurn.
#### Rental Actors - Frequently Asked Questions

**Can I run rental Actors via API or the Apify client?**
##### Can I run rental Actors via API or the Apify client?

Check warning on line 44 in sources/platform/actors/running/store.md

View workflow job for this annotation

GitHub Actions / vale

[vale] sources/platform/actors/running/store.md#L44

[Microsoft.FirstPerson] Use first person (such as ' I ') sparingly.
Raw output
{"message": "[Microsoft.FirstPerson] Use first person (such as ' I ') sparingly.", "location": {"path": "sources/platform/actors/running/store.md", "range": {"start": {"line": 44, "column": 10}}}, "severity": "WARNING"}

Check warning on line 44 in sources/platform/actors/running/store.md

View workflow job for this annotation

GitHub Actions / vale

[vale] sources/platform/actors/running/store.md#L44

[Microsoft.HeadingAcronyms] Avoid using acronyms in a title or heading.
Raw output
{"message": "[Microsoft.HeadingAcronyms] Avoid using acronyms in a title or heading.", "location": {"path": "sources/platform/actors/running/store.md", "range": {"start": {"line": 44, "column": 35}}}, "severity": "WARNING"}

Check warning on line 44 in sources/platform/actors/running/store.md

View workflow job for this annotation

GitHub Actions / vale

[vale] sources/platform/actors/running/store.md#L44

[Microsoft.HeadingPunctuation] Don't use end punctuation in headings.
Raw output
{"message": "[Microsoft.HeadingPunctuation] Don't use end punctuation in headings.", "location": {"path": "sources/platform/actors/running/store.md", "range": {"start": {"line": 44, "column": 57}}}, "severity": "WARNING"}

Yes, when you are renting an Actor, you can run it using either our [API](/api/v2), [JavaScript](/api/client/js) or [Python](/api/client/python) clients as you would do with private or free public Actors.

**Do I pay platform costs for running rental Actors?**
##### Do I pay platform costs for running rental Actors?

Check warning on line 48 in sources/platform/actors/running/store.md

View workflow job for this annotation

GitHub Actions / vale

[vale] sources/platform/actors/running/store.md#L48

[Microsoft.FirstPerson] Use first person (such as ' I ') sparingly.
Raw output
{"message": "[Microsoft.FirstPerson] Use first person (such as ' I ') sparingly.", "location": {"path": "sources/platform/actors/running/store.md", "range": {"start": {"line": 48, "column": 9}}}, "severity": "WARNING"}

Check warning on line 48 in sources/platform/actors/running/store.md

View workflow job for this annotation

GitHub Actions / vale

[vale] sources/platform/actors/running/store.md#L48

[Microsoft.HeadingPunctuation] Don't use end punctuation in headings.
Raw output
{"message": "[Microsoft.HeadingPunctuation] Don't use end punctuation in headings.", "location": {"path": "sources/platform/actors/running/store.md", "range": {"start": {"line": 48, "column": 55}}}, "severity": "WARNING"}

Yes, you will pay normal [platform usage costs](https://apify.com/pricing/actors) on top of the monthly Actor rental fee. The platform costs work exactly the same way as for free public Actors or your private Actors. You should find estimates of the cost of usage in each individual rental Actor's README ([see an example](https://apify.com/drobnikj/crawler-google-places#how-much-will-it-cost)).

**Do I need an Apify paid plan to use rental Actors?**
##### Do I need an Apify paid plan to use rental Actors?

Check warning on line 52 in sources/platform/actors/running/store.md

View workflow job for this annotation

GitHub Actions / vale

[vale] sources/platform/actors/running/store.md#L52

[Microsoft.FirstPerson] Use first person (such as ' I ') sparingly.
Raw output
{"message": "[Microsoft.FirstPerson] Use first person (such as ' I ') sparingly.", "location": {"path": "sources/platform/actors/running/store.md", "range": {"start": {"line": 52, "column": 9}}}, "severity": "WARNING"}

Check warning on line 52 in sources/platform/actors/running/store.md

View workflow job for this annotation

GitHub Actions / vale

[vale] sources/platform/actors/running/store.md#L52

[Microsoft.HeadingPunctuation] Don't use end punctuation in headings.
Raw output
{"message": "[Microsoft.HeadingPunctuation] Don't use end punctuation in headings.", "location": {"path": "sources/platform/actors/running/store.md", "range": {"start": {"line": 52, "column": 55}}}, "severity": "WARNING"}

You don't need a paid plan to start a rental Actor's free trial. Just activate the trial, and you are good to go. After that, you will need to subscribe to one of [Apify's paid plans](https://apify.com/pricing) in order to keep renting the Actor and continue using it.

**When will I be charged for the Actor rental?**
##### When will I be charged for the Actor rental?

Check warning on line 56 in sources/platform/actors/running/store.md

View workflow job for this annotation

GitHub Actions / vale

[vale] sources/platform/actors/running/store.md#L56

[Microsoft.FirstPerson] Use first person (such as ' I ') sparingly.
Raw output
{"message": "[Microsoft.FirstPerson] Use first person (such as ' I ') sparingly.", "location": {"path": "sources/platform/actors/running/store.md", "range": {"start": {"line": 56, "column": 16}}}, "severity": "WARNING"}

Check warning on line 56 in sources/platform/actors/running/store.md

View workflow job for this annotation

GitHub Actions / vale

[vale] sources/platform/actors/running/store.md#L56

[write-good.Passive] 'be charged' may be passive voice. Use active voice if you can.
Raw output
{"message": "[write-good.Passive] 'be charged' may be passive voice. Use active voice if you can.", "location": {"path": "sources/platform/actors/running/store.md", "range": {"start": {"line": 56, "column": 19}}}, "severity": "WARNING"}

Check warning on line 56 in sources/platform/actors/running/store.md

View workflow job for this annotation

GitHub Actions / vale

[vale] sources/platform/actors/running/store.md#L56

[Microsoft.HeadingPunctuation] Don't use end punctuation in headings.
Raw output
{"message": "[Microsoft.HeadingPunctuation] Don't use end punctuation in headings.", "location": {"path": "sources/platform/actors/running/store.md", "range": {"start": {"line": 56, "column": 49}}}, "severity": "WARNING"}

You always prepay the Actor rental for the following month. The first payment happens when the trial expires, and then recurs monthly. When you open the Actor in the Apify Console, you will see when the next rental payment is due, and you will also receive a notification when it happens.

**Example**: You activate a 7-day trial of an Actor at **noon of April 1, 2021**. If you don't turn off auto-renewal, you will be charged at **noon on April 8, 2021**, then **May 8, 2021**, and so on.
_Example_: You activate a 7-day trial of an Actor at _noon of April 1, 2021_. If you don't turn off auto-renewal, you will be charged at _noon on April 8, 2021_, then _May 8, 2021_.

Check warning on line 60 in sources/platform/actors/running/store.md

View workflow job for this annotation

GitHub Actions / vale

[vale] sources/platform/actors/running/store.md#L60

[write-good.Passive] 'be charged' may be passive voice. Use active voice if you can.
Raw output
{"message": "[write-good.Passive] 'be charged' may be passive voice. Use active voice if you can.", "location": {"path": "sources/platform/actors/running/store.md", "range": {"start": {"line": 60, "column": 124}}}, "severity": "WARNING"}

**How am I charged for Actor rental?**
##### How am I charged for Actor rental?

Check warning on line 62 in sources/platform/actors/running/store.md

View workflow job for this annotation

GitHub Actions / vale

[vale] sources/platform/actors/running/store.md#L62

[Microsoft.FirstPerson] Use first person (such as ' I ') sparingly.
Raw output
{"message": "[Microsoft.FirstPerson] Use first person (such as ' I ') sparingly.", "location": {"path": "sources/platform/actors/running/store.md", "range": {"start": {"line": 62, "column": 13}}}, "severity": "WARNING"}

Check warning on line 62 in sources/platform/actors/running/store.md

View workflow job for this annotation

GitHub Actions / vale

[vale] sources/platform/actors/running/store.md#L62

[Microsoft.HeadingPunctuation] Don't use end punctuation in headings.
Raw output
{"message": "[Microsoft.HeadingPunctuation] Don't use end punctuation in headings.", "location": {"path": "sources/platform/actors/running/store.md", "range": {"start": {"line": 62, "column": 39}}}, "severity": "WARNING"}

The rental fee for an Actor is automatically subtracted from your prepaid platform usage, similarly to, e.g. [compute units](./usage_and_resources.md). If you don't have enough usage prepaid, you will need to cover any overage in the next invoice.

**Will I be automatically charged at the end of the free trial?**
##### Will I be automatically charged at the end of the free trial?

Check warning on line 66 in sources/platform/actors/running/store.md

View workflow job for this annotation

GitHub Actions / vale

[vale] sources/platform/actors/running/store.md#L66

[Microsoft.FirstPerson] Use first person (such as ' I ') sparingly.
Raw output
{"message": "[Microsoft.FirstPerson] Use first person (such as ' I ') sparingly.", "location": {"path": "sources/platform/actors/running/store.md", "range": {"start": {"line": 66, "column": 11}}}, "severity": "WARNING"}

Check warning on line 66 in sources/platform/actors/running/store.md

View workflow job for this annotation

GitHub Actions / vale

[vale] sources/platform/actors/running/store.md#L66

[Microsoft.HeadingPunctuation] Don't use end punctuation in headings.
Raw output
{"message": "[Microsoft.HeadingPunctuation] Don't use end punctuation in headings.", "location": {"path": "sources/platform/actors/running/store.md", "range": {"start": {"line": 66, "column": 66}}}, "severity": "WARNING"}

If you have an [Apify paid plan](https://apify.com/pricing), you will be automatically charged the monthly rental fee at the end of your free trial and you will be able to run the Actor for another month. If you are not subscribed to an Apify plan, you will need to subscribe to one of [Apify's paid plans](https://apify.com/pricing) in order to continue using the Actor after the trial has ended.
If you have an [Apify paid plan](https://apify.com/pricing), the monthly rental fee will be automatically subtracted from your plan's prepaid usage at the end of your free trial, and you will be able to run the Actor for another month. If you are not subscribed to any of [Apify's paid plans](https://apify.com/pricing), you will need to subscribe to one in order to continue using the Actor after the trial has ended.

Check warning on line 68 in sources/platform/actors/running/store.md

View workflow job for this annotation

GitHub Actions / vale

[vale] sources/platform/actors/running/store.md#L68

[write-good.Weasel] 'monthly' is a weasel word!
Raw output
{"message": "[write-good.Weasel] 'monthly' is a weasel word!", "location": {"path": "sources/platform/actors/running/store.md", "range": {"start": {"line": 68, "column": 66}}}, "severity": "WARNING"}

Check warning on line 68 in sources/platform/actors/running/store.md

View workflow job for this annotation

GitHub Actions / vale

[vale] sources/platform/actors/running/store.md#L68

[Microsoft.Wordiness] Consider using 'to' instead of 'in order to'.
Raw output
{"message": "[Microsoft.Wordiness] Consider using 'to' instead of 'in order to'.", "location": {"path": "sources/platform/actors/running/store.md", "range": {"start": {"line": 68, "column": 356}}}, "severity": "WARNING"}

Check warning on line 68 in sources/platform/actors/running/store.md

View workflow job for this annotation

GitHub Actions / vale

[vale] sources/platform/actors/running/store.md#L68

[write-good.TooWordy] 'in order to' is too wordy.
Raw output
{"message": "[write-good.TooWordy] 'in order to' is too wordy.", "location": {"path": "sources/platform/actors/running/store.md", "range": {"start": {"line": 68, "column": 356}}}, "severity": "WARNING"}

**Can I cancel my Actor rental?**
##### Can I cancel my Actor rental?

Check warning on line 70 in sources/platform/actors/running/store.md

View workflow job for this annotation

GitHub Actions / vale

[vale] sources/platform/actors/running/store.md#L70

[Microsoft.FirstPerson] Use first person (such as ' I ') sparingly.
Raw output
{"message": "[Microsoft.FirstPerson] Use first person (such as ' I ') sparingly.", "location": {"path": "sources/platform/actors/running/store.md", "range": {"start": {"line": 70, "column": 10}}}, "severity": "WARNING"}

Check warning on line 70 in sources/platform/actors/running/store.md

View workflow job for this annotation

GitHub Actions / vale

[vale] sources/platform/actors/running/store.md#L70

[Microsoft.FirstPerson] Use first person (such as 'my') sparingly.
Raw output
{"message": "[Microsoft.FirstPerson] Use first person (such as 'my') sparingly.", "location": {"path": "sources/platform/actors/running/store.md", "range": {"start": {"line": 70, "column": 20}}}, "severity": "WARNING"}

Check warning on line 70 in sources/platform/actors/running/store.md

View workflow job for this annotation

GitHub Actions / vale

[vale] sources/platform/actors/running/store.md#L70

[Microsoft.HeadingPunctuation] Don't use end punctuation in headings.
Raw output
{"message": "[Microsoft.HeadingPunctuation] Don't use end punctuation in headings.", "location": {"path": "sources/platform/actors/running/store.md", "range": {"start": {"line": 70, "column": 34}}}, "severity": "WARNING"}

**You can cancel the Actor rental** during your trial or any time after that so that don't get charged when your current Actor rental expires. You can always turn it back on later if you want.
_You can cancel the Actor rental_ during your trial or any time after that so you don't get charged when your current Actor rental period expires. You can always turn it back on later if you want.

**Where can I see how much I have paid for Actor rental?**
##### Where can I see how much I have paid for Actor rental?

Check warning on line 74 in sources/platform/actors/running/store.md

View workflow job for this annotation

GitHub Actions / vale

[vale] sources/platform/actors/running/store.md#L74

[Microsoft.FirstPerson] Use first person (such as ' I ') sparingly.
Raw output
{"message": "[Microsoft.FirstPerson] Use first person (such as ' I ') sparingly.", "location": {"path": "sources/platform/actors/running/store.md", "range": {"start": {"line": 74, "column": 31}}}, "severity": "WARNING"}

Check warning on line 74 in sources/platform/actors/running/store.md

View workflow job for this annotation

GitHub Actions / vale

[vale] sources/platform/actors/running/store.md#L74

[Microsoft.HeadingPunctuation] Don't use end punctuation in headings.
Raw output
{"message": "[Microsoft.HeadingPunctuation] Don't use end punctuation in headings.", "location": {"path": "sources/platform/actors/running/store.md", "range": {"start": {"line": 74, "column": 59}}}, "severity": "WARNING"}

Since Actor rental fees are paid from prepaid platform usage, these fees conceptually belong under platform usage.

You can find the breakdown of how much you have been charged for rental Actors at the bottom of the **Platform usage** tab in the [Billing](https://console.apify.com/billing) section. The overall sum will also be visible in the usage bar chart and the table at the top of the same tab.
You can find the breakdown of how much you have been charged for rental Actors in the **Actors** tab, which you will find within the **Current period** tab in the [Billing](https://console.apify.com/billing) section.

Check warning on line 78 in sources/platform/actors/running/store.md

View workflow job for this annotation

GitHub Actions / vale

[vale] sources/platform/actors/running/store.md#L78

[write-good.Passive] 'been charged' may be passive voice. Use active voice if you can.
Raw output
{"message": "[write-good.Passive] 'been charged' may be passive voice. Use active voice if you can.", "location": {"path": "sources/platform/actors/running/store.md", "range": {"start": {"line": 78, "column": 49}}}, "severity": "WARNING"}

![Rental Actors billing in Apify Console](./images/store/paid-actors-billing.png)
![Rental Actors billing in Apify Console](./images/store/billing-paid-actors.png)

### Actors paid per result
### Pay per result

When you run an Actor that is **paid per result**, you only pay for the successful results that an Actor returns when you run it, and you are not charged for the underlying platform usage. Technically, we validate the **results** against a schema, and you are only charged for the valid items in the [dataset](https://docs.apify.com/platform/storage/dataset) of the Actor run.
When you run an Actor that is _paid per result_, you pay for the successful results that an Actor returns when you run it, and you are not charged for the underlying platform usage.

> This makes it transparent and easy to estimate upfront costs. If you have any feedback or would like to ask something, please join our [Discord](https://discord.gg/qkMS6pU4cF) community and let us know!
:::info Estimation simplified

<!-- TODO - add a bit about the ability to set the maximum limits Actor should return -->
This makes it transparent and easy to estimate upfront costs. If you have any feedback or would like to ask something, please join our [Discord](https://discord.gg/qkMS6pU4cF) community and let us know!

**How do I know an Actor is paid per result?**
:::

<!-- TODO - add a bit about the ability to set the maximum limits Actor should return -->

An Actor that is paid per result will display the price per 1,000 items in the store.
#### Pay per result Actors - Frequently Asked Questions

![Pay per result Actor in store](./images/store/pay_per_result_actor_store_card.png)
##### How do I know an Actor is paid per result?

Check warning on line 96 in sources/platform/actors/running/store.md

View workflow job for this annotation

GitHub Actions / vale

[vale] sources/platform/actors/running/store.md#L96

[Microsoft.FirstPerson] Use first person (such as ' I ') sparingly.
Raw output
{"message": "[Microsoft.FirstPerson] Use first person (such as ' I ') sparingly.", "location": {"path": "sources/platform/actors/running/store.md", "range": {"start": {"line": 96, "column": 13}}}, "severity": "WARNING"}

Check warning on line 96 in sources/platform/actors/running/store.md

View workflow job for this annotation

GitHub Actions / vale

[vale] sources/platform/actors/running/store.md#L96

[write-good.Passive] 'is paid' may be passive voice. Use active voice if you can.
Raw output
{"message": "[write-good.Passive] 'is paid' may be passive voice. Use active voice if you can.", "location": {"path": "sources/platform/actors/running/store.md", "range": {"start": {"line": 96, "column": 30}}}, "severity": "WARNING"}

Check warning on line 96 in sources/platform/actors/running/store.md

View workflow job for this annotation

GitHub Actions / vale

[vale] sources/platform/actors/running/store.md#L96

[Microsoft.HeadingPunctuation] Don't use end punctuation in headings.
Raw output
{"message": "[Microsoft.HeadingPunctuation] Don't use end punctuation in headings.", "location": {"path": "sources/platform/actors/running/store.md", "range": {"start": {"line": 96, "column": 47}}}, "severity": "WARNING"}

When you try the Actor on the platform, you will see that the Actor is paid per result next to the Actor name.

![Actor paid per result in Console](./images/store/console_pay_per_result_tag.png)

**Do I need to pay a monthly rental fee to run the Actor?**
##### Do I need to pay a monthly rental fee to run the Actor?

Check warning on line 102 in sources/platform/actors/running/store.md

View workflow job for this annotation

GitHub Actions / vale

[vale] sources/platform/actors/running/store.md#L102

[Microsoft.FirstPerson] Use first person (such as ' I ') sparingly.
Raw output
{"message": "[Microsoft.FirstPerson] Use first person (such as ' I ') sparingly.", "location": {"path": "sources/platform/actors/running/store.md", "range": {"start": {"line": 102, "column": 9}}}, "severity": "WARNING"}

Check warning on line 102 in sources/platform/actors/running/store.md

View workflow job for this annotation

GitHub Actions / vale

[vale] sources/platform/actors/running/store.md#L102

[write-good.Weasel] 'monthly' is a weasel word!
Raw output
{"message": "[write-good.Weasel] 'monthly' is a weasel word!", "location": {"path": "sources/platform/actors/running/store.md", "range": {"start": {"line": 102, "column": 26}}}, "severity": "WARNING"}

Check warning on line 102 in sources/platform/actors/running/store.md

View workflow job for this annotation

GitHub Actions / vale

[vale] sources/platform/actors/running/store.md#L102

[Microsoft.HeadingPunctuation] Don't use end punctuation in headings.
Raw output
{"message": "[Microsoft.HeadingPunctuation] Don't use end punctuation in headings.", "location": {"path": "sources/platform/actors/running/store.md", "range": {"start": {"line": 102, "column": 60}}}, "severity": "WARNING"}

No, the Actor is free to run. You only pay for the results.

**What happens when I interact with the dataset after the run finishes?**
##### What happens when I interact with the dataset after the run finishes?

Check warning on line 106 in sources/platform/actors/running/store.md

View workflow job for this annotation

GitHub Actions / vale

[vale] sources/platform/actors/running/store.md#L106

[Microsoft.FirstPerson] Use first person (such as ' I ') sparingly.
Raw output
{"message": "[Microsoft.FirstPerson] Use first person (such as ' I ') sparingly.", "location": {"path": "sources/platform/actors/running/store.md", "range": {"start": {"line": 106, "column": 24}}}, "severity": "WARNING"}

Check warning on line 106 in sources/platform/actors/running/store.md

View workflow job for this annotation

GitHub Actions / vale

[vale] sources/platform/actors/running/store.md#L106

[Microsoft.HeadingPunctuation] Don't use end punctuation in headings.
Raw output
{"message": "[Microsoft.HeadingPunctuation] Don't use end punctuation in headings.", "location": {"path": "sources/platform/actors/running/store.md", "range": {"start": {"line": 106, "column": 74}}}, "severity": "WARNING"}

Under the **pay per result** model, all platform costs generated **during the run of an Actor** are not charged towards your account; you pay for the results instead. After the run finishes, any interactions with the default dataset storing the results, such as reading the results or writing additional data, will incur the standard platform usage costs. But do not worry, in the vast majority of cases, you only want to read the result from the dataset and that costs near to nothing.
Under the **pay per result** model, all platform costs generated _during the run of an Actor_ are not charged towards your account; you pay for the results instead. After the run finishes, any interactions with the default dataset storing the results, such as reading the results or writing additional data, will incur the standard platform usage costs. But do not worry, in the vast majority of cases, you only want to read the result from the dataset and that costs near to nothing.

Check warning on line 108 in sources/platform/actors/running/store.md

View workflow job for this annotation

GitHub Actions / vale

[vale] sources/platform/actors/running/store.md#L108

[write-good.TooWordy] 'additional' is too wordy.
Raw output
{"message": "[write-good.TooWordy] 'additional' is too wordy.", "location": {"path": "sources/platform/actors/running/store.md", "range": {"start": {"line": 108, "column": 292}}}, "severity": "WARNING"}

Check warning on line 108 in sources/platform/actors/running/store.md

View workflow job for this annotation

GitHub Actions / vale

[vale] sources/platform/actors/running/store.md#L108

[write-good.Weasel] 'only' is a weasel word!
Raw output
{"message": "[write-good.Weasel] 'only' is a weasel word!", "location": {"path": "sources/platform/actors/running/store.md", "range": {"start": {"line": 108, "column": 408}}}, "severity": "WARNING"}

**Do I pay for the storage of results on the Apify platform?**
##### Do I pay for the storage of results on the Apify platform?

Check warning on line 110 in sources/platform/actors/running/store.md

View workflow job for this annotation

GitHub Actions / vale

[vale] sources/platform/actors/running/store.md#L110

[Microsoft.FirstPerson] Use first person (such as ' I ') sparingly.
Raw output
{"message": "[Microsoft.FirstPerson] Use first person (such as ' I ') sparingly.", "location": {"path": "sources/platform/actors/running/store.md", "range": {"start": {"line": 110, "column": 9}}}, "severity": "WARNING"}

Check warning on line 110 in sources/platform/actors/running/store.md

View workflow job for this annotation

GitHub Actions / vale

[vale] sources/platform/actors/running/store.md#L110

[Microsoft.HeadingPunctuation] Don't use end punctuation in headings.
Raw output
{"message": "[Microsoft.HeadingPunctuation] Don't use end punctuation in headings.", "location": {"path": "sources/platform/actors/running/store.md", "range": {"start": {"line": 110, "column": 63}}}, "severity": "WARNING"}

You will still be charged for the timed storage of the data in the same fashion as with any other Actor. You can always decide to delete the dataset to reduce your costs after you export the data from the platform. By default, any unnamed dataset will be automatically removed after your data retention period, so in most cases, this is nothing to worry about.
You will still be charged for the timed storage of the data in the same fashion as with any other Actor. You can always decide to delete the dataset to reduce your costs after you export the data from the platform. By default, any unnamed dataset will be automatically removed after your data retention period, so usually, this is nothing to worry about.

Check warning on line 112 in sources/platform/actors/running/store.md

View workflow job for this annotation

GitHub Actions / vale

[vale] sources/platform/actors/running/store.md#L112

[write-good.Passive] 'be charged' may be passive voice. Use active voice if you can.
Raw output
{"message": "[write-good.Passive] 'be charged' may be passive voice. Use active voice if you can.", "location": {"path": "sources/platform/actors/running/store.md", "range": {"start": {"line": 112, "column": 16}}}, "severity": "WARNING"}

Check warning on line 112 in sources/platform/actors/running/store.md

View workflow job for this annotation

GitHub Actions / vale

[vale] sources/platform/actors/running/store.md#L112

[write-good.Weasel] 'usually' is a weasel word!
Raw output
{"message": "[write-good.Weasel] 'usually' is a weasel word!", "location": {"path": "sources/platform/actors/running/store.md", "range": {"start": {"line": 112, "column": 315}}}, "severity": "WARNING"}

##### Can I set a cap on how many results an Actor should return?

Check warning on line 114 in sources/platform/actors/running/store.md

View workflow job for this annotation

GitHub Actions / vale

[vale] sources/platform/actors/running/store.md#L114

[Microsoft.FirstPerson] Use first person (such as ' I ') sparingly.
Raw output
{"message": "[Microsoft.FirstPerson] Use first person (such as ' I ') sparingly.", "location": {"path": "sources/platform/actors/running/store.md", "range": {"start": {"line": 114, "column": 10}}}, "severity": "WARNING"}

Check warning on line 114 in sources/platform/actors/running/store.md

View workflow job for this annotation

GitHub Actions / vale

[vale] sources/platform/actors/running/store.md#L114

[Microsoft.HeadingPunctuation] Don't use end punctuation in headings.
Raw output
{"message": "[Microsoft.HeadingPunctuation] Don't use end punctuation in headings.", "location": {"path": "sources/platform/actors/running/store.md", "range": {"start": {"line": 114, "column": 64}}}, "severity": "WARNING"}

**Can I set a cap on how many results an Actor should return?**
You can set a limit on how many items an Actor should return and the amount you will be charged in Options on the Actor detail page in the section below the Actor input.

![Max items for pay-per-result](./images/store/pay_per_result_max_items.png)

**Can I publish an Actor that is paid per result?**
##### Can I publish an Actor that is paid per result?

Check warning on line 120 in sources/platform/actors/running/store.md

View workflow job for this annotation

GitHub Actions / vale

[vale] sources/platform/actors/running/store.md#L120

[Microsoft.FirstPerson] Use first person (such as ' I ') sparingly.
Raw output
{"message": "[Microsoft.FirstPerson] Use first person (such as ' I ') sparingly.", "location": {"path": "sources/platform/actors/running/store.md", "range": {"start": {"line": 120, "column": 10}}}, "severity": "WARNING"}

Check warning on line 120 in sources/platform/actors/running/store.md

View workflow job for this annotation

GitHub Actions / vale

[vale] sources/platform/actors/running/store.md#L120

[write-good.Passive] 'is paid' may be passive voice. Use active voice if you can.
Raw output
{"message": "[write-good.Passive] 'is paid' may be passive voice. Use active voice if you can.", "location": {"path": "sources/platform/actors/running/store.md", "range": {"start": {"line": 120, "column": 35}}}, "severity": "WARNING"}

Check warning on line 120 in sources/platform/actors/running/store.md

View workflow job for this annotation

GitHub Actions / vale

[vale] sources/platform/actors/running/store.md#L120

[Microsoft.HeadingPunctuation] Don't use end punctuation in headings.
Raw output
{"message": "[Microsoft.HeadingPunctuation] Don't use end punctuation in headings.", "location": {"path": "sources/platform/actors/running/store.md", "range": {"start": {"line": 120, "column": 52}}}, "severity": "WARNING"}

Publishing an Actor that is paid per result is not yet available publicly as this pricing model is still in beta.
Yes, you can publish an Actor that is paid per result.

Check warning on line 122 in sources/platform/actors/running/store.md

View workflow job for this annotation

GitHub Actions / vale

[vale] sources/platform/actors/running/store.md#L122

[write-good.Passive] 'is paid' may be passive voice. Use active voice if you can.
Raw output
{"message": "[write-good.Passive] 'is paid' may be passive voice. Use active voice if you can.", "location": {"path": "sources/platform/actors/running/store.md", "range": {"start": {"line": 122, "column": 36}}}, "severity": "WARNING"}

**Where do I see how much I was charged for the pay-per-result Actors?**
##### Where do I see how much I was charged for the pay per result Actors?

Check warning on line 124 in sources/platform/actors/running/store.md

View workflow job for this annotation

GitHub Actions / vale

[vale] sources/platform/actors/running/store.md#L124

[Microsoft.FirstPerson] Use first person (such as ' I ') sparingly.
Raw output
{"message": "[Microsoft.FirstPerson] Use first person (such as ' I ') sparingly.", "location": {"path": "sources/platform/actors/running/store.md", "range": {"start": {"line": 124, "column": 15}}}, "severity": "WARNING"}

Check warning on line 124 in sources/platform/actors/running/store.md

View workflow job for this annotation

GitHub Actions / vale

[vale] sources/platform/actors/running/store.md#L124

[Microsoft.FirstPerson] Use first person (such as ' I ') sparingly.
Raw output
{"message": "[Microsoft.FirstPerson] Use first person (such as ' I ') sparingly.", "location": {"path": "sources/platform/actors/running/store.md", "range": {"start": {"line": 124, "column": 30}}}, "severity": "WARNING"}

Check warning on line 124 in sources/platform/actors/running/store.md

View workflow job for this annotation

GitHub Actions / vale

[vale] sources/platform/actors/running/store.md#L124

[write-good.Passive] 'was charged' may be passive voice. Use active voice if you can.
Raw output
{"message": "[write-good.Passive] 'was charged' may be passive voice. Use active voice if you can.", "location": {"path": "sources/platform/actors/running/store.md", "range": {"start": {"line": 124, "column": 33}}}, "severity": "WARNING"}

Check warning on line 124 in sources/platform/actors/running/store.md

View workflow job for this annotation

GitHub Actions / vale

[vale] sources/platform/actors/running/store.md#L124

[Microsoft.HeadingPunctuation] Don't use end punctuation in headings.
Raw output
{"message": "[Microsoft.HeadingPunctuation] Don't use end punctuation in headings.", "location": {"path": "sources/platform/actors/running/store.md", "range": {"start": {"line": 124, "column": 73}}}, "severity": "WARNING"}

You can see the overview of how much you have been charged for Actors paid by result on your invoices and in the [Usage tab](https://console.apify.com/billing) of the Billing section in Console. It will be shown there as a separate service.

Expand All @@ -142,10 +138,24 @@

![Actor pay-per-result cost](./images/store/pay_per_result_actor_items.png)

### Pay per usage

When you use a pay per usage Actor, you are only charged for the platform usage that the runs of this Actor generate. [Platform usage](./usage_and_resources.md) includes components such as compute units, operations on [storages](/platform/storage), and usage of [residential proxies](/platform/proxy/residential-proxy) or [SERPs](/platform/proxy/google-serp-proxy).

Check warning on line 143 in sources/platform/actors/running/store.md

View workflow job for this annotation

GitHub Actions / vale

[vale] sources/platform/actors/running/store.md#L143

[write-good.Weasel] 'only' is a weasel word!
Raw output
{"message": "[write-good.Weasel] 'only' is a weasel word!", "location": {"path": "sources/platform/actors/running/store.md", "range": {"start": {"line": 143, "column": 45}}}, "severity": "WARNING"}

![Pay for usage Actor example](./images/store/pay-per-usage-actor-example.png)

:::info Estimating Actor usage cost

With this model, it's very easy to see how many platform resources each Actor run consumed, but it is quite difficult to estimate their usage beforehand. The best way to find the costs of free Actors upfront is to try out the Actor on a limited scope (for example, on a small number of pages) and evaluate the consumption. You can easily do that using our [free plan](https://apify.com/pricing).

Check warning on line 149 in sources/platform/actors/running/store.md

View workflow job for this annotation

GitHub Actions / vale

[vale] sources/platform/actors/running/store.md#L149

[write-good.Weasel] 'very' is a weasel word!
Raw output
{"message": "[write-good.Weasel] 'very' is a weasel word!", "location": {"path": "sources/platform/actors/running/store.md", "range": {"start": {"line": 149, "column": 23}}}, "severity": "WARNING"}

Check warning on line 149 in sources/platform/actors/running/store.md

View workflow job for this annotation

GitHub Actions / vale

[vale] sources/platform/actors/running/store.md#L149

[Microsoft.Adverbs] Consider removing 'very'.
Raw output
{"message": "[Microsoft.Adverbs] Consider removing 'very'.", "location": {"path": "sources/platform/actors/running/store.md", "range": {"start": {"line": 149, "column": 23}}}, "severity": "WARNING"}

Check warning on line 149 in sources/platform/actors/running/store.md

View workflow job for this annotation

GitHub Actions / vale

[vale] sources/platform/actors/running/store.md#L149

[write-good.Weasel] 'many' is a weasel word!
Raw output
{"message": "[write-good.Weasel] 'many' is a weasel word!", "location": {"path": "sources/platform/actors/running/store.md", "range": {"start": {"line": 149, "column": 44}}}, "severity": "WARNING"}

Check warning on line 149 in sources/platform/actors/running/store.md

View workflow job for this annotation

GitHub Actions / vale

[vale] sources/platform/actors/running/store.md#L149

[write-good.TooWordy] 'it is' is too wordy.
Raw output
{"message": "[write-good.TooWordy] 'it is' is too wordy.", "location": {"path": "sources/platform/actors/running/store.md", "range": {"start": {"line": 149, "column": 97}}}, "severity": "WARNING"}

Check warning on line 149 in sources/platform/actors/running/store.md

View workflow job for this annotation

GitHub Actions / vale

[vale] sources/platform/actors/running/store.md#L149

[write-good.TooWordy] 'evaluate' is too wordy.
Raw output
{"message": "[write-good.TooWordy] 'evaluate' is too wordy.", "location": {"path": "sources/platform/actors/running/store.md", "range": {"start": {"line": 149, "column": 298}}}, "severity": "WARNING"}

Check warning on line 149 in sources/platform/actors/running/store.md

View workflow job for this annotation

GitHub Actions / vale

[vale] sources/platform/actors/running/store.md#L149

[write-good.Weasel] 'easily' is a weasel word!
Raw output
{"message": "[write-good.Weasel] 'easily' is a weasel word!", "location": {"path": "sources/platform/actors/running/store.md", "range": {"start": {"line": 149, "column": 332}}}, "severity": "WARNING"}

Check warning on line 149 in sources/platform/actors/running/store.md

View workflow job for this annotation

GitHub Actions / vale

[vale] sources/platform/actors/running/store.md#L149

[Microsoft.Adverbs] Consider removing 'easily'.
Raw output
{"message": "[Microsoft.Adverbs] Consider removing 'easily'.", "location": {"path": "sources/platform/actors/running/store.md", "range": {"start": {"line": 149, "column": 332}}}, "severity": "WARNING"}

_For more information on platform usage cost see the [usage and resources](./usage_and_resources.md) page._

:::

## Reporting issues with Actors

Each Actor has an `Issues` tab present in the Apify Console. There, you can open an issue (ticket) and chat with the Actor's author, platform admins,
and other users of this Actor. Please, feel free to use the tab to ask any questions, request new features or give feedback. Alternatively, you can
Each Actor has an **Issues** tab in Apify Console. There, you can open an issue (ticket) and chat with the Actor's author, platform admins,
and other users of this Actor. Please feel free to use the tab to ask any questions, request new features, or give feedback. Alternatively, you can

Check warning on line 158 in sources/platform/actors/running/store.md

View workflow job for this annotation

GitHub Actions / vale

[vale] sources/platform/actors/running/store.md#L158

[write-good.TooWordy] 'Alternatively' is too wordy.
Raw output
{"message": "[write-good.TooWordy] 'Alternatively' is too wordy.", "location": {"path": "sources/platform/actors/running/store.md", "range": {"start": {"line": 158, "column": 126}}}, "severity": "WARNING"}

Check warning on line 158 in sources/platform/actors/running/store.md

View workflow job for this annotation

GitHub Actions / vale

[vale] sources/platform/actors/running/store.md#L158

[write-good.Weasel] 'Alternatively' is a weasel word!
Raw output
{"message": "[write-good.Weasel] 'Alternatively' is a weasel word!", "location": {"path": "sources/platform/actors/running/store.md", "range": {"start": {"line": 158, "column": 126}}}, "severity": "WARNING"}
always write to [[email protected]](mailto:[email protected]).

![Paid Actors' issues tab](./images/store/paid-actors-issues-tab.png)
1 change: 1 addition & 0 deletions vale.ini
Original file line number Diff line number Diff line change
Expand Up @@ -21,3 +21,4 @@ Microsoft.Foreign = NO
Microsoft.We = NO
Microsoft.Quotes = NO
Microsoft.ThereIs = NO
Microsoft.Auto = NO