add new content

TC-MO · TC-MO · commit 3fbb2ea62da8 · 2025-10-28T12:27:06.000+01:00
Remove placeholder content
Add new content
Fix formatting
Add new positions to accept.txt
diff --git 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
@@ -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
@@ -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
@@ -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
@@ -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
diff --git a/sources/academy/build-and-publish/why_publish.md b/sources/academy/build-and-publish/why_publish.md
