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 6f936f5651..aad7af8155 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 @@ -100,6 +100,16 @@ Since the **Issues** tab is public, the level of activity - or lack thereof - ca Learn more about how to handle the [Issues tab](/academy/actor-marketing-playbook/interact-with-users/issues-tab) +## How Apify Store search works + +Search ranking evaluates parameters similar to those in the [Actor quality score](/platform/actors/publishing/quality-score). As a result, the two correlate strongly: Actors with higher quality scores tend to rank higher in [Apify Store](https://apify.com/store) search and the [Apify MCP server](/platform/integrations/mcp) `search-actors` tool, though no specific position is guaranteed. + +To improve your Actor's visibility in search, focus on improving its quality score. For what the score measures and how to influence each category, see [Actor quality score](/platform/actors/publishing/quality-score). + +### Search in Apify Console is personalized + +In [Apify Console](https://console.apify.com), search results are personalized for each user. As a result, the same query can return different Actors than in [Apify Store](https://apify.com/store). Quality score still correlates with ranking, but the order is adjusted per user. + ## Resources - Best practices on setting up [testing for your Actor](https://docs.apify.com/platform/actors/publishing/test) diff --git a/sources/platform/actors/publishing/quality_score.mdx b/sources/platform/actors/publishing/quality_score.mdx index 76ddf37889..6ae2ead575 100644 --- a/sources/platform/actors/publishing/quality_score.mdx +++ b/sources/platform/actors/publishing/quality_score.mdx @@ -9,6 +9,15 @@ The Actor quality score is a metric that evaluates your Actor's performance acro --- +## Quality score and search ranking + +Search ranking evaluates parameters similar to those in the quality score. As a result, the two correlate strongly across Apify search surfaces: + +- _Apify Store search_ at [apify.com/store](https://apify.com/store). +- The _Apify MCP server_ `search-actors` tool used by external AI agents. See [Apify MCP server](/platform/integrations/mcp). + +Actors with higher quality scores tend to rank higher on both surfaces, though no specific position is guaranteed. Search in Apify Console is personalized to each individual user, so the same query can return different Actors than the public Store - quality score still correlates with ranking, the order is just adjusted per user. See [How Apify Store search works](/academy/actor-marketing-playbook/store-basics/how-store-works#how-apify-store-search-works) for the publisher-facing guidance. + ## How to view your score Navigate to **Console > Insights > Actor quality**, and then select your Actor. diff --git a/sources/platform/console/store.md b/sources/platform/console/store.md index 81262dbe4d..256ce435da 100644 --- a/sources/platform/console/store.md +++ b/sources/platform/console/store.md @@ -18,4 +18,8 @@ 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. +## Search + +Search results in Apify Console are personalized to each individual user, so the same query can return different Actors than the public Store at [apify.com/store](https://apify.com/store). Both Console and the public Store rank Actors using parameters similar to those in the [Actor quality score](/platform/actors/publishing/quality-score). + For more information, see [Actors in Store](/sources/platform/actors/running/store/index.md).