apify · patrikbraborec · Feb 10, 2026 · Feb 10, 2026
diff --git a/README.md b/README.md
@@ -159,7 +159,7 @@ To create and run Actors through Apify Console,
 see the [Console documentation](https://docs.apify.com/academy/getting-started/creating-actors#choose-your-template).
 
 To create and run Python Actors locally, check the documentation for
-[how to create and run Python Actors locally](https://docs.apify.com/sdk/python/docs/overview/running-locally).
+[how to create and run Python Actors locally](https://docs.apify.com/sdk/python/docs/quick-start).
 
 ## Guides
 

diff --git a/docs/01_overview/code/01_introduction.py → docs/01_introduction/code/01_introduction.py b/docs/01_overview/code/01_introduction.py → docs/01_introduction/code/01_introduction.py
diff --git a/...overview/code/actor_structure/__init__.py → ...oduction/code/actor_structure/__init__.py b/...overview/code/actor_structure/__init__.py → ...oduction/code/actor_structure/__init__.py
diff --git a/...overview/code/actor_structure/__main__.py → ...oduction/code/actor_structure/__main__.py b/...overview/code/actor_structure/__main__.py → ...oduction/code/actor_structure/__main__.py
diff --git a/.../01_overview/code/actor_structure/main.py → ...introduction/code/actor_structure/main.py b/.../01_overview/code/actor_structure/main.py → ...introduction/code/actor_structure/main.py
diff --git a/...01_overview/code/actor_structure/py.typed → ...ntroduction/code/actor_structure/py.typed b/...01_overview/code/actor_structure/py.typed → ...ntroduction/code/actor_structure/py.typed
diff --git a/docs/01_overview/images/apify-create.gif → docs/01_introduction/images/apify-create.gif b/docs/01_overview/images/apify-create.gif → docs/01_introduction/images/apify-create.gif
diff --git a/docs/01_introduction/index.mdx b/docs/01_introduction/index.mdx
@@ -0,0 +1,44 @@
+---
+id: introduction
+title: Apify SDK for Python
+sidebar_label: Overview
+slug: /overview
+description: 'The official library for creating Apify Actors in Python, providing tools for web scraping, automation, and data storage integration.'
+---
+
+The Apify SDK for Python is the official library for creating [Apify Actors](https://docs.apify.com/platform/actors) using Python. It provides useful features like Actor lifecycle management, local storage emulation, and Actor event handling.
+
+```python
+from apify import Actor
+
+async def main():
+    async with Actor:
+        actor_input = await Actor.get_input()
+        print(actor_input)
+```
+
+## What are Actors
+
+Actors are serverless cloud programs capable of performing tasks in a web browser, similar to what a human can do. These tasks can range from simple operations, such as filling out forms or unsubscribing from services, to complex jobs like scraping and processing large numbers of web pages.
+
+Actors can be executed locally or on the [Apify platform](https://docs.apify.com/platform). The Apify platform lets you run Actors at scale and provides features for monitoring, scheduling, publishing, and monetizing them.
+
+## Quick start
+
+To create and run Actors using Apify Console, check out [Apify Console documentation](https://docs.apify.com/platform/console). For creating and running Python Actors locally, refer to the [quick start guide](./quick-start).
+
+Explore the Guides section in the sidebar to see more of the SDK in action and for a deeper understanding of the SDK's features and best practices.
+
+## Installation
+
+The Apify SDK for Python is typically installed when you create a new Actor project using the [Apify CLI](https://docs.apify.com/cli). To install it manually in an existing project, use:
+
+```bash
+pip install apify
+```
+
+:::note API client alternative
+
+If you need to interact with the Apify API programmatically without creating Actors, use the [Apify API client for Python](https://docs.apify.com/api/client/python) instead.
+
+:::
diff --git a/docs/01_overview/index.mdx → docs/01_introduction/quick-start.mdx b/docs/01_overview/index.mdx → docs/01_introduction/quick-start.mdx
@@ -1,47 +1,19 @@
 ---
-title: Overview
-sidebar_label: Overview
+id: quick-start
+title: Quick start
+sidebar_label: Quick start
+description: 'Get started with the Apify SDK for Python by creating your first Actor and learning the basics.'
+---
+
+Learn how to create and run Actors using the Apify SDK for Python.
+
 ---
 
 import Tabs from '@theme/Tabs';
 import TabItem from '@theme/TabItem';
 import CodeBlock from '@theme/CodeBlock';
 
-The Apify SDK for Python is the official library for creating [Apify Actors](https://docs.apify.com/platform/actors) in Python.
-
-```py
-from apify import Actor
-from bs4 import BeautifulSoup
-import requests
-
-async def main():
-    async with Actor:
-        input = await Actor.get_input()
-        response = requests.get(input['url'])
-        soup = BeautifulSoup(response.content, 'html.parser')
-        await Actor.push_data({ 'url': input['url'], 'title': soup.title.string })
-```
-
-## Requirements
-
-The Apify SDK requires Python version 3.10 or above to run Python Actors locally.
-
-## Installation
-
-The Apify Python SDK is available as [`apify`](https://pypi.org/project/apify/) package on PyPi. To install it, run:
-
-```bash
-pip install apify
-```
-
-When you create an Actor using the Apify CLI, the Apify SDK for Python is installed for you automatically.
-
-If you are not developing Apify Actors and you just need to access the Apify API from Python,
-consider using the [Apify API client for Python](/api/client/python) directly.
-
-## Quick start
-
-### Creating Actors
+## Step 1: Creating Actors
 
 To create and run Actors in Apify Console, refer to the [Console documentation](/platform/actors/development/quick-start/web-ide).
 
@@ -55,9 +27,9 @@ apify create my-first-actor --template python-start
 
 This will create a new folder called `my-first-actor`, download and extract the "Getting started with Python" Actor template there, create a virtual environment in `my-first-actor/.venv`, and install the Actor dependencies in it.
 
-![actor create command run](../01_overview/images/apify-create.gif)
+![actor create command run](./images/apify-create.gif)
 
-#### Running the Actor
+## Step 2: Running the Actor
 
 To run the Actor, you can use the [`apify run` command](/cli/docs/reference#apify-run):
 
@@ -74,7 +46,7 @@ This command:
 
 The Actor input, for example, will be in `storage/key_value_stores/default/INPUT.json`.
 
-## Actor structure
+## Step 3: Understanding Actor structure
 
 All Python Actor templates follow the same structure.
 
@@ -122,31 +94,6 @@ asyncio.run(main())`
 If you want to modify the Actor structure, you need to make sure that your Actor is executable as a module, via `python -m src`, as that is the command started by `apify run` in the Apify CLI.
 We recommend keeping the entrypoint for the Actor in the `src/__main__.py` file.
 
-## Adding dependencies
-
-First, add the dependencies in the [`requirements.txt`](https://pip.pypa.io/en/stable/reference/requirements-file-format/) file in the Actor source folder.
-
-Then activate the virtual environment in `.venv`:
-
-<Tabs groupId="operating-systems">
-    <TabItem value="unix" label="Linux / macOS" default>
-        <CodeBlock language="bash">{
-`source .venv/bin/activate`
-        }</CodeBlock>
-    </TabItem>
-    <TabItem value="win" label="Windows">
-        <CodeBlock language="powershell">{
-`.venv\\Scripts\\activate`
-        }</CodeBlock>
-    </TabItem>
-</Tabs>
-
-Finally, install the dependencies:
-
-```bash
-python -m pip install -r requirements.txt
-```
-
 ## Next steps
 
 ### Guides

diff --git a/docs/02_concepts/10_logging.mdx → docs/02_concepts/09_logging.mdx b/docs/02_concepts/10_logging.mdx → docs/02_concepts/09_logging.mdx
@@ -5,10 +5,10 @@ title: Logging
 
 import RunnableCodeBlock from '@site/src/components/RunnableCodeBlock';
 
-import LogConfigExample from '!!raw-loader!roa-loader!./code/10_log_config.py';
-import LoggerUsageExample from '!!raw-loader!roa-loader!./code/10_logger_usage.py';
-import RedirectLog from '!!raw-loader!roa-loader!./code/10_redirect_log.py';
-import RedirectLogExistingRun from '!!raw-loader!roa-loader!./code/10_redirect_log_existing_run.py';
+import LogConfigExample from '!!raw-loader!roa-loader!./code/09_log_config.py';
+import LoggerUsageExample from '!!raw-loader!roa-loader!./code/09_logger_usage.py';
+import RedirectLog from '!!raw-loader!roa-loader!./code/09_redirect_log.py';
+import RedirectLogExistingRun from '!!raw-loader!roa-loader!./code/09_redirect_log_existing_run.py';
 
 The Apify SDK is logging useful information through the [`logging`](https://docs.python.org/3/library/logging.html) module from Python's standard library, into the logger with the name `apify`.
 

diff --git a/docs/02_concepts/11_configuration.mdx → docs/02_concepts/10_configuration.mdx b/docs/02_concepts/11_configuration.mdx → docs/02_concepts/10_configuration.mdx
@@ -5,7 +5,7 @@ title: Actor configuration
 
 import RunnableCodeBlock from '@site/src/components/RunnableCodeBlock';
 
-import ConfigExample from '!!raw-loader!roa-loader!./code/11_config.py';
+import ConfigExample from '!!raw-loader!roa-loader!./code/10_config.py';
 
 The [`Actor`](../../reference/class/Actor) class gets configured using the [`Configuration`](../../reference/class/Configuration) class, which initializes itself based on the provided environment variables.
 

diff --git a/docs/02_concepts/12_pay_per_event.mdx → docs/02_concepts/11_pay_per_event.mdx b/docs/02_concepts/12_pay_per_event.mdx → docs/02_concepts/11_pay_per_event.mdx
@@ -4,8 +4,8 @@ title: Pay-per-event monetization
 description: Monetize your Actors using the pay-per-event pricing model
 ---
 
-import ActorChargeSource from '!!raw-loader!roa-loader!./code/12_actor_charge.py';
-import ConditionalActorChargeSource from '!!raw-loader!roa-loader!./code/12_conditional_actor_charge.py';
+import ActorChargeSource from '!!raw-loader!roa-loader!./code/11_actor_charge.py';
+import ConditionalActorChargeSource from '!!raw-loader!roa-loader!./code/11_conditional_actor_charge.py';
 import ApiLink from '@site/src/components/ApiLink';
 import RunnableCodeBlock from '@site/src/components/RunnableCodeBlock';
 

diff --git a/docs/02_concepts/code/10_log_config.py → docs/02_concepts/code/09_log_config.py b/docs/02_concepts/code/10_log_config.py → docs/02_concepts/code/09_log_config.py
diff --git a/docs/02_concepts/code/10_logger_usage.py → docs/02_concepts/code/09_logger_usage.py b/docs/02_concepts/code/10_logger_usage.py → docs/02_concepts/code/09_logger_usage.py
diff --git a/docs/02_concepts/code/10_redirect_log.py → docs/02_concepts/code/09_redirect_log.py b/docs/02_concepts/code/10_redirect_log.py → docs/02_concepts/code/09_redirect_log.py
diff --git a/...epts/code/10_redirect_log_existing_run.py → ...epts/code/09_redirect_log_existing_run.py b/...epts/code/10_redirect_log_existing_run.py → ...epts/code/09_redirect_log_existing_run.py
diff --git a/docs/02_concepts/code/11_config.py → docs/02_concepts/code/10_config.py b/docs/02_concepts/code/11_config.py → docs/02_concepts/code/10_config.py
diff --git a/docs/02_concepts/code/12_actor_charge.py → docs/02_concepts/code/11_actor_charge.py b/docs/02_concepts/code/12_actor_charge.py → docs/02_concepts/code/11_actor_charge.py
diff --git a/...cepts/code/12_conditional_actor_charge.py → ...cepts/code/11_conditional_actor_charge.py b/...cepts/code/12_conditional_actor_charge.py → ...cepts/code/11_conditional_actor_charge.py
diff --git a/docs/02_concepts/09_running_webserver.mdx → docs/03_guides/07_running_webserver.mdx b/docs/02_concepts/09_running_webserver.mdx → docs/03_guides/07_running_webserver.mdx
@@ -5,7 +5,7 @@ title: Running webserver in your Actor
 
 import RunnableCodeBlock from '@site/src/components/RunnableCodeBlock';
 
-import WebserverExample from '!!raw-loader!roa-loader!./code/09_webserver.py';
+import WebserverExample from '!!raw-loader!roa-loader!./code/07_webserver.py';
 
 Each Actor run on the Apify platform is assigned a unique hard-to-guess URL (for example `https://8segt5i81sokzm.runs.apify.net`), which enables HTTP access to an optional web server running inside the Actor run's container.
 

diff --git a/docs/02_concepts/code/09_webserver.py → docs/03_guides/code/07_webserver.py b/docs/02_concepts/code/09_webserver.py → docs/03_guides/code/07_webserver.py
diff --git a/pyproject.toml b/pyproject.toml
@@ -56,7 +56,7 @@ scrapy = ["scrapy>=2.11.0"]
 "Apify Homepage" = "https://apify.com"
 "Changelog" = "https://docs.apify.com/sdk/python/docs/changelog"
 "Discord" = "https://discord.com/invite/jyEM2PRvMU"
-"Documentation" = "https://docs.apify.com/sdk/python/docs/overview/introduction"
+"Documentation" = "https://docs.apify.com/sdk/python/docs/overview"
 "Homepage" = "https://docs.apify.com/sdk/python/"
 "Issue Tracker" = "https://github.com/apify/apify-sdk-python/issues"
 "Release Notes" = "https://docs.apify.com/sdk/python/docs/upgrading/upgrading-to-v2"

diff --git a/website/docusaurus.config.js b/website/docusaurus.config.js
@@ -66,7 +66,7 @@ module.exports = {
                     title: 'SDK for Python',
                     items: [
                         {
-                            to: 'docs/overview',
+                            to: 'docs/introduction',
                             label: 'Docs',
                             position: 'left',
                             activeBaseRegex: '/docs(?!/changelog)',

diff --git a/website/sidebars.js b/website/sidebars.js
@@ -2,7 +2,11 @@ module.exports = {
     sidebar: [
         {
             type: 'doc',
-            id: 'overview/index',
+            id: 'introduction/introduction',
+        },
+        {
+            type: 'doc',
+            id: 'introduction/quick-start',
         },
         {
             type: 'category',