From 590bf3156e7e1de484aec7bf74f8867f14caf74e Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Micha=C5=82=20Olender?= <92638966+TC-MO@users.noreply.github.com> Date: Thu, 23 Oct 2025 15:00:42 +0200 Subject: [PATCH 1/8] docs: restructure Academy expand Actor Marketing playbook prominence create new Build and publish section move content move images remove H1's fix formatting create placeholders --- .../actor-ideas/_category_.yaml | 2 + .../actor-ideas/actor_validation.md | 9 +++ .../what_software_an_actor_can_be.md | 23 +++++++ .../actor_success_stories.md | 8 +-- .../apify-store-basics/_category_.yaml | 2 + .../actor_description_seo_description.md | 2 +- .../apify-store-basics/actors_and_emojis.md} | 6 +- .../how_actor_monetization_works.md | 4 +- .../apify-store-basics}/how_store_works.md | 2 +- .../how_to_create_actor_readme.md} | 4 +- .../images/actor-description-name.png | Bin .../images/actor-description-store.png | Bin .../apify-store-basics}/images/actor-name.png | Bin .../images/actor-seo-name.png | Bin .../images/analytisc-example.png | Bin .../images/change_Actor_description.png | Bin .../changing_Actor_name_and_SEO_name.png | Bin .../images/changing__SEO_name.png | Bin ...and-where-to-set-the-actor-url-console.png | Bin .../how-and-where-to-set-the-actor-url.png | Bin .../apify-store-basics}/images/ppe-model.png | Bin .../apify-store-basics}/images/ppr-model.png | Bin .../apify-store-basics}/images/readme.png | Bin .../images/rental-model.png | Bin .../images/seo_description.png | Bin .../images/what-is-actor-url.png | Bin .../importance_of_actor_url.md} | 4 +- .../apify-store-basics/name_your_actor.md} | 4 +- .../how-to-build/_category_.yaml | 2 + .../how-to-build}/actor_bundles.md | 4 +- .../how-to-build}/actorization_playbook.mdx | 6 +- .../how_to_create_a_great_input_schema.md | 4 +- .../docling-apify-badge.png | Bin .../images/description-sshot.png | Bin .../images/improved-input-schema-example.png | Bin .../images/section-description-sshot.png | Bin .../how-to-build}/images/sections-sshot.png | Bin .../how-to-build}/images/title-sshot.png | Bin .../how-to-build}/images/toggle-sshot.png | Bin .../how-to-build}/images/tooltips-sshot.png | Bin .../images/worse-input-schema.png | Bin .../how-to-build/index.md} | 3 +- .../how-to-build}/running_a_web_server.md | 8 +-- .../interacting-with-users}/_category_.yaml | 2 +- .../emails_to_actor_users.md | 2 +- .../images/issues-tab-example.png | Bin .../interacting-with-users}/issues_tab.md | 4 +- .../interacting-with-users}/your_store_bio.md | 4 +- .../promoting-your-actor}/_category_.yaml | 2 +- .../promoting-your-actor/affiliates.md | 7 ++ .../blogs_and_blog_resources.md | 2 +- .../promoting-your-actor}/parasite_seo.md | 2 +- .../promoting-your-actor}/product_hunt.md | 2 +- .../promoting-your-actor}/seo.md | 2 +- .../promoting-your-actor}/social_media.md | 2 +- .../promoting-your-actor}/video_tutorials.md | 2 +- .../promoting-your-actor}/webinars.md | 2 +- .../academy/build-and-publish/why_publish.md | 9 +++ .../actor_basics/_category_.yaml | 2 - .../platform/get_most_of_actors/index.md | 1 + .../product_optimization/_category_.yaml | 2 - .../store_basics/_category_.yaml | 2 - .../store_basics/ideas_page_and_its_use.md | 63 ------------------ sources/academy/sidebars.js | 8 +-- 64 files changed, 101 insertions(+), 118 deletions(-) create mode 100644 sources/academy/build-and-publish/actor-ideas/_category_.yaml create mode 100644 sources/academy/build-and-publish/actor-ideas/actor_validation.md create mode 100644 sources/academy/build-and-publish/actor-ideas/what_software_an_actor_can_be.md rename sources/academy/{platform/get_most_of_actors/store_basics => build-and-publish}/actor_success_stories.md (70%) create mode 100644 sources/academy/build-and-publish/apify-store-basics/_category_.yaml rename sources/academy/{platform/get_most_of_actors/actor_basics => build-and-publish/apify-store-basics}/actor_description_seo_description.md (99%) rename sources/academy/{platform/get_most_of_actors/actor_basics/actors-and-emojis.md => build-and-publish/apify-store-basics/actors_and_emojis.md} (98%) rename sources/academy/{platform/get_most_of_actors/store_basics => build-and-publish/apify-store-basics}/how_actor_monetization_works.md (99%) rename sources/academy/{platform/get_most_of_actors/store_basics => build-and-publish/apify-store-basics}/how_store_works.md (99%) rename sources/academy/{platform/get_most_of_actors/actor_basics/how-to-create-actor-readme.md => build-and-publish/apify-store-basics/how_to_create_actor_readme.md} (99%) rename sources/academy/{platform/get_most_of_actors/actor_basics => build-and-publish/apify-store-basics}/images/actor-description-name.png (100%) rename sources/academy/{platform/get_most_of_actors/actor_basics => build-and-publish/apify-store-basics}/images/actor-description-store.png (100%) rename sources/academy/{platform/get_most_of_actors/actor_basics => build-and-publish/apify-store-basics}/images/actor-name.png (100%) rename sources/academy/{platform/get_most_of_actors/actor_basics => build-and-publish/apify-store-basics}/images/actor-seo-name.png (100%) rename sources/academy/{platform/get_most_of_actors/store_basics => build-and-publish/apify-store-basics}/images/analytisc-example.png (100%) rename sources/academy/{platform/get_most_of_actors/actor_basics => build-and-publish/apify-store-basics}/images/change_Actor_description.png (100%) rename sources/academy/{platform/get_most_of_actors/actor_basics => build-and-publish/apify-store-basics}/images/changing_Actor_name_and_SEO_name.png (100%) rename sources/academy/{platform/get_most_of_actors/actor_basics => build-and-publish/apify-store-basics}/images/changing__SEO_name.png (100%) rename sources/academy/{platform/get_most_of_actors/actor_basics => build-and-publish/apify-store-basics}/images/how-and-where-to-set-the-actor-url-console.png (100%) rename sources/academy/{platform/get_most_of_actors/actor_basics => build-and-publish/apify-store-basics}/images/how-and-where-to-set-the-actor-url.png (100%) rename sources/academy/{platform/get_most_of_actors/store_basics => build-and-publish/apify-store-basics}/images/ppe-model.png (100%) rename sources/academy/{platform/get_most_of_actors/store_basics => build-and-publish/apify-store-basics}/images/ppr-model.png (100%) rename sources/academy/{platform/get_most_of_actors/actor_basics => build-and-publish/apify-store-basics}/images/readme.png (100%) rename sources/academy/{platform/get_most_of_actors/store_basics => build-and-publish/apify-store-basics}/images/rental-model.png (100%) rename sources/academy/{platform/get_most_of_actors/actor_basics => build-and-publish/apify-store-basics}/images/seo_description.png (100%) rename sources/academy/{platform/get_most_of_actors/actor_basics => build-and-publish/apify-store-basics}/images/what-is-actor-url.png (100%) rename sources/academy/{platform/get_most_of_actors/actor_basics/importance-of-actor-url.md => build-and-publish/apify-store-basics/importance_of_actor_url.md} (99%) rename sources/academy/{platform/get_most_of_actors/actor_basics/name-your-actor.md => build-and-publish/apify-store-basics/name_your_actor.md} (99%) create mode 100644 sources/academy/build-and-publish/how-to-build/_category_.yaml rename sources/academy/{platform/get_most_of_actors/product_optimization => build-and-publish/how-to-build}/actor_bundles.md (99%) rename sources/academy/{platform => build-and-publish/how-to-build}/actorization_playbook.mdx (99%) rename sources/academy/{platform/get_most_of_actors/product_optimization => build-and-publish/how-to-build}/how_to_create_a_great_input_schema.md (99%) rename sources/academy/{platform => build-and-publish/how-to-build}/images/actorization-playbook/docling-apify-badge.png (100%) rename sources/academy/{platform/get_most_of_actors/product_optimization => build-and-publish/how-to-build}/images/description-sshot.png (100%) rename sources/academy/{platform/get_most_of_actors/product_optimization => build-and-publish/how-to-build}/images/improved-input-schema-example.png (100%) rename sources/academy/{platform/get_most_of_actors/product_optimization => build-and-publish/how-to-build}/images/section-description-sshot.png (100%) rename sources/academy/{platform/get_most_of_actors/product_optimization => build-and-publish/how-to-build}/images/sections-sshot.png (100%) rename sources/academy/{platform/get_most_of_actors/product_optimization => build-and-publish/how-to-build}/images/title-sshot.png (100%) rename sources/academy/{platform/get_most_of_actors/product_optimization => build-and-publish/how-to-build}/images/toggle-sshot.png (100%) rename sources/academy/{platform/get_most_of_actors/product_optimization => build-and-publish/how-to-build}/images/tooltips-sshot.png (100%) rename sources/academy/{platform/get_most_of_actors/product_optimization => build-and-publish/how-to-build}/images/worse-input-schema.png (100%) rename sources/academy/{platform/get_most_of_actors/store_basics/how_to_build_actors.md => build-and-publish/how-to-build/index.md} (99%) rename sources/academy/{platform => build-and-publish/how-to-build}/running_a_web_server.md (98%) rename sources/academy/{platform/get_most_of_actors/interact_with_users => build-and-publish/interacting-with-users}/_category_.yaml (69%) rename sources/academy/{platform/get_most_of_actors/interact_with_users => build-and-publish/interacting-with-users}/emails_to_actor_users.md (99%) rename sources/academy/{platform/get_most_of_actors/interact_with_users => build-and-publish/interacting-with-users}/images/issues-tab-example.png (100%) rename sources/academy/{platform/get_most_of_actors/interact_with_users => build-and-publish/interacting-with-users}/issues_tab.md (99%) rename sources/academy/{platform/get_most_of_actors/interact_with_users => build-and-publish/interacting-with-users}/your_store_bio.md (97%) rename sources/academy/{platform/get_most_of_actors/promote_your_actor => build-and-publish/promoting-your-actor}/_category_.yaml (68%) create mode 100644 sources/academy/build-and-publish/promoting-your-actor/affiliates.md rename sources/academy/{platform/get_most_of_actors/promote_your_actor => build-and-publish/promoting-your-actor}/blogs_and_blog_resources.md (99%) rename sources/academy/{platform/get_most_of_actors/promote_your_actor => build-and-publish/promoting-your-actor}/parasite_seo.md (99%) rename sources/academy/{platform/get_most_of_actors/promote_your_actor => build-and-publish/promoting-your-actor}/product_hunt.md (99%) rename sources/academy/{platform/get_most_of_actors/promote_your_actor => build-and-publish/promoting-your-actor}/seo.md (99%) rename sources/academy/{platform/get_most_of_actors/promote_your_actor => build-and-publish/promoting-your-actor}/social_media.md (99%) rename sources/academy/{platform/get_most_of_actors/promote_your_actor => build-and-publish/promoting-your-actor}/video_tutorials.md (99%) rename sources/academy/{platform/get_most_of_actors/promote_your_actor => build-and-publish/promoting-your-actor}/webinars.md (99%) create mode 100644 sources/academy/build-and-publish/why_publish.md delete mode 100644 sources/academy/platform/get_most_of_actors/actor_basics/_category_.yaml delete mode 100644 sources/academy/platform/get_most_of_actors/product_optimization/_category_.yaml delete mode 100644 sources/academy/platform/get_most_of_actors/store_basics/_category_.yaml delete mode 100644 sources/academy/platform/get_most_of_actors/store_basics/ideas_page_and_its_use.md diff --git a/sources/academy/build-and-publish/actor-ideas/_category_.yaml b/sources/academy/build-and-publish/actor-ideas/_category_.yaml new file mode 100644 index 0000000000..7856f1ce30 --- /dev/null +++ b/sources/academy/build-and-publish/actor-ideas/_category_.yaml @@ -0,0 +1,2 @@ +label: How to pick an Actor idea +position: 2 diff --git a/sources/academy/build-and-publish/actor-ideas/actor_validation.md b/sources/academy/build-and-publish/actor-ideas/actor_validation.md new file mode 100644 index 0000000000..853537a9bd --- /dev/null +++ b/sources/academy/build-and-publish/actor-ideas/actor_validation.md @@ -0,0 +1,9 @@ +--- +title: Actor idea validation +description: "lorem ipsum" +sidebar_position: 2 +category: build-and-publish +slug: /build-and-publish/actor-ideas/actor-validation +--- + +Validation framework diff --git a/sources/academy/build-and-publish/actor-ideas/what_software_an_actor_can_be.md b/sources/academy/build-and-publish/actor-ideas/what_software_an_actor_can_be.md new file mode 100644 index 0000000000..469ffc4a91 --- /dev/null +++ b/sources/academy/build-and-publish/actor-ideas/what_software_an_actor_can_be.md @@ -0,0 +1,23 @@ +--- +title: What software an Actor can be +description: "lorem ipsum" +sidebar_position: 1 +category: build-and-publish +slug: /build-and-publish/actor-ideas/what-software-an-actor-can-be +--- + +intro section about Actors and possibilities + +### Web scrapers and crawlers + +### MCP servers + +### SaaS API wrappers + +### Open-source libraries + +Mention OSS fair-share + +### AI agents + +Repurpose tutorial? diff --git a/sources/academy/platform/get_most_of_actors/store_basics/actor_success_stories.md b/sources/academy/build-and-publish/actor_success_stories.md similarity index 70% rename from sources/academy/platform/get_most_of_actors/store_basics/actor_success_stories.md rename to sources/academy/build-and-publish/actor_success_stories.md index 736d12de0a..49e419aaf2 100644 --- a/sources/academy/platform/get_most_of_actors/store_basics/actor_success_stories.md +++ b/sources/academy/build-and-publish/actor_success_stories.md @@ -1,20 +1,20 @@ --- title: Actor success stories description: Learn about developers who successfully make passive income from their Actors. -sidebar_position: 5 -category: apify platform +sidebar_position: 7 +category: build-and-publish slug: /actor-marketing-playbook/store-basics/actor-success-stories --- _Web scraping freelance financial freedom with microworlds._ -Discover how Caleb David, founder of `microworlds`, achieved financial freedom through freelance web scraping. His journey showcases how mastering the craft with tools like Crawlee and creating a Twitter scraper transformed his career. See the full story [here](https://blog.apify.com/web-scraping-freelance-financial-freedom/) and learn from his success. +Discover how Caleb David, founder of `microworlds`, achieved financial freedom through freelance web scraping. His journey showcases how mastering the craft with tools like Crawlee and creating a Twitter scraper transformed his career. See the full story in this [blog post](https://blog.apify.com/web-scraping-freelance-financial-freedom/) and learn from his success. https://apify.com/microworlds _Web scraping for freelance success – insights from Tugkan._ -In this success story, our first community dev Tugkan shares how his journey into freelancing via Apify changed his life. Learn about his process, challenges, and how his paid Actors have brought him financial rewards and freedom. Check out his story [here](https://apify.com/success-stories/paid-actor-journey-apify-freelancer-tugkan) for inspiration. +In this success story, our first community dev Tugkan shares how his journey into freelancing via Apify changed his life. Learn about his process, challenges, and how his paid Actors have brought him financial rewards and freedom. Check out his [story](https://apify.com/success-stories/paid-actor-journey-apify-freelancer-tugkan) for inspiration. https://apify.com/epctex diff --git a/sources/academy/build-and-publish/apify-store-basics/_category_.yaml b/sources/academy/build-and-publish/apify-store-basics/_category_.yaml new file mode 100644 index 0000000000..85a8994d3f --- /dev/null +++ b/sources/academy/build-and-publish/apify-store-basics/_category_.yaml @@ -0,0 +1,2 @@ +label: Apify Store basics +position: 4 diff --git a/sources/academy/platform/get_most_of_actors/actor_basics/actor_description_seo_description.md b/sources/academy/build-and-publish/apify-store-basics/actor_description_seo_description.md similarity index 99% rename from sources/academy/platform/get_most_of_actors/actor_basics/actor_description_seo_description.md rename to sources/academy/build-and-publish/apify-store-basics/actor_description_seo_description.md index 726fb7c705..859b7ef838 100644 --- a/sources/academy/platform/get_most_of_actors/actor_basics/actor_description_seo_description.md +++ b/sources/academy/build-and-publish/apify-store-basics/actor_description_seo_description.md @@ -2,7 +2,7 @@ title: Actor description & SEO description description: Learn about Actor description and meta description. Where to set them and best practices for both content and length. sidebar_position: 3 -category: apify platform +category: build-and-publish slug: /actor-marketing-playbook/actor-basics/actor-description --- diff --git a/sources/academy/platform/get_most_of_actors/actor_basics/actors-and-emojis.md b/sources/academy/build-and-publish/apify-store-basics/actors_and_emojis.md similarity index 98% rename from sources/academy/platform/get_most_of_actors/actor_basics/actors-and-emojis.md rename to sources/academy/build-and-publish/apify-store-basics/actors_and_emojis.md index 9f1a721f06..eac7606ba8 100644 --- a/sources/academy/platform/get_most_of_actors/actor_basics/actors-and-emojis.md +++ b/sources/academy/build-and-publish/apify-store-basics/actors_and_emojis.md @@ -1,8 +1,8 @@ --- -title: Actors & emojis +title: Actors and emojis description: Discover how emojis can boost your Actors by grabbing attention, simplifying navigation, and enhancing clarity. Improve user experience and engagement on Apify Store. -sidebar_position: 5 -category: apify platform +sidebar_position: 4 +category: build-and-publish slug: /actor-marketing-playbook/actor-basics/actors-and-emojis --- diff --git a/sources/academy/platform/get_most_of_actors/store_basics/how_actor_monetization_works.md b/sources/academy/build-and-publish/apify-store-basics/how_actor_monetization_works.md similarity index 99% rename from sources/academy/platform/get_most_of_actors/store_basics/how_actor_monetization_works.md rename to sources/academy/build-and-publish/apify-store-basics/how_actor_monetization_works.md index d5a0266938..4df5941a77 100644 --- a/sources/academy/platform/get_most_of_actors/store_basics/how_actor_monetization_works.md +++ b/sources/academy/build-and-publish/apify-store-basics/how_actor_monetization_works.md @@ -1,8 +1,8 @@ --- title: How Actor monetization works description: Discover how to share your tools and explore monetization options to earn from your automation expertise. -sidebar_position: 3 -category: apify platform +sidebar_position: 2 +category: build-and-publish slug: /actor-marketing-playbook/store-basics/how-actor-monetization-works --- diff --git a/sources/academy/platform/get_most_of_actors/store_basics/how_store_works.md b/sources/academy/build-and-publish/apify-store-basics/how_store_works.md similarity index 99% rename from sources/academy/platform/get_most_of_actors/store_basics/how_store_works.md rename to sources/academy/build-and-publish/apify-store-basics/how_store_works.md index bcc1d7b794..752a5c6a83 100644 --- a/sources/academy/platform/get_most_of_actors/store_basics/how_store_works.md +++ b/sources/academy/build-and-publish/apify-store-basics/how_store_works.md @@ -2,7 +2,7 @@ title: How Apify Store works description: Learn how to create and publish your own Actor, and join a growing community of innovators in scraping and web automation. sidebar_position: 1 -category: apify platform +category: build-and-publish slug: /actor-marketing-playbook/store-basics/how-store-works --- diff --git a/sources/academy/platform/get_most_of_actors/actor_basics/how-to-create-actor-readme.md b/sources/academy/build-and-publish/apify-store-basics/how_to_create_actor_readme.md similarity index 99% rename from sources/academy/platform/get_most_of_actors/actor_basics/how-to-create-actor-readme.md rename to sources/academy/build-and-publish/apify-store-basics/how_to_create_actor_readme.md index 10d3fb811a..4dbf83229f 100644 --- a/sources/academy/platform/get_most_of_actors/actor_basics/how-to-create-actor-readme.md +++ b/sources/academy/build-and-publish/apify-store-basics/how_to_create_actor_readme.md @@ -1,8 +1,8 @@ --- title: How to create an Actor README description: Learn how to write a comprehensive README to help users better navigate, understand and run public Actors in Apify Store. -sidebar_position: 3 -category: apify platform +sidebar_position: 5 +category: build-and-publish slug: /actor-marketing-playbook/actor-basics/how-to-create-an-actor-readme --- diff --git a/sources/academy/platform/get_most_of_actors/actor_basics/images/actor-description-name.png b/sources/academy/build-and-publish/apify-store-basics/images/actor-description-name.png similarity index 100% rename from sources/academy/platform/get_most_of_actors/actor_basics/images/actor-description-name.png rename to sources/academy/build-and-publish/apify-store-basics/images/actor-description-name.png diff --git a/sources/academy/platform/get_most_of_actors/actor_basics/images/actor-description-store.png b/sources/academy/build-and-publish/apify-store-basics/images/actor-description-store.png similarity index 100% rename from sources/academy/platform/get_most_of_actors/actor_basics/images/actor-description-store.png rename to sources/academy/build-and-publish/apify-store-basics/images/actor-description-store.png diff --git a/sources/academy/platform/get_most_of_actors/actor_basics/images/actor-name.png b/sources/academy/build-and-publish/apify-store-basics/images/actor-name.png similarity index 100% rename from sources/academy/platform/get_most_of_actors/actor_basics/images/actor-name.png rename to sources/academy/build-and-publish/apify-store-basics/images/actor-name.png diff --git a/sources/academy/platform/get_most_of_actors/actor_basics/images/actor-seo-name.png b/sources/academy/build-and-publish/apify-store-basics/images/actor-seo-name.png similarity index 100% rename from sources/academy/platform/get_most_of_actors/actor_basics/images/actor-seo-name.png rename to sources/academy/build-and-publish/apify-store-basics/images/actor-seo-name.png diff --git a/sources/academy/platform/get_most_of_actors/store_basics/images/analytisc-example.png b/sources/academy/build-and-publish/apify-store-basics/images/analytisc-example.png similarity index 100% rename from sources/academy/platform/get_most_of_actors/store_basics/images/analytisc-example.png rename to sources/academy/build-and-publish/apify-store-basics/images/analytisc-example.png diff --git a/sources/academy/platform/get_most_of_actors/actor_basics/images/change_Actor_description.png b/sources/academy/build-and-publish/apify-store-basics/images/change_Actor_description.png similarity index 100% rename from sources/academy/platform/get_most_of_actors/actor_basics/images/change_Actor_description.png rename to sources/academy/build-and-publish/apify-store-basics/images/change_Actor_description.png diff --git a/sources/academy/platform/get_most_of_actors/actor_basics/images/changing_Actor_name_and_SEO_name.png b/sources/academy/build-and-publish/apify-store-basics/images/changing_Actor_name_and_SEO_name.png similarity index 100% rename from sources/academy/platform/get_most_of_actors/actor_basics/images/changing_Actor_name_and_SEO_name.png rename to sources/academy/build-and-publish/apify-store-basics/images/changing_Actor_name_and_SEO_name.png diff --git a/sources/academy/platform/get_most_of_actors/actor_basics/images/changing__SEO_name.png b/sources/academy/build-and-publish/apify-store-basics/images/changing__SEO_name.png similarity index 100% rename from sources/academy/platform/get_most_of_actors/actor_basics/images/changing__SEO_name.png rename to sources/academy/build-and-publish/apify-store-basics/images/changing__SEO_name.png diff --git a/sources/academy/platform/get_most_of_actors/actor_basics/images/how-and-where-to-set-the-actor-url-console.png b/sources/academy/build-and-publish/apify-store-basics/images/how-and-where-to-set-the-actor-url-console.png similarity index 100% rename from sources/academy/platform/get_most_of_actors/actor_basics/images/how-and-where-to-set-the-actor-url-console.png rename to sources/academy/build-and-publish/apify-store-basics/images/how-and-where-to-set-the-actor-url-console.png diff --git a/sources/academy/platform/get_most_of_actors/actor_basics/images/how-and-where-to-set-the-actor-url.png b/sources/academy/build-and-publish/apify-store-basics/images/how-and-where-to-set-the-actor-url.png similarity index 100% rename from sources/academy/platform/get_most_of_actors/actor_basics/images/how-and-where-to-set-the-actor-url.png rename to sources/academy/build-and-publish/apify-store-basics/images/how-and-where-to-set-the-actor-url.png diff --git a/sources/academy/platform/get_most_of_actors/store_basics/images/ppe-model.png b/sources/academy/build-and-publish/apify-store-basics/images/ppe-model.png similarity index 100% rename from sources/academy/platform/get_most_of_actors/store_basics/images/ppe-model.png rename to sources/academy/build-and-publish/apify-store-basics/images/ppe-model.png diff --git a/sources/academy/platform/get_most_of_actors/store_basics/images/ppr-model.png b/sources/academy/build-and-publish/apify-store-basics/images/ppr-model.png similarity index 100% rename from sources/academy/platform/get_most_of_actors/store_basics/images/ppr-model.png rename to sources/academy/build-and-publish/apify-store-basics/images/ppr-model.png diff --git a/sources/academy/platform/get_most_of_actors/actor_basics/images/readme.png b/sources/academy/build-and-publish/apify-store-basics/images/readme.png similarity index 100% rename from sources/academy/platform/get_most_of_actors/actor_basics/images/readme.png rename to sources/academy/build-and-publish/apify-store-basics/images/readme.png diff --git a/sources/academy/platform/get_most_of_actors/store_basics/images/rental-model.png b/sources/academy/build-and-publish/apify-store-basics/images/rental-model.png similarity index 100% rename from sources/academy/platform/get_most_of_actors/store_basics/images/rental-model.png rename to sources/academy/build-and-publish/apify-store-basics/images/rental-model.png diff --git a/sources/academy/platform/get_most_of_actors/actor_basics/images/seo_description.png b/sources/academy/build-and-publish/apify-store-basics/images/seo_description.png similarity index 100% rename from sources/academy/platform/get_most_of_actors/actor_basics/images/seo_description.png rename to sources/academy/build-and-publish/apify-store-basics/images/seo_description.png diff --git a/sources/academy/platform/get_most_of_actors/actor_basics/images/what-is-actor-url.png b/sources/academy/build-and-publish/apify-store-basics/images/what-is-actor-url.png similarity index 100% rename from sources/academy/platform/get_most_of_actors/actor_basics/images/what-is-actor-url.png rename to sources/academy/build-and-publish/apify-store-basics/images/what-is-actor-url.png diff --git a/sources/academy/platform/get_most_of_actors/actor_basics/importance-of-actor-url.md b/sources/academy/build-and-publish/apify-store-basics/importance_of_actor_url.md similarity index 99% rename from sources/academy/platform/get_most_of_actors/actor_basics/importance-of-actor-url.md rename to sources/academy/build-and-publish/apify-store-basics/importance_of_actor_url.md index 48678dc7fc..8a7fdf692d 100644 --- a/sources/academy/platform/get_most_of_actors/actor_basics/importance-of-actor-url.md +++ b/sources/academy/build-and-publish/apify-store-basics/importance_of_actor_url.md @@ -1,8 +1,8 @@ --- title: Importance of Actor URL description: Learn how to set your Actor’s URL (technical name) and name effectively when creating it on Apify. Follow best practices to optimize your Actor’s web presence and ensure it stands out on Apify Store. -sidebar_position: 2 -category: apify platform +sidebar_position: 6 +category: build-and-publish slug: /actor-marketing-playbook/actor-basics/importance-of-actor-url --- diff --git a/sources/academy/platform/get_most_of_actors/actor_basics/name-your-actor.md b/sources/academy/build-and-publish/apify-store-basics/name_your_actor.md similarity index 99% rename from sources/academy/platform/get_most_of_actors/actor_basics/name-your-actor.md rename to sources/academy/build-and-publish/apify-store-basics/name_your_actor.md index 96dd946952..05013561a4 100644 --- a/sources/academy/platform/get_most_of_actors/actor_basics/name-your-actor.md +++ b/sources/academy/build-and-publish/apify-store-basics/name_your_actor.md @@ -1,8 +1,8 @@ --- title: Name your Actor description: Learn Apify’s standards for naming Actors and how to choose the right name for your scraping and automation tools and maximize visibility on Apify Store. -sidebar_position: 1 -category: apify platform +sidebar_position: 7 +category: build-and-publish slug: /actor-marketing-playbook/actor-basics/name-your-actor --- diff --git a/sources/academy/build-and-publish/how-to-build/_category_.yaml b/sources/academy/build-and-publish/how-to-build/_category_.yaml new file mode 100644 index 0000000000..7c7ec9f1e4 --- /dev/null +++ b/sources/academy/build-and-publish/how-to-build/_category_.yaml @@ -0,0 +1,2 @@ +label: How to build an Actor +position: 3 diff --git a/sources/academy/platform/get_most_of_actors/product_optimization/actor_bundles.md b/sources/academy/build-and-publish/how-to-build/actor_bundles.md similarity index 99% rename from sources/academy/platform/get_most_of_actors/product_optimization/actor_bundles.md rename to sources/academy/build-and-publish/how-to-build/actor_bundles.md index af7e87347d..e67b6242bc 100644 --- a/sources/academy/platform/get_most_of_actors/product_optimization/actor_bundles.md +++ b/sources/academy/build-and-publish/how-to-build/actor_bundles.md @@ -1,8 +1,8 @@ --- title: Actor bundles description: Learn what an Actor bundle is, explore existing examples, and discover how to promote them. -sidebar_position: 2 -category: apify platform +sidebar_position: 3 +category: build-and-publish slug: /actor-marketing-playbook/product-optimization/actor-bundles --- diff --git a/sources/academy/platform/actorization_playbook.mdx b/sources/academy/build-and-publish/how-to-build/actorization_playbook.mdx similarity index 99% rename from sources/academy/platform/actorization_playbook.mdx rename to sources/academy/build-and-publish/how-to-build/actorization_playbook.mdx index d02abb1a6f..73be5fca90 100644 --- a/sources/academy/platform/actorization_playbook.mdx +++ b/sources/academy/build-and-publish/how-to-build/actorization_playbook.mdx @@ -1,8 +1,8 @@ --- -title: Actorization playbook +title: Wrap open-source as an Actor description: A guide to converting your applications, scripts, and open-source projects into monetizable, cloud-based tools on the Apify platform. -sidebar_position: 11 -category: apify platform +sidebar_position: 1 +category: build-and-publish slug: /actorization --- diff --git a/sources/academy/platform/get_most_of_actors/product_optimization/how_to_create_a_great_input_schema.md b/sources/academy/build-and-publish/how-to-build/how_to_create_a_great_input_schema.md similarity index 99% rename from sources/academy/platform/get_most_of_actors/product_optimization/how_to_create_a_great_input_schema.md rename to sources/academy/build-and-publish/how-to-build/how_to_create_a_great_input_schema.md index 1c9c70f1f8..9eb30f0901 100644 --- a/sources/academy/platform/get_most_of_actors/product_optimization/how_to_create_a_great_input_schema.md +++ b/sources/academy/build-and-publish/how-to-build/how_to_create_a_great_input_schema.md @@ -1,8 +1,8 @@ --- title: How to create a great input schema description: Optimizing your input schema. Learn to design and refine your input schema with best practices for a better user experience. -sidebar_position: 1 -category: apify platform +sidebar_position: 2 +category: build-and-publish slug: /actor-marketing-playbook/product-optimization/how-to-create-a-great-input-schema --- diff --git a/sources/academy/platform/images/actorization-playbook/docling-apify-badge.png b/sources/academy/build-and-publish/how-to-build/images/actorization-playbook/docling-apify-badge.png similarity index 100% rename from sources/academy/platform/images/actorization-playbook/docling-apify-badge.png rename to sources/academy/build-and-publish/how-to-build/images/actorization-playbook/docling-apify-badge.png diff --git a/sources/academy/platform/get_most_of_actors/product_optimization/images/description-sshot.png b/sources/academy/build-and-publish/how-to-build/images/description-sshot.png similarity index 100% rename from sources/academy/platform/get_most_of_actors/product_optimization/images/description-sshot.png rename to sources/academy/build-and-publish/how-to-build/images/description-sshot.png diff --git a/sources/academy/platform/get_most_of_actors/product_optimization/images/improved-input-schema-example.png b/sources/academy/build-and-publish/how-to-build/images/improved-input-schema-example.png similarity index 100% rename from sources/academy/platform/get_most_of_actors/product_optimization/images/improved-input-schema-example.png rename to sources/academy/build-and-publish/how-to-build/images/improved-input-schema-example.png diff --git a/sources/academy/platform/get_most_of_actors/product_optimization/images/section-description-sshot.png b/sources/academy/build-and-publish/how-to-build/images/section-description-sshot.png similarity index 100% rename from sources/academy/platform/get_most_of_actors/product_optimization/images/section-description-sshot.png rename to sources/academy/build-and-publish/how-to-build/images/section-description-sshot.png diff --git a/sources/academy/platform/get_most_of_actors/product_optimization/images/sections-sshot.png b/sources/academy/build-and-publish/how-to-build/images/sections-sshot.png similarity index 100% rename from sources/academy/platform/get_most_of_actors/product_optimization/images/sections-sshot.png rename to sources/academy/build-and-publish/how-to-build/images/sections-sshot.png diff --git a/sources/academy/platform/get_most_of_actors/product_optimization/images/title-sshot.png b/sources/academy/build-and-publish/how-to-build/images/title-sshot.png similarity index 100% rename from sources/academy/platform/get_most_of_actors/product_optimization/images/title-sshot.png rename to sources/academy/build-and-publish/how-to-build/images/title-sshot.png diff --git a/sources/academy/platform/get_most_of_actors/product_optimization/images/toggle-sshot.png b/sources/academy/build-and-publish/how-to-build/images/toggle-sshot.png similarity index 100% rename from sources/academy/platform/get_most_of_actors/product_optimization/images/toggle-sshot.png rename to sources/academy/build-and-publish/how-to-build/images/toggle-sshot.png diff --git a/sources/academy/platform/get_most_of_actors/product_optimization/images/tooltips-sshot.png b/sources/academy/build-and-publish/how-to-build/images/tooltips-sshot.png similarity index 100% rename from sources/academy/platform/get_most_of_actors/product_optimization/images/tooltips-sshot.png rename to sources/academy/build-and-publish/how-to-build/images/tooltips-sshot.png diff --git a/sources/academy/platform/get_most_of_actors/product_optimization/images/worse-input-schema.png b/sources/academy/build-and-publish/how-to-build/images/worse-input-schema.png similarity index 100% rename from sources/academy/platform/get_most_of_actors/product_optimization/images/worse-input-schema.png rename to sources/academy/build-and-publish/how-to-build/images/worse-input-schema.png diff --git a/sources/academy/platform/get_most_of_actors/store_basics/how_to_build_actors.md b/sources/academy/build-and-publish/how-to-build/index.md similarity index 99% rename from sources/academy/platform/get_most_of_actors/store_basics/how_to_build_actors.md rename to sources/academy/build-and-publish/how-to-build/index.md index 7dfd10fa05..e7296b1ca2 100644 --- a/sources/academy/platform/get_most_of_actors/store_basics/how_to_build_actors.md +++ b/sources/academy/build-and-publish/how-to-build/index.md @@ -1,8 +1,7 @@ --- title: How to build Actors description: Learn how to create web scrapers and automation tools on Apify. Use universal scrapers for quick setup, code templates for a head start, or SDKs and libraries for full control. -sidebar_position: 2 -category: apify platform +category: build-and-publish slug: /actor-marketing-playbook/store-basics/how-to-build-actors --- diff --git a/sources/academy/platform/running_a_web_server.md b/sources/academy/build-and-publish/how-to-build/running_a_web_server.md similarity index 98% rename from sources/academy/platform/running_a_web_server.md rename to sources/academy/build-and-publish/how-to-build/running_a_web_server.md index 9c30d4d1a1..8a4eaecc86 100644 --- a/sources/academy/platform/running_a_web_server.md +++ b/sources/academy/build-and-publish/how-to-build/running_a_web_server.md @@ -1,13 +1,11 @@ --- -title: Running a web server on the Apify platform +title: Run a web server on the Apify platform description: A web server running in an Actor can act as a communication channel with the outside world. Learn how to set one up with Node.js. -sidebar_position: 12 -category: apify platform +sidebar_position: 4 +category: build-and-publish slug: /running-a-web-server --- -# Running a web server on the Apify platform - **A web server running in an Actor can act as a communication channel with the outside world. Learn how to set one up with Node.js.** --- diff --git a/sources/academy/platform/get_most_of_actors/interact_with_users/_category_.yaml b/sources/academy/build-and-publish/interacting-with-users/_category_.yaml similarity index 69% rename from sources/academy/platform/get_most_of_actors/interact_with_users/_category_.yaml rename to sources/academy/build-and-publish/interacting-with-users/_category_.yaml index bc25bda8d9..c404fd7092 100644 --- a/sources/academy/platform/get_most_of_actors/interact_with_users/_category_.yaml +++ b/sources/academy/build-and-publish/interacting-with-users/_category_.yaml @@ -1,2 +1,2 @@ label: Interact with users -position: 4 +position: 6 diff --git a/sources/academy/platform/get_most_of_actors/interact_with_users/emails_to_actor_users.md b/sources/academy/build-and-publish/interacting-with-users/emails_to_actor_users.md similarity index 99% rename from sources/academy/platform/get_most_of_actors/interact_with_users/emails_to_actor_users.md rename to sources/academy/build-and-publish/interacting-with-users/emails_to_actor_users.md index 7359c094dc..d838e3b7e7 100644 --- a/sources/academy/platform/get_most_of_actors/interact_with_users/emails_to_actor_users.md +++ b/sources/academy/build-and-publish/interacting-with-users/emails_to_actor_users.md @@ -2,7 +2,7 @@ title: Emails to Actor users description: Email communication is a key tool to keep users engaged and satisfied. Learn when and how to email your users effectively to build loyalty and strengthen relationships with this practical guide. sidebar_position: 1 -category: apify platform +category: build-and-publish slug: /actor-marketing-playbook/interact-with-users/emails-to-actor-users --- diff --git a/sources/academy/platform/get_most_of_actors/interact_with_users/images/issues-tab-example.png b/sources/academy/build-and-publish/interacting-with-users/images/issues-tab-example.png similarity index 100% rename from sources/academy/platform/get_most_of_actors/interact_with_users/images/issues-tab-example.png rename to sources/academy/build-and-publish/interacting-with-users/images/issues-tab-example.png diff --git a/sources/academy/platform/get_most_of_actors/interact_with_users/issues_tab.md b/sources/academy/build-and-publish/interacting-with-users/issues_tab.md similarity index 99% rename from sources/academy/platform/get_most_of_actors/interact_with_users/issues_tab.md rename to sources/academy/build-and-publish/interacting-with-users/issues_tab.md index d604e362f9..94da0d3245 100644 --- a/sources/academy/platform/get_most_of_actors/interact_with_users/issues_tab.md +++ b/sources/academy/build-and-publish/interacting-with-users/issues_tab.md @@ -1,8 +1,8 @@ --- -title: Issues tab +title: Handle Actor issues description: Learn how the Issues tab can help you improve your Actor, engage with users, and build a reliable, user-friendly solution. sidebar_position: 2 -category: apify platform +category: build-and-publish slug: /actor-marketing-playbook/interact-with-users/issues-tab --- diff --git a/sources/academy/platform/get_most_of_actors/interact_with_users/your_store_bio.md b/sources/academy/build-and-publish/interacting-with-users/your_store_bio.md similarity index 97% rename from sources/academy/platform/get_most_of_actors/interact_with_users/your_store_bio.md rename to sources/academy/build-and-publish/interacting-with-users/your_store_bio.md index 07d5e60d35..2b51350c67 100644 --- a/sources/academy/platform/get_most_of_actors/interact_with_users/your_store_bio.md +++ b/sources/academy/build-and-publish/interacting-with-users/your_store_bio.md @@ -1,8 +1,8 @@ --- -title: Your Store bio +title: Your Apify Store bio description: Your Apify Store bio is all about helping you promote your tools & skills. sidebar_position: 3 -category: apify platform +category: build-and-publish slug: /actor-marketing-playbook/interact-with-users/your-store-bio --- diff --git a/sources/academy/platform/get_most_of_actors/promote_your_actor/_category_.yaml b/sources/academy/build-and-publish/promoting-your-actor/_category_.yaml similarity index 68% rename from sources/academy/platform/get_most_of_actors/promote_your_actor/_category_.yaml rename to sources/academy/build-and-publish/promoting-your-actor/_category_.yaml index 363e5e0947..44df2b2806 100644 --- a/sources/academy/platform/get_most_of_actors/promote_your_actor/_category_.yaml +++ b/sources/academy/build-and-publish/promoting-your-actor/_category_.yaml @@ -1,2 +1,2 @@ label: Promote your Actor -position: 3 +position: 5 diff --git a/sources/academy/build-and-publish/promoting-your-actor/affiliates.md b/sources/academy/build-and-publish/promoting-your-actor/affiliates.md new file mode 100644 index 0000000000..eae5a67210 --- /dev/null +++ b/sources/academy/build-and-publish/promoting-your-actor/affiliates.md @@ -0,0 +1,7 @@ +--- +title: Affiliates +description: Lorem ipsum +sidebar_position: 8 +category: build-and-publish +slug: /actor-marketing-playbook/promote-your-actor/affiliates +--- diff --git a/sources/academy/platform/get_most_of_actors/promote_your_actor/blogs_and_blog_resources.md b/sources/academy/build-and-publish/promoting-your-actor/blogs_and_blog_resources.md similarity index 99% rename from sources/academy/platform/get_most_of_actors/promote_your_actor/blogs_and_blog_resources.md rename to sources/academy/build-and-publish/promoting-your-actor/blogs_and_blog_resources.md index 4d5f34bd7b..a77395d6c5 100644 --- a/sources/academy/platform/get_most_of_actors/promote_your_actor/blogs_and_blog_resources.md +++ b/sources/academy/build-and-publish/promoting-your-actor/blogs_and_blog_resources.md @@ -2,7 +2,7 @@ title: Blogs and blog resources description: Blogs are still a powerful way to promote your Actors and build authority. By sharing expertise, engaging users, and driving organic traffic, blogging remains a key strategy to complement social media, SEO, and other platforms in growing your audience. sidebar_position: 5 -category: apify platform +category: build-and-publish slug: /actor-marketing-playbook/promote-your-actor/blogs-and-blog-resources --- diff --git a/sources/academy/platform/get_most_of_actors/promote_your_actor/parasite_seo.md b/sources/academy/build-and-publish/promoting-your-actor/parasite_seo.md similarity index 99% rename from sources/academy/platform/get_most_of_actors/promote_your_actor/parasite_seo.md rename to sources/academy/build-and-publish/promoting-your-actor/parasite_seo.md index 11af5c28ed..a05ca0647a 100644 --- a/sources/academy/platform/get_most_of_actors/promote_your_actor/parasite_seo.md +++ b/sources/academy/build-and-publish/promoting-your-actor/parasite_seo.md @@ -2,7 +2,7 @@ title: Parasite SEO description: Explore parasite SEO, a unique strategy that leverages third-party sites to boost rankings and drive traffic to your tools. sidebar_position: 3 -category: apify platform +category: build-and-publish slug: /actor-marketing-playbook/promote-your-actor/parasite-seo --- diff --git a/sources/academy/platform/get_most_of_actors/promote_your_actor/product_hunt.md b/sources/academy/build-and-publish/promoting-your-actor/product_hunt.md similarity index 99% rename from sources/academy/platform/get_most_of_actors/promote_your_actor/product_hunt.md rename to sources/academy/build-and-publish/promoting-your-actor/product_hunt.md index 474cb80a3f..090c0ca0d7 100644 --- a/sources/academy/platform/get_most_of_actors/promote_your_actor/product_hunt.md +++ b/sources/academy/build-and-publish/promoting-your-actor/product_hunt.md @@ -2,7 +2,7 @@ title: Product Hunt description: Boost your Actor’s visibility by launching it on Product Hunt, a top platform for tech innovations. Attract early adopters, developers, and businesses while showcasing your tool’s value through visuals or demos. sidebar_position: 4 -category: apify platform +category: build-and-publish slug: /actor-marketing-playbook/promote-your-actor/product-hunt --- diff --git a/sources/academy/platform/get_most_of_actors/promote_your_actor/seo.md b/sources/academy/build-and-publish/promoting-your-actor/seo.md similarity index 99% rename from sources/academy/platform/get_most_of_actors/promote_your_actor/seo.md rename to sources/academy/build-and-publish/promoting-your-actor/seo.md index 4e474e45ba..a92e3ffe85 100644 --- a/sources/academy/platform/get_most_of_actors/promote_your_actor/seo.md +++ b/sources/academy/build-and-publish/promoting-your-actor/seo.md @@ -2,7 +2,7 @@ title: SEO description: Learn how to optimize your content to rank higher on search engines like Google and Bing, attract more users, and drive long-term traffic - all for free. sidebar_position: 1 -category: apify platform +category: build-and-publish slug: /actor-marketing-playbook/promote-your-actor/seo --- diff --git a/sources/academy/platform/get_most_of_actors/promote_your_actor/social_media.md b/sources/academy/build-and-publish/promoting-your-actor/social_media.md similarity index 99% rename from sources/academy/platform/get_most_of_actors/promote_your_actor/social_media.md rename to sources/academy/build-and-publish/promoting-your-actor/social_media.md index 7b772c1ca8..ade8bc3ee6 100644 --- a/sources/academy/platform/get_most_of_actors/promote_your_actor/social_media.md +++ b/sources/academy/build-and-publish/promoting-your-actor/social_media.md @@ -2,7 +2,7 @@ title: Social media description: Leverage social media to connect with users and grow your Actor’s audience. Learn how to showcase features, engage with users, and avoid common pitfalls. sidebar_position: 2 -category: apify platform +category: build-and-publish slug: /actor-marketing-playbook/promote-your-actor/social-media --- diff --git a/sources/academy/platform/get_most_of_actors/promote_your_actor/video_tutorials.md b/sources/academy/build-and-publish/promoting-your-actor/video_tutorials.md similarity index 99% rename from sources/academy/platform/get_most_of_actors/promote_your_actor/video_tutorials.md rename to sources/academy/build-and-publish/promoting-your-actor/video_tutorials.md index 4972b05c63..f6a86f0f00 100644 --- a/sources/academy/platform/get_most_of_actors/promote_your_actor/video_tutorials.md +++ b/sources/academy/build-and-publish/promoting-your-actor/video_tutorials.md @@ -2,7 +2,7 @@ title: Video tutorials description: Use video tutorials to demonstrate features, offer tutorials, and connect with users in real time, building trust and driving interest in your tools. sidebar_position: 6 -category: apify platform +category: build-and-publish slug: /actor-marketing-playbook/promote-your-actor/video-tutorials --- diff --git a/sources/academy/platform/get_most_of_actors/promote_your_actor/webinars.md b/sources/academy/build-and-publish/promoting-your-actor/webinars.md similarity index 99% rename from sources/academy/platform/get_most_of_actors/promote_your_actor/webinars.md rename to sources/academy/build-and-publish/promoting-your-actor/webinars.md index d020d6d042..ee3c7ea238 100644 --- a/sources/academy/platform/get_most_of_actors/promote_your_actor/webinars.md +++ b/sources/academy/build-and-publish/promoting-your-actor/webinars.md @@ -2,7 +2,7 @@ title: Webinars description: Webinars and live streams are powerful tools to showcase your Actor’s features. Learn how to plan, host, and maximize the impact of your webinar. sidebar_position: 7 -category: apify platform +category: build-and-publish slug: /actor-marketing-playbook/promote-your-actor/webinars --- diff --git a/sources/academy/build-and-publish/why_publish.md b/sources/academy/build-and-publish/why_publish.md new file mode 100644 index 0000000000..fa8c926c90 --- /dev/null +++ b/sources/academy/build-and-publish/why_publish.md @@ -0,0 +1,9 @@ +--- +title: Why publish Actors on Apify +description: +sidebar_position: 1 +category: build-and-publish +slug: /build-and-publish/why +--- + +This is placeholder. diff --git a/sources/academy/platform/get_most_of_actors/actor_basics/_category_.yaml b/sources/academy/platform/get_most_of_actors/actor_basics/_category_.yaml deleted file mode 100644 index 74ba842c8c..0000000000 --- a/sources/academy/platform/get_most_of_actors/actor_basics/_category_.yaml +++ /dev/null @@ -1,2 +0,0 @@ -label: Actor basics -position: 2 diff --git a/sources/academy/platform/get_most_of_actors/index.md b/sources/academy/platform/get_most_of_actors/index.md index 25c7aabbd0..44b85a69fb 100644 --- a/sources/academy/platform/get_most_of_actors/index.md +++ b/sources/academy/platform/get_most_of_actors/index.md @@ -4,6 +4,7 @@ description: Learn how to optimize and monetize your Actors on Apify Store by sh sidebar_position: 10 category: apify platform slug: /actor-marketing-playbook +unlisted: true --- **Learn how to optimize and monetize your Actors on Apify Store by sharing them with other platform users.** diff --git a/sources/academy/platform/get_most_of_actors/product_optimization/_category_.yaml b/sources/academy/platform/get_most_of_actors/product_optimization/_category_.yaml deleted file mode 100644 index 7df7832630..0000000000 --- a/sources/academy/platform/get_most_of_actors/product_optimization/_category_.yaml +++ /dev/null @@ -1,2 +0,0 @@ -label: Product optimization -position: 5 diff --git a/sources/academy/platform/get_most_of_actors/store_basics/_category_.yaml b/sources/academy/platform/get_most_of_actors/store_basics/_category_.yaml deleted file mode 100644 index 82effc00e4..0000000000 --- a/sources/academy/platform/get_most_of_actors/store_basics/_category_.yaml +++ /dev/null @@ -1,2 +0,0 @@ -label: Store basics -position: 1 diff --git a/sources/academy/platform/get_most_of_actors/store_basics/ideas_page_and_its_use.md b/sources/academy/platform/get_most_of_actors/store_basics/ideas_page_and_its_use.md deleted file mode 100644 index 81e5df5416..0000000000 --- a/sources/academy/platform/get_most_of_actors/store_basics/ideas_page_and_its_use.md +++ /dev/null @@ -1,63 +0,0 @@ ---- -title: Ideas page and its use -description: Learn where you can draw inspiration for your Actors. -sidebar_position: 4 -category: apify platform -slug: /actor-marketing-playbook/store-basics/ideas-page ---- - -So you want to build an Actor and publish it on Apify Store. Where should you start? How can you make people want to use it? - -To generate new Actor ideas, you can draw from your experience. You can also use SEO tools to discover relevant search terms and explore sites related to web scraping, automation, or integrations. But for direct inspiration straight from Apify, check out our Actor [Ideas page](https://apify.com/ideas) to see what data extraction tools are trending in the Apify community. Let's see how you can both use and contribute to this valuable resource. - ---- - -## What's the Ideas page? - -The [Ideas page](https://apify.com/ideas) is where users can submit and explore potential projects for Actors, including scrapers, integrations, and automations. It serves as a collaborative space for proposing new tool ideas and finding inspiration for building and developing web scraping and automation solutions. - -## How you, as a developer, can use the Ideas page - -Got an innovative Actor idea or unsure what to build next? The Apify Ideas page is your go-to destination for submitting, developing, and claiming Actor concepts. If you're a developer ready to build an Actor using the Apify Ideas page, here’s how you can get involved: - -1. _Browse the Ideas page_
- Check out the [Ideas page](https://apify.com/ideas) to find ideas that interest you. Look for ideas that align with your skills and the kind of Actor you want to build. -2. _Select an idea_
- Once you’ve found a promising idea, review the details and requirements provided. If you see an idea you want to develop, make sure to check its current status. If it’s marked as **Open to develop**, you’re good to go. -3. _Develop your Actor_
- Start building your Actor based on the idea. You don’t need to notify Apify about your development process. Focus on creating a functional and well-documented tool. -4. _Prepare for launch_
- Once your Actor is ready, ensure it meets all quality standards and has a comprehensive README. This documentation should include installation instructions, usage details, and any other relevant information. -5. _Publish your Actor_
- Deploy your Actor on Apify Store. Make sure it’s live and accessible for users. -6. _Claim your idea_
- After your Actor is published, email [ideas@apify.com](mailto:ideas@apify.com) with the URL of your Actor and the original idea. This will allow us to tag the idea as Completed and link it to your new Actor, giving you credit and visibility. -7. _Monitor and optimize_
- Make sure to monitor your Actor’s performance and user feedback. Use this information to make improvements and keep your Actor up to date. - -By following these steps, you’ll be able to contribute to the community while also gaining recognition for your work. - -## Criteria for claiming an idea - -To claim an idea, ensure that: - -1. Your Actor is functional. -2. Your README contains relevant information. -3. Your Actor closely aligns with the original idea. - -## Giving back to the Ideas page - -The Ideas page at Apify offers a variety of concepts for scrapers, integrations, and automations, and is a great place to find inspiration or solutions. It’s also a platform where you can contribute your own ideas to drive innovation and growth in our community. - -1. _Submit your Ideas_
- Got a great Actor concept? Share it with us through the [Ideas form](https://apify.typeform.com/to/BNON8poB#source=ideas). Provide clear details about what your tool should do and how it should work. -2. _Engage with the community_
- Upvote ideas you find intriguing. The more support an idea receives, the more likely it is to catch a developer’s eye and move forward. -3. _Don’t forget to claim your idea_
- Once your Actor is up and running, claim your idea by emailing [ideas@apify.com](mailto:ideas@apify.com) with your Actor's URL and the original idea. We’ll mark your idea as **Completed** and link it to your Actor - a signal to the other developers that this tool already exists on Apify Store. - -## Multiple developers for one idea - -No problem! Apify Store can host multiple Actors with similar functions. However, we go by the “first come - first served” rule, so the first developer to claim an idea will receive the **Completed** tag and a link from the Ideas page. - -Remember that Apify Store is just like any other marketplace. We believe that competition helps developers thrive and improve upon their code, especially when there are similar scrapers on the horizon! You can still build the Actor, but try to be imaginative when it comes to its set of features. diff --git a/sources/academy/sidebars.js b/sources/academy/sidebars.js index 2e370b7b61..d274d0af15 100644 --- a/sources/academy/sidebars.js +++ b/sources/academy/sidebars.js @@ -14,25 +14,25 @@ module.exports = { }, { type: 'category', - label: 'AI agents', + label: 'Apify Platform', collapsible: false, className: 'section-header', items: [ { type: 'autogenerated', - dirName: 'ai', + dirName: 'platform', }, ], }, { type: 'category', - label: 'Apify Platform', + label: 'Build & publish Actors', collapsible: false, className: 'section-header', items: [ { type: 'autogenerated', - dirName: 'platform', + dirName: 'build-and-publish', }, ], }, From d31497e8fc33056d5711fa3e33a1bcd8b487e1ec Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Micha=C5=82=20Olender?= <92638966+TC-MO@users.noreply.github.com> Date: Thu, 23 Oct 2025 15:22:21 +0200 Subject: [PATCH 2/8] fix vale errors --- .../actor_description_seo_description.md | 2 +- .../how_to_create_actor_readme.md | 14 +++++++------- .../how-to-build/actor_bundles.md | 2 +- .../how_to_create_a_great_input_schema.md | 15 +++++++++++---- .../build-and-publish/how-to-build/index.md | 4 ++-- .../emails_to_actor_users.md | 4 ++-- .../interacting-with-users/issues_tab.md | 2 +- .../blogs_and_blog_resources.md | 4 ++-- .../promoting-your-actor/parasite_seo.md | 2 +- 9 files changed, 28 insertions(+), 21 deletions(-) diff --git a/sources/academy/build-and-publish/apify-store-basics/actor_description_seo_description.md b/sources/academy/build-and-publish/apify-store-basics/actor_description_seo_description.md index 859b7ef838..298e5c9e83 100644 --- a/sources/academy/build-and-publish/apify-store-basics/actor_description_seo_description.md +++ b/sources/academy/build-and-publish/apify-store-basics/actor_description_seo_description.md @@ -70,7 +70,7 @@ Setting the SEO description and SEO name is optional. If not set, the descriptio ![changing actor name and seo name](images/changing_Actor_name_and_SEO_name.png) -Actor description specifically can also be quick-edited in this pop-up on the Actor's page in Apify Console. Open the **Actor's page**, then click on **…** in the top right corner, and choose ✎ **Edit name or description**. Then set the URL in the **Unique name** ✎ field and click **Save**. +Actor description specifically can also be quick-edited in this pop-up on the Actor's page in Apify Console. Open the **Actor's page**, then click on **…** in the top right corner, and choose ✎ **Edit name or description**. Then set the URL in the **Unique name** ✎ field and click **Save**. ![changing actor description](images/change_Actor_description.png) diff --git a/sources/academy/build-and-publish/apify-store-basics/how_to_create_actor_readme.md b/sources/academy/build-and-publish/apify-store-basics/how_to_create_actor_readme.md index 4dbf83229f..6b0d9d2e12 100644 --- a/sources/academy/build-and-publish/apify-store-basics/how_to_create_actor_readme.md +++ b/sources/academy/build-and-publish/apify-store-basics/how_to_create_actor_readme.md @@ -23,7 +23,7 @@ README files typically include information on: - How users can get started with the project - Where users can get help with your project -We mean all of this and even more. At Apify, when we talk about READMEs, we refer to the public Actor detail page on Apify Store. Specifically, its first tab. The README exists in the same form both on the web and in Console. So what is it for? +We mean all of this and even more. At Apify, when we talk about READMEs, we refer to the public Actor detail page on Apify Store. Specifically, its first tab. The README exists in the same form both on the web and in Console. What is it for then? Before we dive in, a little disclaimer: you don't need your Apify README to fulfill all its purposes. Technically, you could even publish an Actor with just a single word in the README. But you'd be missing out if you did that. @@ -32,7 +32,7 @@ Your Actor’s README has at least four functions: 1. _SEO_ - If your README is well-structured and includes important keywords — both in headings and across the text — it has a high chance of being noticed and promoted by Google. Organic search brings the most motivated type of potential users. If you win this game, you've won most of the SEO game. 2. _First impression_ - Your README is one of the first points of contact with a potential user. If you come across as convincing, clear, and reassuring it could be the factor that will make a user try your Actor for their task. 3. _Extended instruction_ - The README is also the space that explains specific complex input settings. For example, special formatting of the input, any coding-related, or extended functions. Of course, you could put that all in a blog post as well, but the README should be their first point of contact. -4. _Support_ - Your users come back to the README when they face issues. So use it as a space to let them know that's where they can find links to the tutorials if they run into issues, describe common troubleshooting techniques, share tricks, or warn you about bugs. +4. _Support_ - Your users come back to the README when they face issues. Use it as a space to let them know that's where they can find links to the tutorials if they run into issues, describe common troubleshooting techniques, share tricks, or warn you about bugs. ## README elements theory @@ -92,7 +92,7 @@ You might think the part above the Actor detail page already indicates pricing. - If it's price per result, you can extrapolate how many results a user can get on a free plan and also entice them with a larger plan and how many thousands of results they can get with that. - If it's a bundle that consists of a couple of Actors that are priced differently, you can use this section to talk about the difference between all the Actors involved and how that will affect the final price of a run. -In any case, on top of setting expectations and reassuring users, this paragraph can get into Google. If somebody is Googling "How much does it cost to scrape [website]", they might come across this part of your README and it will lead them from Google search directly to your Actor's detail page. So you don't want to miss that opportunity. +In any case, on top of setting expectations and reassuring users, this paragraph can get into Google. If somebody is Googling "How much does it cost to scrape [website]", they might come across this part of your README and it will lead them from Google search directly to your Actor's detail page. You don't want to miss that opportunity. ![readme example](images/readme.png) @@ -108,7 +108,7 @@ If your datasets come out too complex and you want to save your users some scrol ### Other Actors -Don't forget to promote your other Actors. While our system for Actor recommendation works - you can see related Actors at the bottom of the README — it only works within the same category or similar name. It won't recommend a completely different Actor from the same creator. So make sure to interconnect your work by taking the initiative yourself. You can mention your other Actors in a list or as a table. +Don't forget to promote your other Actors. While our system for Actor recommendation works - you can see related Actors at the bottom of the README — it only works within the same category or similar name. It won't recommend a completely different Actor from the same creator. Make sure to interconnect your work by taking the initiative yourself. You can mention your other Actors in a list or as a table. ### FAQ, disclaimers, and support @@ -157,7 +157,7 @@ From the point of view of retention, it doesn't mean you can't have long or comp ### Images and videos -As for using screenshots and GIFs, put them in some sort of image hosting. Your own GitHub repository would be best because you have full control over it. Name the images with SEO in mind and try to keep them compressed but good enough quality. You don't want to load an image or GIF for too long. +As for using screenshots and gifs, put them in some sort of image hosting. Your own GitHub repository would be best because you have full control over it. Name the images with SEO in mind and try to keep them compressed but good enough quality. You don't want to load an image or gif for too long. One trick is not only to add images but also to make them clickable. For some reason, people like clicking on images, at least they try to when we look at the heatmaps. You can lead the screenshot clicks towards a signup page, which is possible with Markdown. @@ -190,7 +190,7 @@ A good README has to be a balance between what you want your page visitors to kn ### Table of contents -The H1 of your page is the Actor name, so you don't have to set that up. Don't add more H1s. README headings should be H2 or H3. H2 headings will make up the table of contents on the right. So if you don't want the table to be too crowded, keep the H2s to the basics and push all the longer phrases and questions to H3s. H3s will stay hidden in the accordion in the default state until the visitor hovers their cursor over it. H4 readings can also be included, of course, but they won't show up as a part of the table of contents. +The H1 of your page is the Actor name, so you don't have to set that up. Don't add more H1s. README headings should be H2 or H3. H2 headings will make up the table of contents on the right. If you don't want the table to be too crowded, keep the H2s to the basics and push all the longer phrases and questions to H3s. H3s will stay hidden in the accordion in the default state until the visitor hovers their cursor over it. H4 readings can also be included, of course, but they won't show up as a part of the table of contents. ### Keyword opportunities @@ -232,7 +232,7 @@ Learn about [How to create a great input schema](/academy/actor-marketing-playbo - Link to a success story, a business use case, or a blog post. 3. How to scrape (target site) - Link to "How to…" blogs, if one exists (or suggest one if it doesn't) - - Add a video tutorial or GIF from an ideal Actor run. + - Add a video tutorial or gif from an ideal Actor run. :::tip Embedding YouTube videos diff --git a/sources/academy/build-and-publish/how-to-build/actor_bundles.md b/sources/academy/build-and-publish/how-to-build/actor_bundles.md index e67b6242bc..3ad238f54d 100644 --- a/sources/academy/build-and-publish/how-to-build/actor_bundles.md +++ b/sources/academy/build-and-publish/how-to-build/actor_bundles.md @@ -30,7 +30,7 @@ The main advantage of an Actor bundle is its ease of use. The user inputs a keyw 🦾 [Website Content Crawler + Pinecone bundle](https://apify.com/tri_angle/wcc-pinecone-integration) scrapes a website and stores the data in a Pinecone database to build and improve your own AI chatbot assistant. -🤖 [Pinecone GPT Chatbot](https://apify.com/tri_angle/pinecone-gpt-chatbot) combines OpenAI's GPT models with Pinecone's vector database, which simplifies creating a GPT Chatbot. +🤖 [Pinecone GPT chatbot](https://apify.com/tri_angle/pinecone-gpt-chatbot) combines OpenAI's GPT models with Pinecone's vector database, which simplifies creating a GPT chatbot. As you can see, they vary in complexity and range. diff --git a/sources/academy/build-and-publish/how-to-build/how_to_create_a_great_input_schema.md b/sources/academy/build-and-publish/how-to-build/how_to_create_a_great_input_schema.md index 9eb30f0901..77bc327581 100644 --- a/sources/academy/build-and-publish/how-to-build/how_to_create_a_great_input_schema.md +++ b/sources/academy/build-and-publish/how-to-build/how_to_create_a_great_input_schema.md @@ -12,13 +12,20 @@ Optimizing your input schema. Learn to design and refine your input schema with ## What is an input schema? -So you've succeeded: your user has 1. found your Actor on Google, 2. explored the Actor's landing page, 3. decided to try it, and 4. created an Apify account. Now they’re on your Actor's page in Apify Console. The SEO fight is over. What’s next? +You've succeeded: your user has: + +1. Found your Actor on Google. +1. Explored the Actor's landing page. +1. Decided to try it. +1. Created an Apify account. + +Now they’re on your Actor's page in Apify Console. The SEO fight is over. What’s next? Your user is finally one-on-one with your Actor — specifically, its input schema. This is the moment when they try your Actor and decide whether to stick with it. The input schema is your representative here, and you want it to work in your favor. Technically, the input schema is a `JSON` object with various field types supported by the Apify platform, designed to simplify the use of the Actor. Based on the input schema you define, the Apify platform automatically generates a _user interface_ for your Actor. -Of course, you can create an Actor without setting up an elaborate input schema. If your Actor is designed for users who don't need a good interface (e.g. they’ll use a JSON object and call it via API), you can skip this guide. But most users engage with Actors in Manual mode, aka the Actor interface. So, if your Actor is complex or you’re targeting regular users who need an intuitive interface, it's essential to consider their experience. +Of course, you can create an Actor without setting up an elaborate input schema. If your Actor is designed for users who don't need a good interface (e.g. they’ll use a JSON object and call it via API), you can skip this guide. But most users engage with Actors in Manual mode, aka the Actor interface. If your Actor is complex or you’re targeting regular users who need an intuitive interface, it's essential to consider their experience. In this article, _we’ll refer to the input schema as the user interface_ of your Actor and focus exclusively on it. @@ -56,7 +63,7 @@ A well-designed input schema is all about managing user expectations, reducing c You can see the full list of elements and their technical characteristics in [Docs](https://docs.apify.com/academy/deploying-your-code/input-schema): titles, tooltips, toggles, prefills, etc. That's not what this guide is about. It's not enough to just create an input schema, you should ideally aim to place and word its elements to the user's advantage: to alleviate the user's cognitive load and make the acquaintance and usage of your tool as smooth as possible. -Unfortunately, when it comes to UX, there's only so much you can achieve armed with HTML alone. So here are the best elements to focus on, along with some best practices for using them effectively: +Unfortunately, when it comes to UX, there's only so much you can achieve armed with HTML alone. Here are the best elements to focus on, along with some best practices for using them effectively: - **`description` at the top** - As the first thing users see, the description needs to provide crucial information and a sense of reassurance if things go wrong. Key points to mention: the easiest way to try the Actor, links to a guide, and any disclaimers or other similar Actors to try. @@ -79,7 +86,7 @@ Unfortunately, when it comes to UX, there's only so much you can achieve armed w - There’s also a type of field that looks like a prefill but isn’t — usually a `default` field. It’s not counted as actual input but serves as a mock input to show users what to type or paste. It is gray and disappears after clicking on it. Use this to your advantage. - **toggle** - The toggle is a boolean field. A boolean field represents a yes/no choice. - - So how would you word this toggle: **Skip closed places** or **Scrape open places only**? And should the toggle be enabled or disabled by default? + - How would you word this toggle: **Skip closed places** or **Scrape open places only**? And should the toggle be enabled or disabled by default? ![Input schema toggle example](images/toggle-sshot.png) diff --git a/sources/academy/build-and-publish/how-to-build/index.md b/sources/academy/build-and-publish/how-to-build/index.md index e7296b1ca2..5670747a3b 100644 --- a/sources/academy/build-and-publish/how-to-build/index.md +++ b/sources/academy/build-and-publish/how-to-build/index.md @@ -135,9 +135,9 @@ Basically, the choice here depends on how much flexibility you need and how much [Universal scrapers](https://apify.com/scrapers/universal-web-scrapers) are simple to set up but are less flexible and configurable. Our [libraries](https://crawlee.dev/), on the other hand, enable the development of a standard [Node.js](https://nodejs.org/) or Python application, so be prepared to write a little more code. The reward for that is almost infinite flexibility. -[Code templates](https://apify.com/templates) are sort of a middle ground between scrapers and libraries. But since they are built on libraries, they are still on the rather more coding than less coding side. They will only give you a starter code to begin with. So please take this into account when choosing the way to build your scraper, and if in doubt — just ask us, and we'll help you out. +[Code templates](https://apify.com/templates) are sort of a middle ground between scrapers and libraries. But since they are built on libraries, they are still on the rather more coding than less coding side. They will only give you a starter code to begin with. Please take this into account when choosing the way to build your scraper, and if in doubt — just ask us, and we'll help you out. -## Switching sides: how to transfer an existing solution from another platform +## Switching sides: How to transfer an existing solution from another platform You can also take advantage of the Apify platform's features without having to modify your existing scraping or automation solutions. diff --git a/sources/academy/build-and-publish/interacting-with-users/emails_to_actor_users.md b/sources/academy/build-and-publish/interacting-with-users/emails_to_actor_users.md index d838e3b7e7..663628547a 100644 --- a/sources/academy/build-and-publish/interacting-with-users/emails_to_actor_users.md +++ b/sources/academy/build-and-publish/interacting-with-users/emails_to_actor_users.md @@ -46,7 +46,7 @@ New filter, faster scraping, changes in input schema, in output schema, a new In > >A bit of context: while Tripadvisor never limited the search for restaurants or attractions, hotel search was a different case; it always capped at 3000. Our smart search is designed to overcome that limit by including every city within your chosen location. We scrape hotels from each one, ensuring no hidden gems slip through the cracks. This feature is available for [Tripadvisor Scraper](https://console.apify.com/actors/dbEyMBriog95Fv8CW/console) and [Tripadvisor Hotels Scraper](https://console.apify.com/actors/qx7G70MC4WBE273SM/console). > ->So get ready for an unbeatable hotel-hunting experience. Give it a spin, and let us know what you think! +>Get ready for an unbeatable hotel-hunting experience. Give it a spin, and let us know what you think! Introduce and explain the features, add a screenshot of a feature if it will show in the input schema, and ask for feedback. @@ -109,7 +109,7 @@ Actor downtime, performance issues, Actor directly influenced by platform hiccup > >We've got a quick update on the Google Maps Scraper for you. If you've been running the Actor this week, you might have noticed some hiccups — scraping was failing for certain places, causing retries and overall slowness. > ->We apologize for any inconvenience this may have caused you. The **good news is those performance issues are now resolved**. So feel free to resurrect any affected runs using the "latest" build, should work like a charm now. +>We apologize for any inconvenience this may have caused you. The **good news is those performance issues are now resolved**. Feel free to resurrect any affected runs using the "latest" build, should work like a charm now. > >Need a hand or have questions? Feel free to reply to this email. diff --git a/sources/academy/build-and-publish/interacting-with-users/issues_tab.md b/sources/academy/build-and-publish/interacting-with-users/issues_tab.md index 94da0d3245..330809182d 100644 --- a/sources/academy/build-and-publish/interacting-with-users/issues_tab.md +++ b/sources/academy/build-and-publish/interacting-with-users/issues_tab.md @@ -24,7 +24,7 @@ You can view all the issues related to your Actors by going to **Actors** > [**I ## What is the Issues tab for? -The tab is a series of conversations between you and your users. There are existing systems like GitHub for that. So why create a separate system like an Issues tab? Since the Issues tab exists both in private space (Console) and public space (Actor's page on the web), it can fulfill two different sets of purposes. +The tab is a series of conversations between you and your users. There are existing systems like GitHub for that. Why create a separate system like an Issues tab? Since the Issues tab exists both in private space (Console) and public space (Actor's page on the web), it can fulfill two different sets of purposes. ### Issues tab in Apify Console diff --git a/sources/academy/build-and-publish/promoting-your-actor/blogs_and_blog_resources.md b/sources/academy/build-and-publish/promoting-your-actor/blogs_and_blog_resources.md index a77395d6c5..b68b621a93 100644 --- a/sources/academy/build-and-publish/promoting-your-actor/blogs_and_blog_resources.md +++ b/sources/academy/build-and-publish/promoting-your-actor/blogs_and_blog_resources.md @@ -42,7 +42,7 @@ slug: /actor-marketing-playbook/promote-your-actor/blogs-and-blog-resources There are a variety of platforms where you can publish your blog posts to reach the right audience: -1. [Dev.to](http://dev.to/): It's a developer-friendly platform where technical content gets a lot of visibility, and a great place to publish how-to guides, tutorials, and technical breakdowns of your Actor. +1. [dev.to](http://dev.to/): It's a developer-friendly platform where technical content gets a lot of visibility, and a great place to publish how-to guides, tutorials, and technical breakdowns of your Actor. 2. Medium: Allows you to reach a broader, less technical audience. It’s also good for writing about general topics like automation trends or how to improve data scraping practices. 3. ScrapeDiary: Run by Apify, [scrapediary.com](http://scrapediary.com) is a blog specifically geared toward Apify community devs and web scraping topics. Publishing here is a great way to reach users already interested in scraping and automation. Contact us if you want to publish a blog post there. 4. Personal blogs or company websites. If you have your own blog or a company site, post there. It’s the most direct way to control your content and engage your established audience. @@ -116,6 +116,6 @@ To drive traffic to your blog and keep users engaged, reference your blog posts ## Additional tips for blog success 1. Consistency. Regular posting helps build an audience and makes sure you keep at it. Try to stick to a consistent schedule, whether it’s weekly, bi-weekly, or monthly. As Woody Allen said, “80 percent of success is showing up”. -2. Guest blogging. Reach out to other blogs or platforms like [Dev.to](http://dev.to/) for guest blogging opportunities. This helps you tap into new audiences. +2. Guest blogging. Reach out to other blogs or platforms like [dev.to](http://dev.to/) for guest blogging opportunities. This helps you tap into new audiences. 3. Repurpose content. Once you’ve written a blog post, repurpose it. Turn it into a YouTube video, break it down into social media posts, or use it as the base for a webinar. 4. Monitor performance. Use analytics to track how your blog is performing. Are people reading it? Is it driving traffic to your Actor? What keywords is it ranking for? Who are your competitors? Use this data to refine your content strategy. diff --git a/sources/academy/build-and-publish/promoting-your-actor/parasite_seo.md b/sources/academy/build-and-publish/promoting-your-actor/parasite_seo.md index a05ca0647a..062e981596 100644 --- a/sources/academy/build-and-publish/promoting-your-actor/parasite_seo.md +++ b/sources/academy/build-and-publish/promoting-your-actor/parasite_seo.md @@ -52,7 +52,7 @@ LinkedIn Pulse is similar to Medium, so we won’t go into too much detail. The ## Reddit -1. You must have a Reddit account to use to comment in relevant Subreddits. +1. You must have a Reddit account to use to comment in relevant subreddits. 2. Go to Google and perform this search: `site:reddit.com `, where you replace `` with the main topic of your Actor. 3. Now, list relevant Reddit threads that Google gives you. For an Airbnb scraper, this might be a good thread: [Has anybody have an latest Airbnb scraper code?](https://www.reddit.com/r/webscraping/comments/m650ol/has_anybody_have_an_latest_airbnb_scraper_code/) 4. To prioritize threads from the list, you can check the traffic they get from Google in [Ahrefs Traffic Checker](https://ahrefs.com/traffic-checker). Just paste the URL, and the tool will give you traffic estimation. You can use this number to prioritize your list. If the volume exceeds 10, it usually has some traffic potential. From 4064678462f1c6005601daf8aeae805c410c2f0a Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Micha=C5=82=20Olender?= <92638966+TC-MO@users.noreply.github.com> Date: Thu, 23 Oct 2025 15:30:19 +0200 Subject: [PATCH 3/8] remove broken link --- sources/academy/platform/get_most_of_actors/index.md | 6 ------ 1 file changed, 6 deletions(-) diff --git a/sources/academy/platform/get_most_of_actors/index.md b/sources/academy/platform/get_most_of_actors/index.md index 44b85a69fb..bbc58218a6 100644 --- a/sources/academy/platform/get_most_of_actors/index.md +++ b/sources/academy/platform/get_most_of_actors/index.md @@ -46,12 +46,6 @@ To help you succeed, we've created a comprehensive Actor marketing playbook. You to="/academy/actor-marketing-playbook/store-basics/how-actor-monetization-works" smallImage /> - Date: Tue, 28 Oct 2025 12:27:06 +0100 Subject: [PATCH 4/8] add new content Remove placeholder content Add new content Fix formatting Add new positions to accept.txt --- .../config/vocabularies/Docs/accept.txt | 2 +- .../actor-ideas/actor_validation.md | 169 +++++++++++++++++- .../what_software_an_actor_can_be.md | 120 ++++++++++++- .../how-to-build/actorization_playbook.mdx | 2 +- .../how_to_create_a_great_input_schema.md | 6 +- .../promoting-your-actor/affiliates.md | 125 ++++++++++++- .../academy/build-and-publish/why_publish.md | 76 +++++++- 7 files changed, 483 insertions(+), 17 deletions(-) diff --git a/.github/styles/config/vocabularies/Docs/accept.txt b/.github/styles/config/vocabularies/Docs/accept.txt index 900bb3c6bd..c25f6c7ab0 100644 --- a/.github/styles/config/vocabularies/Docs/accept.txt +++ b/.github/styles/config/vocabularies/Docs/accept.txt @@ -118,7 +118,7 @@ SKUs? subreddits? [Ss]ubwoofer Tripadvisor -upvote +[Uu]pvote [Ww]alkthroughs? ul diff --git a/sources/academy/build-and-publish/actor-ideas/actor_validation.md b/sources/academy/build-and-publish/actor-ideas/actor_validation.md index 853537a9bd..7a4fdebeee 100644 --- a/sources/academy/build-and-publish/actor-ideas/actor_validation.md +++ b/sources/academy/build-and-publish/actor-ideas/actor_validation.md @@ -1,9 +1,172 @@ --- -title: Actor idea validation -description: "lorem ipsum" +title: Validate your Actor idea +description: Learn how to validate market demand for your Actor using SEO data, community research, and competitive analysis before you build. sidebar_position: 2 category: build-and-publish slug: /build-and-publish/actor-ideas/actor-validation --- -Validation framework +Before investing time into building an Actor, validate that people actually need it. This guide shows you how to assess market demand using free tools and research techniques. + +## Assess your motivation + +Ask yourself: _Do you want to build this?_ + +You'll work on this Actor for a long time. The best Actors come from developers who genuinely care about the problem they're solving. You don't need to be obsessed, but you should feel excited. That enthusiasm carries you through challenges and shows +in your work. + +## Estimate demand with SEO data + +Check if people are searching for solutions like yours. If your idea aligns with popular search queries, you have a built-in user base. + +### Keyword demand + +Search for terms related to your Actor's function. If you're building a Reddit sentiment analysis scraper, check volume for phrases like _Reddit data extractor_ or _analyze Reddit comments tool_. + +Use free tools: + +- [Google Keyword Planner](https://business.google.com/en-all/ad-tools/keyword-planner/) +- [Whatsmyserp](https://chromewebstore.google.com/detail/whatsmyserp/chbmoagfhnkggnhbjpoonnmhnpjdjdod) Chrome extension +- [Keywords Everywhere](https://keywordseverywhere.com/) (paid) + +High search volume or multiple related terms indicate solid demand. Low or zero searches mean a very niche market, which isn't bad, but you'll rely more on direct marketing. + +### Google autocomplete and related searches + +Type your core keywords into Google and note the suggestions. Typing _scrape Amazon_ might show _scrape Amazon reviews_ or _Amazon price tracker_, confirming what people actually want. + +### SEO difficulty and content gaps + +Examine current search results. Few quality results for a query like _download data from [obscure site]_ indicates a content gap your Actor can fill. + +Many results or ads for _Instagram scraper_ means the market is proven but competitive. You'll need to differentiate. + +Check keyword difficulty and domain authority. If difficulty is 70+ and top pages have 80+ domain authority with thousands of backlinks—and Apify already has an official Actor with 100,000+ users—you can't compete directly. Find an adjacent angle or specialization. + +## Analyze Google Trends + +Google Trends shows if interest in your idea is rising or falling. Declining trends are red flags. If searches dropped 90% over 12+ months (like _Clubhouse scraper_ since 2021), that market has moved on. + +Growth velocity matters more than current volume. A keyword growing from 10 to 100 monthly searches over 12 months shows exploding demand. Jump in early, before competition heats up. + +Watch for spikes. Sudden jumps from media coverage or viral moments usually don't mean sustainable demand. + +## Research community discussions + +Beyond SEO data, go where your potential users are. Browse Reddit, Hacker News, Stack Overflow, X (Twitter), Discord, and Facebook groups. What problems are people discussing? What tools do they wish existed? + +Document your findings. Note quotes and recurring themes like _Multiple marketers on Reddit want easy competitor pricing tracking—no existing solution mentioned_. These insights complement your SEO data and help you speak your users' language. + +Zero discussion across multiple platforms over 4+ weeks means either no one cares about the problem or they've already solved it. + +### Reddit + +Search relevant subreddits (r/webscraping, r/datascience, r/SEO, r/marketing, or industry-specific ones) for questions like _How can I extract [data] from [site]?_ or _I wish there was a tool to do X_. Multiple people independently asking for the same solution is strong validation. + +Use the `site:` parameter in Google to search for relevant threads: + +```text + +site:reddit.com extracting data from LinkedIn + +``` + +You can also use tools like [F5Bot](https://f5bot.com/) or +[GummySearch](https://gummysearch.com/). + +### Q&A forums and Stack Overflow + +Look for questions about doing the task manually. If thinking about a LinkedIn scraper, check Stack Overflow for questions like _How can I scrape LinkedIn profiles?_ Frequent questions or upvotes indicate many people trying to solve it without a good tool—an opportunity for your Actor. + +Use the `site:` parameter: + +```text + +site:stackoverflow.com extracting data from LinkedIn + +``` + +### X and social media + +Search keywords on X, LinkedIn, or other social media for professionals asking for recommendations like _Does anyone know a tool to monitor news about [topic]?_ + +Run quick polls or ask your followers if they'd use a tool that does XYZ. A few positive responses validate your idea. Silence means rethink your value proposition. Engaging this way is early marketing. + +Use the `site:` parameter: + +```text + +site:x.com extracting data from LinkedIn + +``` + +### Hacker News and niche forums + +Platforms like [Hacker News](news.ycombinator.com) often have discussions on tech pain points and new tool launches. Search for keywords like _scrape Airbnb data_ to see if people have shown interest or if someone launched a similar tool and what the reaction was. + +Use the `site:` parameter: + +```text + +site:news.ycombinator.com extracting data from LinkedIn + +``` + +:::tip Look for spending signals + +Current spending patterns are the strongest signal. When users mention "currently paying $X/month for [existing tool] but..." or "upgraded from free to paid plan because..." or specific competitor pricing, they are proven buyers. + +You can also engage in communities. Answer related questions, share knowledge, build reputation. Mention your Actor idea casually where relevant: "I'm building a tool to solve exactly this, would you use it?" Track responses. Positive responses with questions about pricing or features mean genuine interest. + +::: + +## Analyze GitHub repositories + +Star counts signal market demand. [Scrapy](https://github.com/scrapy/scrapy) has 58,000+, [Crawlee](https://github.com/apify/crawlee) has 20,000+, web scraping is validated. Use the [Star History tool](https://www.star-history.com/) to check if stars are rising (growing momentum) or flat. + +Issue analysis reveals pain points your Actor could solve. High issue counts with active responses indicate healthy, used projects. Open issues with themes like _JavaScript rendering problems_ or _CAPTCHA bypass needed_ show gaps you can fill. Issues with 10+ upvotes mean multiple users face the same problem. + +Fork and commit activity shows developers actively work with the technology. High fork-to-star ratios mean people are building extensions (evidence of real usage). Recent commits (within 30 days) indicate active maintenance and a healthy project. No commits for 6+ months suggests declining interest. + +## Review Product Hunt launches + +Study successful automation tool launches from the past 12-24 months on Product Hunt. Filter by _Browser Automation_ and _Automation tools_, then sort by upvotes. Note which taglines, value propositions, and features resonated. Products with 500+ upvotes validated something—figure out what worked. + +## Research Apify Store + +Apify Store shows transparent competitive intelligence most marketplaces hide. Every Actor displays monthly users, ratings, pricing, and last updates, a data goldmine for what works and what doesn't. + +Search your use case or segment thoroughly. List relevant Actors with their metrics: monthly users, ratings, pricing, last update, and creator. Create a feature comparison matrix. Analyze top performers' READMEs, documentation quality, and issues. + +Review competitor issues tabs closely. High-quality READMEs with examples and clear value propositions perform better in Store search. Issues reveal unresolved pain points from actual users. If competitors have 20+ open issues with repeated themes, that's your differentiation roadmap. + +### Assess market saturation + +- 10-30 Actors: healthy competition (market validated, you need differentiation) +- 50+ Actors: saturated (need obvious gaps) +- 1-5 Actors: blue ocean or unproven demand (validate carefully) + +If the market has 50+ Actors with strong leaders (Apify-maintained with 50,000+ users) and you can't articulate clear differentiation, pivot. If you spot feature gaps or underserved niches, continue. + +## Scan the broader market + +Do a general Google search for tools or services that solve your problem. Your competition might not be another Actor—it could be a SaaS tool or API. If your idea is _monitor website uptime and screenshot changes_, established services probably exist. + +Note direct competitors: How do they price it? What audience do they target? Are users satisfied or complaining? This validates that people pay for the service and reveals gaps you can fill. + +Understanding the competition helps you refine your unique value—whether that's lower cost, better features, or targeting an underserved niche. + +No existing solutions? Ask why. You might have found an untapped need, or it's a red flag (too difficult to implement, or the target website aggressively blocks scraping). Use your judgment. + +## Get feedback from potential users + +Reach out to people who match your target user profile. Building a real estate data Actor? Contact real estate analysts or agents (LinkedIn works well) and ask if a tool that does X would help them. Keep it informal—describe the problem you're solving and ask if they'd use or pay for it. + +Direct feedback helps you: + +- Validate your assumptions +- Understand pricing expectations +- Identify must-have features +- Refine your value proposition + +Track responses carefully. Enthusiasm with specific questions about features or pricing indicates genuine interest. Generic "sounds interesting" responses mean keep validating. diff --git a/sources/academy/build-and-publish/actor-ideas/what_software_an_actor_can_be.md b/sources/academy/build-and-publish/actor-ideas/what_software_an_actor_can_be.md index 469ffc4a91..54c86abfe3 100644 --- a/sources/academy/build-and-publish/actor-ideas/what_software_an_actor_can_be.md +++ b/sources/academy/build-and-publish/actor-ideas/what_software_an_actor_can_be.md @@ -1,23 +1,129 @@ --- -title: What software an Actor can be -description: "lorem ipsum" +title: Find ideas for your Actor +description: Discover what types of software you can build as Actors and use Apify's Ideas page to find trending projects for scrapers, integrations, and automation tools. sidebar_position: 1 category: build-and-publish -slug: /build-and-publish/actor-ideas/what-software-an-actor-can-be +slug: /build-and-publish/actor-ideas/find-actor-ideas --- -intro section about Actors and possibilities +You want to build an Actor and publish it on Apify Store. Where should you start? See what types of software work as Actors and how to use the Apify Ideas page to find projects that users need. + +--- + +## What can you build as an Actor + +Actors are serverless cloud applications that run on the Apify platform. While most Actors are web scrapers, you can build various types of software as Actors can be anything that accepts input, performs a job, and runs in Docker. ### Web scrapers and crawlers -### MCP servers +The most common type of Actor extracts data from websites. These Actors navigate web pages, collect information, and store structured data in datasets. + +Examples: + +- Site-specific scrapers (Amazon Product Scraper, LinkedIn Profile Scraper) +- Search engine scrapers (Google Search Results, Bing Search) +- Social media scrapers (X/Twitter Scraper, Instagram Scraper) +- E-commerce data extractors (Shopify Store Scraper, eBay Price Monitor) ### SaaS API wrappers +Convert existing SaaS services into Actors to make them accessible through the Apify platform. This approach lets users integrate these services with Apify's automation ecosystem. + +Example: + +- [Parsera](https://apify.com/parsera-labs/parsera) wraps the Parsera.org service + ### Open-source libraries -Mention OSS fair-share +Package open-source tools as Actors to provide cloud-hosted versions that users can try without local installation. You handle no infrastructure while users cover compute costs. + +Examples: + +- [Monolith](https://apify.com/snshn/monolith) from the Y2Z/monolith GitHub project +- [Crawl4AI](https://apify.com/janbuchar/crawl4ai) from the unclecode/crawl4ai repository +- [Docling](https://apify.com/vancura/docling/source-code) from IBM's +docling-project + +:::tip Open Source Fair Share + +Open-source developers can earn income through [Apify's Open Source Fair Share program](https://apify.com/partners/open-source-fair-share). + +::: + +### MCP servers + +Model Context Protocol (MCP) servers let AI agents interact with external tools and data sources. Converting MCP servers to Actors makes them accessible through Apify's platform. + +Examples: + +- [Playwright MCP](https://apify.com/jiri.spilka/playwright-mcp-server) from Microsoft's playwright-mcp +- [Browserbase MCP](https://apify.com/mcp-servers/browserbase-mcp-server) from Browserbase ### AI agents -Repurpose tutorial? +Build Actors that use LLMs to perform complex tasks autonomously. These Actors can navigate websites, make decisions, and complete multi-step workflows. + +## Use the Ideas page + +The [Apify Ideas page](https://apify.com/ideas) is where users submit and explore potential projects for Actors. It serves as a collaborative space for proposing new tools and finding inspiration for web scraping and automation solutions. + +### Browse and claim ideas + +If you're unsure what to build next, the Ideas page shows projects the community wants. + +Steps to develop an idea: + +1. Browse the page: Visit [apify.com/ideas](https://apify.com/ideas) to find ideas that interest you. Look for ideas that align with your skills. + +1. Select an idea: Review the details and requirements. Check the status—if it's marked **Open to develop**, you can start building. + +1. Build your Actor: Develop your Actor based on the idea. You don't need to notify Apify during development. + +1. Prepare for launch: Ensure your Actor meets quality standards and has a comprehensive README with installation instructions, usage details, and examples. + +1. Publish your Actor: Deploy your Actor on Apify Store and make it live. + +1. Claim your idea: After publishing, email [ideas@apify.com](mailto:ideas@apify.com) with your Actor URL and the original idea. Apify will tag the idea as _Completed_ and link it to your Actor. + +1. Monitor and optimize: Track your Actor's performance and user feedback. Make improvements to keep your Actor current. + +### Criteria for claiming an idea + +To claim an idea, ensure: + +- Your Actor is functional +- Your README contains relevant information +- Your Actor closely aligns with the original idea + +### Submit your own ideas + +The Ideas page is also where you contribute concepts to drive innovation in the community. + +How to contribute: + +1. Submit ideas: Share Actor concepts through the [Ideas submission +form](https://apify.typeform.com/to/BNON8poB#source=ideas). Provide clear details about what the tool should do and how it should work. + +1. Engage with the community: Upvote ideas you find intriguing. More support +increases the likelihood a developer will build it. + +1. Claim completed ideas: Once your Actor is running, claim your idea by emailing [ideas@apify.com](mailto:ideas@apify.com). Apify will mark it +_Completed_ and link it to your Actor—signaling to other developers that this tool exists. + +### Multiple developers for one idea + +Apify Store can host multiple Actors with similar functions. However, the "first come, first served" rule applies—the first developer to claim an idea receives the _Completed_ tag and a link from the Ideas page. + +Competition helps developers improve their code. You can still build the Actor, but differentiate with a unique set of features. + +## Generate ideas from other sources + +Beyond the Ideas page, you can find Actor ideas through: + +- SEO tools: Discover relevant search terms people use to find solutions +- Your experience: Draw from problems you've encountered in your work +- Community discussions: Browse Reddit, Stack Overflow, and forums for pain +points +- Competitor analysis: Research existing tools and identify gaps + +For a complete validation framework, see [Validate your Actor idea](/academy/build-and-publish/actor-ideas/actor-validation). diff --git a/sources/academy/build-and-publish/how-to-build/actorization_playbook.mdx b/sources/academy/build-and-publish/how-to-build/actorization_playbook.mdx index 73be5fca90..270b05ebc5 100644 --- a/sources/academy/build-and-publish/how-to-build/actorization_playbook.mdx +++ b/sources/academy/build-and-publish/how-to-build/actorization_playbook.mdx @@ -6,7 +6,7 @@ category: build-and-publish slug: /actorization --- -Apify is a cloud platform with a [marketplace](https://apify.com/store) of 5,000+ web scraping and automation tools called _Actors_. These tools are used for extracting data from social media, search engines, maps, e-commerce sites, travel portals, and general websites. +Apify is a cloud platform with a [marketplace](https://apify.com/store) of 6,000+ web scraping and automation tools called _Actors_. These tools are used for extracting data from social media, search engines, maps, e-commerce sites, travel portals, and general websites. Most Actors are developed by a global creator community, and some are developed by Apify. We have 18k monthly active users/developers on the platform (growing 138% YoY). Last month, we paid out $170k to creators (growing 118% YoY), and in total, over the program's history, we paid out almost $2M to them. diff --git a/sources/academy/build-and-publish/how-to-build/how_to_create_a_great_input_schema.md b/sources/academy/build-and-publish/how-to-build/how_to_create_a_great_input_schema.md index 77bc327581..0cc5bb10f2 100644 --- a/sources/academy/build-and-publish/how-to-build/how_to_create_a_great_input_schema.md +++ b/sources/academy/build-and-publish/how-to-build/how_to_create_a_great_input_schema.md @@ -10,7 +10,7 @@ Optimizing your input schema. Learn to design and refine your input schema with --- -## What is an input schema? +## What is an input schema You've succeeded: your user has: @@ -71,6 +71,7 @@ Unfortunately, when it comes to UX, there's only so much you can achieve armed w ![Input schema description example](images/description-sshot.png) - Descriptions can include multiple paragraphs. If you're adding a link, it’s best to use the `target_blank` property so your user doesn’t lose the original Actor page when clicking. + - **`title` of the field (regular bold text)** - This is the default way to name a field. - Keep it brief. The user’s flow should be 1. title → 2. tooltip → 3. link in the tooltip. Ideally, the title alone should provide enough clarity. However, avoid overloading the title with too much information. Instead, make the title as concise as possible, expand details in the tooltip, and include a link in the tooltip for full instructions. @@ -92,6 +93,7 @@ Unfortunately, when it comes to UX, there's only so much you can achieve armed w - You have to consider this when you're choosing how to word the toggle button and which choice to set up as the default. If you're making this more complex than it's needed (e.g. by using negation as the ‘yes’ choice), you're increasing your user's cognitive load. You also might get them to receive way less, or way more, data than they need from a default run. - In our example, we assume the default user wants to scrape all places but still have the option to filter out closed ones. However, they have to make that choice consciously, so we keep the toggle disabled by default. If the toggle were enabled by default, users might not notice it, leading them to think the tool isn't working properly when it returns fewer results than expected. + - **sections or `sectionCaption` (BIG bold text) and `sectionDescription`** - A section looks like a wrapped toggle list. @@ -118,7 +120,7 @@ Unfortunately, when it comes to UX, there's only so much you can achieve armed w :::tip -Read more on the use of emojis: [Actors and emojis] +Read more on the use of emojis: [Actors and emojis](academy/actor-marketing-playbook/actor-basics/actors-and-emojis) ::: diff --git a/sources/academy/build-and-publish/promoting-your-actor/affiliates.md b/sources/academy/build-and-publish/promoting-your-actor/affiliates.md index eae5a67210..ab27b94dda 100644 --- a/sources/academy/build-and-publish/promoting-your-actor/affiliates.md +++ b/sources/academy/build-and-publish/promoting-your-actor/affiliates.md @@ -1,7 +1,130 @@ --- title: Affiliates -description: Lorem ipsum +description: Join the Apify Affiliate Program to earn recurring commissions by promoting Actors, platform features, and professional services. Learn how to use your network, create content, and maximize your earnings. sidebar_position: 8 category: build-and-publish slug: /actor-marketing-playbook/promote-your-actor/affiliates --- + +The Apify Affiliate Program offers you a way to earn recurring commissions while helping others discover automation and web scraping solutions. Whether you promote Apify Store or refer customers to Apify's professional services, you can monetize your expertise and network. + +The program rewards collaboration with up to 30% recurring commission and up to $2,500 per customer for professional services referrals. With no time limits on commissions, transparent tracking, and flexible payout options, it's built for long-term partnerships. + +--- + +## How the program works + +The Apify Affiliate Program lets you promote three main offerings: + +1. _Apify Store_: recommend Actors from the marketplace that help businesses automate lead generation, pricing intelligence, content aggregation, and more. +1. _Apify platform_: promote the platform's features, including scheduling, monitoring, data export options, proxies, and integrations. +1. _Professional services_: refer customers who need custom web scraping solutions to Apify's Professional Services team and earn up to $2,500 per closed deal. + +### Commission structure + +- _20% commission_ for the first 3 months of each customer's subscription +- _30% commission_ from month 4 onwards for as long as they remain customers +- _Up to $2,500 per customer_ for professional services referrals +- _No time limits on commissions_ - you earn as long as your referrals stay active + +### Free trial advantage + +Apify offers a $5 free trial that renews monthly, giving your referrals time to test the tools before subscribing. This increases conversion rates and helps you earn more consistent commissions. + +--- + +## How to succeed as an affiliate + +### Use word of mouth + +Tell clients, business contacts, or colleagues how Apify solves their lead generation, data collection, and automation challenges. Personal recommendations carry weight, especially when you can speak to real use cases. + +### Create educational content + +Use your platform to demonstrate value: + +- Blog posts: write tutorials, case studies, or problem-solving guides that feature Apify tools +- Video content: record demos, walkthroughs, or quick tips showing how Actors work +- Podcasts: discuss automation workflows and mention specific Actors that solve common problems +- Social media: share favorite Actors, tools, or workflows with your audience + +### Engage your community + +If you run a forum, Discord server, or an online group, position Apify as a resource for solving automation and data collection challenges. Answer questions and recommend relevant Actors when they fit the problem. + +### Teach and inspire + +If you teach AI automation, engineering, marketing, or lead generation, include Apify in your curriculum. Show students how to use Actors in webinars, online courses, or workshops. + +--- + +## Benefits beyond commissions + +### Exclusive perks for top performers + +High-performing affiliates and their referrals can access: + +- Exclusive discounts on platform usage +- Free prepaid credits +- Early access to new tools and features + +### Co-marketing opportunities + +Collaborate with Apify on: + +- Joint marketing campaigns +- Workshops and webinars +- Partner success stories +- Industry events and conferences + +These opportunities help you build visibility and strengthen relationships with your audience. + +--- + +## Payment and tracking + +### Transparent dashboard + +Track referrals in real-time through a dashboard that shows: + +- Active referrals +- Commission earnings +- Conversion rates +- Payment history + +### Payment options + +Receive payouts via: + +- Bank transfer +- PayPal + +You'll receive your first payment within 30 days of your first successful referral. + +--- + +## Best practices for affiliate success + +1. _Know your audience_: understand their pain points and recommend solutions that genuinely help them. Tailor your messaging to their technical level and needs. +1. _Be authentic_: promote tools you've used or understand. Personal experience builds trust and credibility. +1. _Provide context_: explain how Apify solves specific problems rather than just listing features. Use real examples and use cases. +1. _Follow up_: engage with people who click your links. Answer questions and provide additional resources to help them get started. +1. _Combine strategies_: use multiple channels to promote Apify. Cross-reference blog posts in videos, mention tutorials in newsletters, and share content on social media. +1. _Track what works_: monitor which content and channels drive the most conversions, then double down on what performs best. + +--- + +## Getting started + +To join the Apify Affiliate Program: + +1. Sign up through the [Apify Affiliate program page](https://apify.com/partners/affiliate) +1. Access your unique tracking links and promotional materials +1. Start sharing with your network +1. Monitor your referrals and earnings through the dashboard + +:::tip Maximize your impact + +Combine affiliate promotion with other marketing strategies covered in this guide, including SEO, social media, blogs, and video tutorials. The more touchpoints you create, the higher your conversion potential. + +::: diff --git a/sources/academy/build-and-publish/why_publish.md b/sources/academy/build-and-publish/why_publish.md index fa8c926c90..a8ba2fd658 100644 --- a/sources/academy/build-and-publish/why_publish.md +++ b/sources/academy/build-and-publish/why_publish.md @@ -1,9 +1,81 @@ --- title: Why publish Actors on Apify -description: +description: Discover how publishing Actors transforms your code into a revenue-generating product without traditional SaaS overhead. sidebar_position: 1 category: build-and-publish slug: /build-and-publish/why --- -This is placeholder. +Publishing Actors on Apify Store transforms your web scraping and automation code into revenue-generating products without the overhead of traditional SaaS development. + +--- + +## What you get when you publish on Apify + +When you publish your Actor on Apify Store, you eliminate the complexity of building and maintaining a traditional SaaS product. The platform handles infrastructure, billing, and distribution, so you can focus on your code. + +### Skip the SaaS overhead + +Your Actor gets its own dedicated landing page with built-in documentation hosting through README integration, giving you instant distribution with direct exposure to organic user traffic through Apify Store's marketplace. You won't pay hosting costs since the built-in cloud infrastructure with automatic scaling handles all compute needs. Payment infrastructure is completely handled for you with multiple payment options, automated billing, and transactions. + +### No infrastructure headaches + +Publishing on Apify Store means you don't need to purchase and manage domains or websites, build payment processing systems, set up hosting infrastructure, or handle customer billing manually. You also won't need to invest heavily in marketing since the marketplace presence drives discovery. + +## Choose your pricing options + +Apify Store offers flexible pricing models that let you match your Actor's value proposition: + +- Pay-per-event (PPE): Charge for any custom events your Actor triggers (maximum flexibility, AI/MCP compatible, priority store placement) +- Pay-per-result (PPR): Set pricing based on dataset items generated +(predictable costs for users, unlimited revenue potential) +- Rental: Charge a flat monthly fee for continuous access (users cover their own platform usage costs) + +All models give you 80% of revenue, with platform usage costs deducted for PPR and PPE models. + +Learn more in [How Actor monetization works](/academy/actor-marketing-playbook/store-basics/how-actor-monetization-works). + +## Why developers publish Actors + +### Generate passive income + +Developers successfully monetize their Actors through the Apify platform. Once published and promoted, Actors can generate recurring revenue with minimal maintenance. + +Check out their success stories: + +- [Caleb David (microworlds)](https://blog.apify.com/web-scraping-freelance-financial-freedom/) - Achieved financial freedom through Actor development. +- [Tugkan (epctex)](https://apify.com/success-stories/paid-actor-journey-apify-freelancer-tugkan) - Built a successful freelance career with paid Actors. + +### Build your portfolio + +Publishing Actors demonstrates your skills publicly. Your Actors become visible examples of your work, showcasing your technical expertise to potential clients while building your reputation in the developer community. This visibility can open freelance opportunities and establish you as a subject matter expert. + +### Join a marketplace + +Apify Store is a growing library of thousands of Actors, most created by community developers. When you publish, you reach users actively searching for automation solutions while benefiting from platform features like monitoring, scheduling, API access, and integrations. You get visibility through Store categories and search, plus access to analytics to understand user behavior and optimize pricing. + +## What it takes to succeed + +### Maintain quality + +Public Actors require higher standards than private ones. Since users depend on your Actor, you'll need to commit to regular maintenance—reserve approximately 2 hours per week for bug fixes, updates, and user support. Thorough documentation is essential; write clear README files using simple language since users may not be developers. Set up automated testing or use manual testing to prevent user issues, and respond promptly to issues through the Issues tab, where your response time is publicly visible. + +### When you need to change things + +If you need to make breaking changes to your Actor, contact [community@apify.com](mailto:community@apify.com) beforehand. Major pricing changes require 14-day notice and are limited to once per month. The platform helps communicate changes to your users. + +## Getting started + +Ready to publish? The process involves four main stages: + +1. Development: Build your Actor using Apify SDKs, Crawlee, or code templates +1. Publication: Set up display information, description, README, and +monetization +1. Testing: Ensure your Actor works reliably with automated or manual tests +1. Promotion: Optimize for SEO, share on social media, and create tutorials + +Learn more: + +- [How to build Actors](/academy/actor-marketing-playbook/store-basics/how-to-build-actors) +- [How Apify Store works](/academy/actor-marketing-playbook/store-basics/how-store-works) +- [Publish your Actor](/platform/actors/publishing/publish) From c533f38d934ea07679a1cd2002edbf877546df50 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Micha=C5=82=20Olender?= <92638966+TC-MO@users.noreply.github.com> Date: Tue, 28 Oct 2025 18:15:59 +0100 Subject: [PATCH 5/8] fix broken links --- .../academy/build-and-publish/actor-ideas/actor_validation.md | 2 +- .../how-to-build/how_to_create_a_great_input_schema.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/sources/academy/build-and-publish/actor-ideas/actor_validation.md b/sources/academy/build-and-publish/actor-ideas/actor_validation.md index 7a4fdebeee..3a2712cb74 100644 --- a/sources/academy/build-and-publish/actor-ideas/actor_validation.md +++ b/sources/academy/build-and-publish/actor-ideas/actor_validation.md @@ -102,7 +102,7 @@ site:x.com extracting data from LinkedIn ### Hacker News and niche forums -Platforms like [Hacker News](news.ycombinator.com) often have discussions on tech pain points and new tool launches. Search for keywords like _scrape Airbnb data_ to see if people have shown interest or if someone launched a similar tool and what the reaction was. +Platforms like [Hacker News](https://news.ycombinator.com/) often have discussions on tech pain points and new tool launches. Search for keywords like _scrape Airbnb data_ to see if people have shown interest or if someone launched a similar tool and what the reaction was. Use the `site:` parameter: diff --git a/sources/academy/build-and-publish/how-to-build/how_to_create_a_great_input_schema.md b/sources/academy/build-and-publish/how-to-build/how_to_create_a_great_input_schema.md index 0cc5bb10f2..892c30b49a 100644 --- a/sources/academy/build-and-publish/how-to-build/how_to_create_a_great_input_schema.md +++ b/sources/academy/build-and-publish/how-to-build/how_to_create_a_great_input_schema.md @@ -120,7 +120,7 @@ Unfortunately, when it comes to UX, there's only so much you can achieve armed w :::tip -Read more on the use of emojis: [Actors and emojis](academy/actor-marketing-playbook/actor-basics/actors-and-emojis) +Read more on the use of emojis: [Actors and emojis](/academy/actor-marketing-playbook/actor-basics/actors-and-emojis) ::: From e0b8fc5d45d40e0c496a75d17f8354a2b05b463f Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Micha=C5=82=20Olender?= <92638966+TC-MO@users.noreply.github.com> Date: Tue, 28 Oct 2025 18:30:14 +0100 Subject: [PATCH 6/8] reshuffle monetization models to put PPE first --- .../how_actor_monetization_works.md | 68 +++++++++---------- 1 file changed, 34 insertions(+), 34 deletions(-) diff --git a/sources/academy/build-and-publish/apify-store-basics/how_actor_monetization_works.md b/sources/academy/build-and-publish/apify-store-basics/how_actor_monetization_works.md index 4df5941a77..f1fa357017 100644 --- a/sources/academy/build-and-publish/apify-store-basics/how_actor_monetization_works.md +++ b/sources/academy/build-and-publish/apify-store-basics/how_actor_monetization_works.md @@ -23,19 +23,35 @@ Monetizing your Actor on the Apify platform involves several key steps: ## Monetization models -### Rental pricing model +### Pay-per-event pricing model -![rental model example](images/rental-model.png) +![pay per event model example](images/ppe-model.png) -- _How it works_: you offer a free trial period and set a monthly fee. Users on Apify paid plans can continue using the Actor after the trial. You earn 80% of the monthly rental fees. -- _Example_: you set a 7-day free trial and $30/month rental. If 3 users start using your Actor: - - 1st user on a paid plan pays $30 after the trial (you earn $24). - - 2nd user starts their trial but pays next month. - - 3rd user on a free plan finishes the trial without upgrading to a paid plan and can’t use the Actor further. +- _How it works_: you charge users based on specific events triggered programmatically by your Actor's code. You earn 80% of the revenue minus platform usage costs. +- - _Profit calculation_: `profit = (0.8 * revenue) - platform usage costs` +- _Event cost example_: you set the following events for your Actor: + - `Actor start per 1 GB of memory` at $0.005 + - `Pages scraped` at $0.002 + - `Page opened with residential proxy` at $0.002 - this is on top of `Pages scraped` + - `Page opened with a browser` at $0.002 - this is on top of `Pages scraped` +- _Example_: + - User A: + - Started the Actor 10 times = $0.05 + - Scraped 1,000 pages = $2.00 + - 500 of those were scraped using residential proxy = $1.00 + - 300 of those were scraped using browser = $0.60 + - This comes up to $3.65 of total revenue + - User B: + - Started the Actor 5 times = $0.025 + - Scraped 500 pages = $1.00 + - 200 of those were scraped using residential proxy = $0.40 + - 100 of those were scraped using browser = $0.20 + - This comes up to $1.625 of total revenue + - That means if platform usage costs are $0.365 for user A and $0.162 for user B your profit is $4.748 -:::info Rental pricing details +:::info Pay-per-event details -If you want more details about rental pricing, refer to our [rental pricing documentation](/platform/actors/publishing/monetize/rental). +If you want more details about PPE pricing, refer to our [PPE documentation](/platform/actors/publishing/monetize/pay-per-event). ::: @@ -59,35 +75,19 @@ If you want more details about PPR pricing, refer to our [PPR documentation](/pl ::: -### Pay-per-event pricing model +### Rental pricing model -![pay per event model example](images/ppe-model.png) +![rental model example](images/rental-model.png) -- _How it works_: you charge users based on specific events triggered programmatically by your Actor's code. You earn 80% of the revenue minus platform usage costs. -- - _Profit calculation_: `profit = (0.8 * revenue) - platform usage costs` -- _Event cost example_: you set the following events for your Actor: - - `Actor start per 1 GB of memory` at $0.005 - - `Pages scraped` at $0.002 - - `Page opened with residential proxy` at $0.002 - this is on top of `Pages scraped` - - `Page opened with a browser` at $0.002 - this is on top of `Pages scraped` -- _Example_: - - User A: - - Started the Actor 10 times = $0.05 - - Scraped 1,000 pages = $2.00 - - 500 of those were scraped using residential proxy = $1.00 - - 300 of those were scraped using browser = $0.60 - - This comes up to $3.65 of total revenue - - User B: - - Started the Actor 5 times = $0.025 - - Scraped 500 pages = $1.00 - - 200 of those were scraped using residential proxy = $0.40 - - 100 of those were scraped using browser = $0.20 - - This comes up to $1.625 of total revenue - - That means if platform usage costs are $0.365 for user A and $0.162 for user B your profit is $4.748 +- _How it works_: you offer a free trial period and set a monthly fee. Users on Apify paid plans can continue using the Actor after the trial. You earn 80% of the monthly rental fees. +- _Example_: you set a 7-day free trial and $30/month rental. If 3 users start using your Actor: + - 1st user on a paid plan pays $30 after the trial (you earn $24). + - 2nd user starts their trial but pays next month. + - 3rd user on a free plan finishes the trial without upgrading to a paid plan and can’t use the Actor further. -:::info Pay-per-event details +:::info Rental pricing details -If you want more details about PPE pricing, refer to our [PPE documentation](/platform/actors/publishing/monetize/pay-per-event). +If you want more details about rental pricing, refer to our [rental pricing documentation](/platform/actors/publishing/monetize/rental). ::: From 173c62f652d98c21d8e0eaa3d2d1727904a0f483 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Micha=C5=82=20Olender?= <92638966+TC-MO@users.noreply.github.com> Date: Wed, 29 Oct 2025 02:19:00 +0100 Subject: [PATCH 7/8] docs: update links add links to scrapers from Apify Store add link to Actor quality score docs --- .../actor-ideas/what_software_an_actor_can_be.md | 8 ++++---- sources/academy/build-and-publish/why_publish.md | 2 +- 2 files changed, 5 insertions(+), 5 deletions(-) diff --git a/sources/academy/build-and-publish/actor-ideas/what_software_an_actor_can_be.md b/sources/academy/build-and-publish/actor-ideas/what_software_an_actor_can_be.md index 54c86abfe3..978543e188 100644 --- a/sources/academy/build-and-publish/actor-ideas/what_software_an_actor_can_be.md +++ b/sources/academy/build-and-publish/actor-ideas/what_software_an_actor_can_be.md @@ -20,10 +20,10 @@ The most common type of Actor extracts data from websites. These Actors navigate Examples: -- Site-specific scrapers (Amazon Product Scraper, LinkedIn Profile Scraper) -- Search engine scrapers (Google Search Results, Bing Search) -- Social media scrapers (X/Twitter Scraper, Instagram Scraper) -- E-commerce data extractors (Shopify Store Scraper, eBay Price Monitor) +- Site-specific scrapers ([Amazon Product Scraper](https://apify.com/junglee/amazon-crawler), [LinkedIn Profile Scraper](https://apify.com/curious_coder/linkedin-profile-scraper)) +- Search engine scrapers ([Google Search Results](https://apify.com/apify/google-search-scraper), [Bing Search](https://apify.com/curious_coder/bing-search-scraper)) +- Social media scrapers ([X/Twitter Scraper](https://apify.com/apidojo/twitter-scraper-lite), [Instagram Scraper](https://apify.com/apify/instagram-scraper)) +- E-commerce data extractors ([Shopify Store Scraper](https://apify.com/autofacts/shopify), [eBay Price Monitor](https://apify.com/dtrungtin/ebay-items-scraper)) ### SaaS API wrappers diff --git a/sources/academy/build-and-publish/why_publish.md b/sources/academy/build-and-publish/why_publish.md index a8ba2fd658..9b655653da 100644 --- a/sources/academy/build-and-publish/why_publish.md +++ b/sources/academy/build-and-publish/why_publish.md @@ -58,7 +58,7 @@ Apify Store is a growing library of thousands of Actors, most created by communi ### Maintain quality -Public Actors require higher standards than private ones. Since users depend on your Actor, you'll need to commit to regular maintenance—reserve approximately 2 hours per week for bug fixes, updates, and user support. Thorough documentation is essential; write clear README files using simple language since users may not be developers. Set up automated testing or use manual testing to prevent user issues, and respond promptly to issues through the Issues tab, where your response time is publicly visible. +Public Actors require higher standards than private ones. Since users depend on your Actor, you'll need to commit to regular maintenance—reserve approximately 2 hours per week for bug fixes, updates, and user support. Thorough documentation is essential; write clear README files using simple language since users may not be developers. Set up automated testing or use manual testing to prevent user issues, and respond promptly to issues through the Issues tab, where your response time is publicly visible. Learn more about metrics determining quality in [Actor quality score documentation](/platform/actors/publishing/quality-score). ### When you need to change things From dc22480ea0497e9db58a96d71489b2c1609d5956 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Micha=C5=82=20Olender?= <92638966+TC-MO@users.noreply.github.com> Date: Wed, 29 Oct 2025 18:24:03 +0100 Subject: [PATCH 8/8] add links --- sources/academy/build-and-publish/why_publish.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/sources/academy/build-and-publish/why_publish.md b/sources/academy/build-and-publish/why_publish.md index 9b655653da..7774cee15f 100644 --- a/sources/academy/build-and-publish/why_publish.md +++ b/sources/academy/build-and-publish/why_publish.md @@ -68,7 +68,7 @@ If you need to make breaking changes to your Actor, contact [community@apify.com Ready to publish? The process involves four main stages: -1. Development: Build your Actor using Apify SDKs, Crawlee, or code templates +1. Development: Build your Actor using [Apify SDKs](https://docs.apify.com/sdk), [Crawlee](https://crawlee.dev/), or [Actor templates](https://apify.com/templates) 1. Publication: Set up display information, description, README, and monetization 1. Testing: Ensure your Actor works reliably with automated or manual tests