From a436ce4470776396357c99caa89e86fc68fc06ba Mon Sep 17 00:00:00 2001 From: szaganek Date: Wed, 27 May 2026 12:33:41 +0200 Subject: [PATCH] docs: Document Actor reviews --- sources/platform/actors/index.mdx | 2 +- .../actors/publishing/actor_rating.mdx | 45 ++++ .../running/images/store/actor_reviews.svg | 237 ++++++++++++++++++ .../running/{store.md => store/index.md} | 34 +-- .../platform/actors/running/store/reviews.mdx | 64 +++++ sources/platform/console/store.md | 2 +- 6 files changed, 365 insertions(+), 19 deletions(-) create mode 100644 sources/platform/actors/publishing/actor_rating.mdx create mode 100644 sources/platform/actors/running/images/store/actor_reviews.svg rename sources/platform/actors/running/{store.md => store/index.md} (75%) create mode 100644 sources/platform/actors/running/store/reviews.mdx diff --git a/sources/platform/actors/index.mdx b/sources/platform/actors/index.mdx index a9b4480cb0..e424642dac 100644 --- a/sources/platform/actors/index.mdx +++ b/sources/platform/actors/index.mdx @@ -74,4 +74,4 @@ To get a better idea of what Apify Actors are, visit [Apify Store](https://apify ## Public and private Actors -Actors can be [public](./actors/running/actors-in-store) or private. Private Actors are yours to use and keep; no one will see them if you don't want them to. Public Actors are [available to everyone](./running/store.md) in [Apify Store](https://apify.com/store). You can make them free to use, or you can [charge for them](https://blog.apify.com/make-regular-passive-income-developing-web-automation-actors-b0392278d085/). +Actors can be [public](/actors/running/store/index.md) or private. Private Actors are yours to use and keep; no one will see them if you don't want them to. Public Actors are available to everyone in [Apify Store](https://apify.com/store). You can make them free to use, or you can [charge for them](https://blog.apify.com/make-regular-passive-income-developing-web-automation-actors-b0392278d085/). diff --git a/sources/platform/actors/publishing/actor_rating.mdx b/sources/platform/actors/publishing/actor_rating.mdx new file mode 100644 index 0000000000..f222fd39d1 --- /dev/null +++ b/sources/platform/actors/publishing/actor_rating.mdx @@ -0,0 +1,45 @@ +--- +title: Monitor your Actor's rating +description: Learn how to monitor your Actor's rating in Apify Store to ensure it meets the quality standards and is performing well. +slug: /actors/publishing/actor-rating +sidebar_position: 6 +--- + +Users can review your Actor in Apify Store. Their ratings impact your Actor's [quality score](/platform/actors/publishing/quality-score) and help it rank higher in search results. User reviews are also a great source of feedback that you can use to improve your Actor. + +## About the Actor rating + +Your Actor's rating isn't a pure average of all reviews. Instead, it's a weighted average that includes the following factors: + +- More recent reviews have a higher weight than the older ones. +- Reviews from trusted users have a higher weight. +- Reviews from users who often run your Actor have a higher weight. + +## View your Actor's rating and reviews + +To view your Actor's rating: + +1. Navigate to your Actor's page in Apify Store. +1. Select the **Reviews** tab. + +![Actor's rating and reviews in Apify Store](../running/images/store/actor_reviews.svg) + +## Respond to a review + +You can leave a public reply to a user's review on your Actor. Use this option to address the user's concerns, help them better understand the Actor, or provide additional information. + +To respond, on a user's review, select **Options** > **Reply**. + +### Edit your reply + +To edit your response, on your reply, select **Options** > **Edit**. + +## Report a review + +If you believe that a review doesn't follow the community standards, you can report it. For details, see [Report a review](/platform/actors/running/reviews#report-a-review). + +Note that the support team verifies all reports and only deletes the reviews that violate Apify policies. Users can share their experience even if it's negative. Here are some invalid reasons for reporting a review: + +- The review isn't a favorable opinion of the Actor. +- The problems indicated in the review could be resolved by opening an issue. +- The review describes an edge case or an issue that has since been resolved. diff --git a/sources/platform/actors/running/images/store/actor_reviews.svg b/sources/platform/actors/running/images/store/actor_reviews.svg new file mode 100644 index 0000000000..50d92060ec --- /dev/null +++ b/sources/platform/actors/running/images/store/actor_reviews.svg @@ -0,0 +1,237 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/sources/platform/actors/running/store.md b/sources/platform/actors/running/store/index.md similarity index 75% rename from sources/platform/actors/running/store.md rename to sources/platform/actors/running/store/index.md index a62c9f6cdd..bb2a767f43 100644 --- a/sources/platform/actors/running/store.md +++ b/sources/platform/actors/running/store/index.md @@ -14,7 +14,7 @@ Anyone is welcome to [publish Actors](/platform/actors/publishing) in the store, ::: -import RentalSunset from '../../../_partials/_rental-sunsetting.mdx'; +import RentalSunset from '../../../../_partials/_rental-sunsetting.mdx'; ## Pricing models @@ -35,39 +35,39 @@ With pay per event pricing, you pay for specific events defined by the Actor cre [//]: # (TODO: also show the screenshot from Apify Store on Web) -![Example pay per event Actor](./images/store/pay_per_event_example_actor.png) +![Example pay per event Actor](../images/store/pay_per_event_example_actor.png) :::caution Some Actors charge platform usage separately -Most pay per event Actors include [platform usage](./usage_and_resources.md) in the event price. However, some Actors may require you to pay for platform usage separately. Always check the Actor's pricing section to understand what's included. +Most pay per event Actors include [platform usage](../usage_and_resources.md) in the event price. However, some Actors may require you to pay for platform usage separately. Always check the Actor's pricing section to understand what's included. ::: -![Pay per event with usage not included in Apify Store](./images/store/pay_per_event_and_usage_example_actor.png) +![Pay per event with usage not included in Apify Store](../images/store/pay_per_event_and_usage_example_actor.png) When starting a run, you can define a maximum charge limit. The Actor terminates gracefully when it reaches that limit - and even if it does not stop immediately, you are never charged for produced events over the defined limit. -![Pay per event Actor - max charge per run](./images/store/pay_per_event_max_charge_per_run.png) +![Pay per event Actor - max charge per run](../images/store/pay_per_event_max_charge_per_run.png) Your charges appear on your invoices and in the [Historical usage tab](https://console.apify.com/billing/historical-usage) in the Billing section of Apify Console. The cost of each run also appears on the run detail page. -![Pay per event Actor - historical usage tab](./images/store/pay_per_event_historical_usage_tab.png) +![Pay per event Actor - historical usage tab](../images/store/pay_per_event_historical_usage_tab.png) -![Pay per event Actor - run detail](./images/store/pay_per_event_price_on_run_detail.png) +![Pay per event Actor - run detail](../images/store/pay_per_event_price_on_run_detail.png) If charges seem incorrect, contact the Actor author or the Apify support team. You can also open an issue directly on the Actor's detail page in Apify Console. ### 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). +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). -![Pay for usage Actor example](./images/store/pay_per_usage_actor_example.png) +![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). -_For more information on platform usage cost see the [usage and resources](./usage_and_resources.md) page._ +_For more information on platform usage cost see the [usage and resources](../usage_and_resources.md) page._ ::: @@ -79,7 +79,7 @@ Rental Actors are Actors for which you have to pay a recurring fee to the develo Most rental Actors have a _free trial_ period. The length of the trial is displayed on each Actor's page. -![Rental Actor example](./images/store/rental-actor-example.png) +![Rental Actor example](../images/store/rental-actor-example.png) You don't need a paid plan to start a rental Actor's free trial. After the trial, you must subscribe to one of [Apify's paid plans](https://apify.com/pricing) to continue renting and using the Actor. If you are on a paid plan, the monthly rental fee is automatically subtracted from your prepaid platform usage when the trial expires, then recurs monthly. If you are not on a paid plan when the trial ends, you are not charged but cannot use the Actor until you subscribe. @@ -89,13 +89,13 @@ _Example_: You activate a 7-day trial at _noon on April 1, 2021_. Without cancel [//]: # (TODO better link for platform usage costs explaining what it is!) -Rental fees are subtracted automatically from your prepaid platform usage, similarly to [compute units](./usage_and_resources.md). Most of the fee goes directly to the developer, and you also pay normal [platform usage costs](https://apify.com/pricing) on top - usage cost estimates are usually included in each rental Actor's README ([see an example](https://apify.com/compass/crawler-google-places#how-much-will-it-cost)). If your prepaid usage is insufficient, any overage is covered in the next invoice. +Rental fees are subtracted automatically from your prepaid platform usage, similarly to [compute units](../usage_and_resources.md). Most of the fee goes directly to the developer, and you also pay normal [platform usage costs](https://apify.com/pricing) on top - usage cost estimates are usually included in each rental Actor's README ([see an example](https://apify.com/compass/crawler-google-places#how-much-will-it-cost)). If your prepaid usage is insufficient, any overage is covered in the next invoice. You can cancel the rental at any time during the trial or afterward so you are not charged when the current rental period expires. You can always turn it back on later. To see a breakdown of rental charges, go to the **Actors** tab within the **Current period** tab in the [Billing](https://console.apify.com/billing) section. -![Rental Actors billing in Apify Console](./images/store/billing-paid-actors.png) +![Rental Actors billing in Apify Console](../images/store/billing-paid-actors.png) ## Report issues with Actors @@ -103,7 +103,7 @@ Each Actor has an **Issues** tab in Apify Console. There, you can open an issue 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 always write to [community@apify.com](mailto:community@apify.com). -![Paid Actors' issues tab](./images/store/paid-actors-issues-tab.png) +![Paid Actors' issues tab](../images/store/paid-actors-issues-tab.png) ## Apify Store discounts @@ -119,10 +119,10 @@ Additional discounts are available for Enterprise customers. To check an Actor's pricing and available discounts, visit the Pricing section on the Actor's detail page in Apify Store. -![Apify Store discounts](./images/store/apify_store_discounts_web.png) +![Apify Store discounts](../images/store/apify_store_discounts_web.png) In Apify Console, you can find information about pricing and available discounts in the Actor's header section. -![Apify Store discounts](./images/store/apify_store_discounts_console.png) +![Apify Store discounts](../images/store/apify_store_discounts_console.png) -![Apify Store discounts full table](./images/store/apify_store_discounts_full_table.png) +![Apify Store discounts full table](../images/store/apify_store_discounts_full_table.png) diff --git a/sources/platform/actors/running/store/reviews.mdx b/sources/platform/actors/running/store/reviews.mdx new file mode 100644 index 0000000000..ded455a2bc --- /dev/null +++ b/sources/platform/actors/running/store/reviews.mdx @@ -0,0 +1,64 @@ +--- +title: Actor reviews +description: Learn how to review Actors in Apify Store to help others understand how they perform and how they can be improved. +slug: /actors/running/reviews +sidebar_position: 1.1 +--- + +By reviewing and rating an Actor, you help other users understand how it performs. You can also let a developer know how they can improve their Actor. + +## Check Actor's reviews + +To see how other users rate and review a specific Actor: + +1. Navigate to the Actor's page in [Apify Store](https://apify.com/store). +1. Select the **Reviews** tab. + +![Reviews tab in Apify Store](../images/store/actor_reviews.svg) + +### Add a review + +To share your opinion of an Actor: + +1. Navigate to the Actor's page in [Apify Store](https://apify.com/store). +1. Select the **Reviews** tab. +1. Under the Actor's rating, you have two options: + - To only rate the Actor, use the star rating. + - To rate and review the Actor, select **Write review**. + +If you have a problem with the Actor that you're reviewing, consider also [opening an issue](/platform/actors/running/actors-in-store#report-issues-with-actors). + +### Edit a review + +If you only rated the Actor, you can later change that rating and add a review. + +If you rated the Actor and wrote a review, you can't edit either of those. + +### Delete a review + +If you decide your review is no longer relevant, you can delete it: + +1. Navigate to the Actor's page in [Apify Store](https://apify.com/store). +1. Select the **Reviews** tab. +1. On your review, select **Options** > **Delete**. + +## Report a review + +You can report reviews that don't follow the community standards. The support team verifies all reports and deletes reviews that violate Apify policies. + +To report a review: + +1. On a review, select **Options** > **Report**. +1. In **Reason for reporting**, select the right [category from a dropdown list](#reason-for-reporting). +1. _(Optional)_ In **Additional details**, add a comment to the report. +1. Select **Submit**. + +### Reasons for reporting a review {#reason-for-reporting} + +When reporting a review, select one of the following reasons: + +- **Hate speech or offensive language**. For example, review offends the Actor developer, Apify community, or uses foul language. +- **False or misleading information**. For example, review contains false information about the Actor's performance, features, or pricing. +- **Spam or irrelevant content**. For example, review is an ad for another Actor or product. +- **Harassment or abusive behavior**. For example, review contains abusive or threatening language. +- **Other**. For example, review is not related to the Actor or the Apify platform. diff --git a/sources/platform/console/store.md b/sources/platform/console/store.md index bd9fa9ba4e..81262dbe4d 100644 --- a/sources/platform/console/store.md +++ b/sources/platform/console/store.md @@ -18,4 +18,4 @@ You can also organize the results from the store by different criteria, includin Once you select an Actor from the store, you'll be directed to its specific page. Here, you can configure the settings for your future Actor run, save these configurations for later use, or run the Actor immediately. -For more information, see [Actors in Store](/sources/platform/actors/running/store.md). +For more information, see [Actors in Store](/sources/platform/actors/running/store/index.md).