SEO for actors

Learn how to optimize your actors' title, description and README to get more relevant visits from Google and other search engines.

Jan Čurn avatar
Written by Jan Čurn
Updated over a week ago

The actor details page in the Apify Store provide a great way how to promote your actor to users of search engines like Google. The goal is to attract all people searching for a specific problem that your actor solves, such as "Kickstarter API" or "Amazon crawler". This article provides some basic information about Search Engine Optimization (SEO) for your actors.

The golden rule of SEO: Create a quality content that provides value and engagement to your users. Don't over-optimize SEO, otherwise you risk being penalized by Google.

Think of it this way: your content, URLs, keywords, titles, links etc. determine to what kind of search queries your page is shown, and the quality of the content determines how high it ranks in those results. For example, if you over-optimize your URLs and title to rank higher in results for high-volume queries, but most people who visit your page immediately bounce, Google notices, penalizes you and your pages sinks in the results. On the other hand, it you address very precisely a niche segment of users who will benefit from your actor, people who open it use your actor, then Google will love it and push it up in results. Read more about basics of content marketing.

Here’s are our tips for better SEO of various actor properties:


The actor name is a developer-style name of your actor, which is prefixed by your username (e.g. jancurn/find-broken-links). The name is used to generate a URL of your actor (e.g., and thus it is an important signal for search engines. However, the name should also be readable and clear enough, so that people using your actor can understand what it does just from the name.


The actor title provides a human-readable name of your actor. This title is the most important real estate from SEO standpoint, and it should exactly match the most likely search query that potential users of your actor will use, while giving a clear name to your actor for people who will use it every day. So if you’re working on an "Amazon crawler", you should use these words in the name of the actor. 

YES: Amazon crawler, Google Places API, Kickstarter search
NO: Crawler for Amazon, API for Google places, Search in Kickstarter


The actor description should contain a concise but precise description of what your actor does, targeted for people who are deciding whether to use it or not. Go straight to the point and avoid any boilerplate text.

YES: Crawls and extracts ...
NO: This actor crawls in order to extract ...

The description is used by search engines to understand what the actor is about, so it should contain some of the most popular variations and derivations of the Title, including things people might search for. If you’re not sure about similar phrases, check out the Google suggest tool in the search and it will show you some hints and tips. Of course, the description should primarily be about what the actor does, but it’s always a good idea to enrich the text with popular keywords.

YES: This Amazon bot will help, whereas the Amazon API won’t. Use the crawler...
NO: This crawler will search through results in Amazon and offers you...


The README․md file represents a complete description how to use the actor, intended for its users. If your actor users are technical folks, then you can be more technical in README, if it's for non-tech folks, then be less technical.

You have lots of room in the README for SEO optimization, without compromising readability for your users. Make sure the text includes other variants of what potential users of your actor might search for. A good place for these is in the captions and headlines, but keywords in the body text will also help. It’s also a good idea to repeat the name of the actor several times.

YES: You can use this Amazon Crawler with your code (Python, PHP, Java) to crawl Amazon without the API...
NO: Follow the instructions in the Readme and if you have any comments, see the FAQ section...

Another important thing for SEO is internal and external linking, so don’t be shy and put in links to similar actors to your README, any interesting article in Apify Help which could help your users. If your actor is scraping certain website, make sure to add a link to that website. If the actor is using some external library, make sure to link its page.

If you’ve created other actors, it’s completely fine to pop in a promo for them in the end. It’s even better if you edit your old actors and put in a link to your new actor. We’ll take care of extra promotion on the Apify Homepage or Apify Store - especially if you’ve done a great job of describing your actors!

YES: Like my Amazon Crawler? See my Amazon Review Crawler.
NO: No links.

Sharing is caring

Now that you’ve created a cool new actor, let others see it! Share it to your personal Twitter, Facebook, Reddit or any other social platform. Always provide a link with the name of the actor. Use #hashtags on Twitter to catch attention. Provide a small “why is this good” when sharing inside any group discussions. We will promote your actor sooner or later, but more links means more attention from Google from the beginning.

YES: Need to crawl #Amazon or #Yelp? See my Amazon crawler https://...
NO: I just created something, check it out on Apify...
Did this answer your question?