From e5e1a89fe149756ca3987745559208c5e725a5cf Mon Sep 17 00:00:00 2001 From: Marcel Rebro Date: Mon, 14 Sep 2026 12:44:21 +0200 Subject: [PATCH 1/6] docs: add Apify glossary page linked from the footer Adds a single A-Z glossary of Apify-specific terms at /glossary. The page sits at the root of sources/platform/, outside every directory the sidebars autogenerate from, so it stays out of the page tree. It is reached from the Reference column in the footer instead. Scope is Apify-specific concepts plus the proxy family. Terms common to web scraping and software development in general are excluded. Each entry is one sentence that links to the page owning the concept, so the glossary routes rather than duplicates. Co-Authored-By: Claude Opus 5 (1M context) Claude-Session: https://claude.ai/code/session_01GmXAuRf1CPE7WyGTr3QR1T --- apify-docs-theme/src/config.js | 6 ++ docusaurus.config.js | 4 + sources/platform/glossary.md | 138 +++++++++++++++++++++++++++++++++ 3 files changed, 148 insertions(+) create mode 100644 sources/platform/glossary.md diff --git a/apify-docs-theme/src/config.js b/apify-docs-theme/src/config.js index 53697e07df..67a8b59255 100644 --- a/apify-docs-theme/src/config.js +++ b/apify-docs-theme/src/config.js @@ -265,6 +265,12 @@ const themeConfig = { target: '_self', rel: 'dofollow', }, + { + label: 'Glossary', + href: `${absoluteUrl}/glossary`, + target: '_self', + rel: 'dofollow', + }, ], }, { diff --git a/docusaurus.config.js b/docusaurus.config.js index a8c3d7cfe0..16debda673 100644 --- a/docusaurus.config.js +++ b/docusaurus.config.js @@ -357,6 +357,10 @@ module.exports = { route: '/platform/**', categoryName: 'Platform documentation', }, + { + route: '/glossary', + categoryName: 'Glossary', + }, ], // Expand and fix Prism code language tags before HTML→markdown conversion beforeDefaultRehypePlugins: [rehypeExpandTabs, rehypeFixCodeLanguage], diff --git a/sources/platform/glossary.md b/sources/platform/glossary.md new file mode 100644 index 0000000000..4502fd7706 --- /dev/null +++ b/sources/platform/glossary.md @@ -0,0 +1,138 @@ +--- +title: Glossary +description: Definitions of Apify-specific terms, from Actors and datasets to proxy types and pricing models, each linking to the page that covers it in full. +slug: /glossary +toc_max_heading_level: 2 +--- + +Short definitions of the terms used across Apify docs. Each entry links to the page that covers the concept in full. + +This page covers only what is specific to Apify, not the general vocabulary of web scraping and software development. + +## Actor + +An [Actor](/actors) is the core unit of the Apify platform: a serverless cloud program that performs a job on the web, such as automation, an AI task, or data extraction. + +## Actor run + +An [Actor run](/actors/running/runs-and-builds) is a single execution of an Actor, with its own container, allocated resources, and storage. + +## Actor Standby + +[Actor Standby](/actors/running/standby) is a mode that keeps an Actor ready in the background as an HTTP server, so it answers requests without a cold start on every call. + +## Actor task + +An [Actor task](/actors/running/tasks) is a saved, reusable input configuration for a specific Actor. + +## API token + +An [API token](/integrations/api) is a secret key tied to your Apify account that authenticates API requests and integrations. + +## Apify AGI + +[Apify AGI](https://agi.apify.com) (Agent General Interface) is the entry point for autonomous agents to use and pay for the platform and Actors through agentic payment protocols, without account setup or ongoing billing. + +## Apify AI + +[Apify AI](/account/apify-ai) is a conversational interface inside Apify Console for finding and running Actors in natural language, instead of keyword search. + +## Apify API + +The [Apify API](/api/v2) is the REST API for running Actors, managing storage, and controlling the platform programmatically. + +## Apify CLI + +The [Apify CLI](/cli) is the command-line tool for creating, running, and deploying Actors from your local machine. + +## Apify Console + +[Apify Console](/account/console) is the web application where you run and manage Actors, inspect storage, and handle billing. + +## Apify MCP server + +The [Apify MCP server](/integrations/mcp) exposes Actors as tools over the Model Context Protocol, so AI assistants and agents can discover and run them. + +## Apify Proxy + +[Apify Proxy](/proxy) routes requests through datacenter and residential IP addresses to reduce blocking. + +## Apify SDK + +The [Apify SDK](/sdk) is the JavaScript and Python toolkit for building Actors and working with the platform programmatically. + +## Apify Store + +[Apify Store](https://apify.com/store) is the marketplace of Actors for AI, automation, and data extraction. Anyone can publish an Actor there and earn when others use it. + +## Apify storage + +[Apify storage](/storage) is the platform's built-in storage, made up of datasets, key-value stores, and request queues. + +## Build + +A [build](/actors/development/builds-and-runs/builds) is a versioned Docker image compiled from an Actor's source code. A run executes a build. + +## Compute unit + +A [compute unit](/actors/running/usage-and-resources) (CU) is the platform's usage and billing unit, equal to 1 GB of memory running for one hour. + +## Crawlee + +[Crawlee](https://crawlee.dev) is Apify's open-source library for building web scrapers and browser automation in Node.js and Python. + +## Datacenter proxy + +A [datacenter proxy](/proxy/datacenter-proxy) is the fastest and cheapest proxy type, routing through datacenter IP addresses at a higher risk of blocking. + +## Dataset + +A [dataset](/storage/dataset) is append-only, table-like storage for an Actor's structured results, exportable to JSON, CSV, Excel, and other formats. + +## Google SERP proxy + +A [Google SERP proxy](/proxy/google-serp-proxy) is a proxy specialized for collecting localized Google search engine results pages at scale. + +## Input schema + +An [input schema](/actors/development/actor-definition/input-schema) is the JSON definition of an Actor's inputs. It generates the Actor's input form in Apify Console. + +## Key-value store + +A [key-value store](/storage/key-value-store) holds unstructured or auxiliary data, such as Actor input, files, screenshots, and images. + +## Pay-per-event + +[Pay-per-event](/actors/publishing/monetize/pay-per-event) (PPE) is a pricing model that charges users for specific events an Actor emits, such as each result or action, rather than for compute time. + +## Pay-per-usage + +[Pay-per-usage](/actors/publishing/monetize/pricing-and-costs) is a pricing model that charges users for the platform resources an Actor consumes, such as compute, storage, and proxy. + +## Quality score + +The [quality score](/actors/publishing/quality-score) rates how well a Store Actor meets Apify's quality criteria on a scale of 0 to 100, and influences its visibility in Apify Store. + +## Rental + +[Rental](/actors/publishing/monetize/rental) is a pricing model that charges users a flat monthly fee to use a paid Actor, after a free trial. + +## Request queue + +A [request queue](/storage/request-queue) holds the URLs to crawl, tracks their state, and enables resumable, deduplicated crawls. + +## Residential proxy + +A [residential proxy](/proxy/residential-proxy) routes requests through IP addresses of real home devices, making them the hardest to detect and block. + +## Schedule + +A [schedule](/actors/running/schedules) is a cron-based trigger that runs an Actor or task automatically at set intervals. + +## Webhook + +A [webhook](/integrations/webhooks) is an HTTP callback the platform sends when an Actor run changes state, used to connect Apify to external systems. + +## x402 + +[x402](/integrations/x402) is an agentic payment protocol the platform supports, so agents can pay per Actor call without an account or ongoing billing. From 5801b5783b54d153a2d2a70571f3556bc7e5c645 Mon Sep 17 00:00:00 2001 From: Marcel Rebro Date: Mon, 14 Sep 2026 18:05:12 +0200 Subject: [PATCH 2/6] docs: add four terms surfaced by the source audit Adds Output, output schema, MCP connectors, and MCP Proxy, taking the glossary to 36 terms. Output comes from the Sales Glossary, which defines it as its own concept; the page already defined input schema but neither output nor its schema. MCP connectors and MCP Proxy are both named as Apify terms in standards/terminology.md, which gives each its own casing rule, and MCP connectors has its own page. MCP Proxy has no page of its own - it is documented inline on the MCP connectors page, which is what its entry links to. Co-Authored-By: Claude Opus 5 (1M context) Claude-Session: https://claude.ai/code/session_01GmXAuRf1CPE7WyGTr3QR1T --- sources/platform/glossary.md | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) diff --git a/sources/platform/glossary.md b/sources/platform/glossary.md index 4502fd7706..cee3165a51 100644 --- a/sources/platform/glossary.md +++ b/sources/platform/glossary.md @@ -101,6 +101,22 @@ An [input schema](/actors/development/actor-definition/input-schema) is the JSON A [key-value store](/storage/key-value-store) holds unstructured or auxiliary data, such as Actor input, files, screenshots, and images. +## MCP connectors + +[MCP connectors](/integrations/mcp-connectors) let an Actor call third-party services, such as Notion, Slack, and GitHub, over the Model Context Protocol using credentials you authorize once in your account settings. They work in the opposite direction to the Apify MCP server, which exposes Actors to outside AI clients. + +## MCP Proxy + +The [Apify MCP Proxy](/integrations/mcp-connectors) is the platform component an Actor reaches its MCP connectors through. It validates each request, injects your stored credentials server-side, and forwards it to the upstream MCP server, so the credentials never enter the Actor. + +## Output + +[Output](/actors/running/input-and-output) is the data an Actor run produces. It's stored in the run's dataset and key-value store, and readable from Apify Console or the API. + +## Output schema + +An [output schema](/actors/development/actor-definition/output-schema) declares where an Actor stores its results and how Apify Console and the run API endpoint present them. Publishing an Actor to Apify Store requires one. + ## Pay-per-event [Pay-per-event](/actors/publishing/monetize/pay-per-event) (PPE) is a pricing model that charges users for specific events an Actor emits, such as each result or action, rather than for compute time. From a28bffcc472958707ddd6c7ded18ef8e677f7ebc Mon Sep 17 00:00:00 2001 From: Marcel Rebro Date: Mon, 14 Sep 2026 18:10:47 +0200 Subject: [PATCH 3/6] docs: mark the rental pricing model as retiring The monetization index lists only two current pricing models, pay per event and pay per usage. Rental survives as a page carrying a sunset caution: new rental Actors stopped on April 1, 2026, and the remaining ones migrate to pay-per-usage on October 1, 2026. The entry presented rental as a live model alongside the other two. It now states the retirement and the migration target. Co-Authored-By: Claude Opus 5 (1M context) Claude-Session: https://claude.ai/code/session_01GmXAuRf1CPE7WyGTr3QR1T --- sources/platform/glossary.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/sources/platform/glossary.md b/sources/platform/glossary.md index cee3165a51..66c7dbe761 100644 --- a/sources/platform/glossary.md +++ b/sources/platform/glossary.md @@ -131,7 +131,7 @@ The [quality score](/actors/publishing/quality-score) rates how well a Store Act ## Rental -[Rental](/actors/publishing/monetize/rental) is a pricing model that charges users a flat monthly fee to use a paid Actor, after a free trial. +[Rental](/actors/publishing/monetize/rental) is a retiring pricing model that charges users a flat monthly fee after a free trial. Publishing new rental Actors stopped on April 1, 2026, and on October 1, 2026 the remaining ones move to pay-per-usage. ## Request queue From d07f198209459b6270ebede22a867fc3215cc76e Mon Sep 17 00:00:00 2001 From: Marcel Rebro Date: Mon, 14 Sep 2026 18:24:08 +0200 Subject: [PATCH 4/6] docs: expand each glossary entry with what the term does Each entry now carries a second sentence describing what the term does in practice, and cross-links the concepts it touches, so a reader can move between related terms without going back to the sidebar. Definitions are drawn from each target page so the glossary stays consistent with the page that owns the concept. Co-Authored-By: Claude Opus 5 (1M context) Claude-Session: https://claude.ai/code/session_01GmXAuRf1CPE7WyGTr3QR1T --- sources/platform/glossary.md | 70 ++++++++++++++++++------------------ 1 file changed, 35 insertions(+), 35 deletions(-) diff --git a/sources/platform/glossary.md b/sources/platform/glossary.md index 66c7dbe761..1022b3ed02 100644 --- a/sources/platform/glossary.md +++ b/sources/platform/glossary.md @@ -11,99 +11,99 @@ This page covers only what is specific to Apify, not the general vocabulary of w ## Actor -An [Actor](/actors) is the core unit of the Apify platform: a serverless cloud program that performs a job on the web, such as automation, an AI task, or data extraction. +An [Actor](/actors) is the core unit of the Apify platform: a serverless cloud program that performs a job on the web, such as automation, an AI task, or data extraction. You [build](/actors/development) it from your own code, run it from [Apify Console](/account/console), the [API](/integrations/api), or a [schedule](/actors/running/schedules), and can [publish](/actors/publishing) it to [Apify Store](https://apify.com/store) to earn from it. ## Actor run -An [Actor run](/actors/running/runs-and-builds) is a single execution of an Actor, with its own container, allocated resources, and storage. +An [Actor run](/actors/running/runs-and-builds) is a single execution of an Actor, with its own container, allocated resources, and storage. Each run is assigned a [dataset](/storage/dataset), a [key-value store](/storage/key-value-store), and a [request queue](/storage/request-queue), and moves through a lifecycle from ready to succeeded, failed, timed out, or aborted. ## Actor Standby -[Actor Standby](/actors/running/standby) is a mode that keeps an Actor ready in the background as an HTTP server, so it answers requests without a cold start on every call. +[Actor Standby](/actors/running/standby) is a mode that keeps an Actor ready in the background as an HTTP server. It answers requests in real time instead of paying a cold start on every call, which suits Actors used as live endpoints rather than batch jobs. ## Actor task -An [Actor task](/actors/running/tasks) is a saved, reusable input configuration for a specific Actor. +An [Actor task](/actors/running/tasks) is a saved, reusable input configuration for a specific Actor. It lets you rerun the same Actor with preset inputs from a [schedule](/actors/running/schedules), the [API](/integrations/api), or [Apify Console](/account/console), without reconfiguring it each time. ## API token -An [API token](/integrations/api) is a secret key tied to your Apify account that authenticates API requests and integrations. +An [API token](/integrations/api) is a secret key tied to your Apify account that authenticates API requests and integrations. It identifies you to the [Apify API](/api/v2), the [Apify CLI](/cli), and the client libraries, and carries your account's permissions. ## Apify AGI -[Apify AGI](https://agi.apify.com) (Agent General Interface) is the entry point for autonomous agents to use and pay for the platform and Actors through agentic payment protocols, without account setup or ongoing billing. +[Apify AGI](https://agi.apify.com) (Agent General Interface) is the entry point for autonomous agents to use and pay for the platform and Actors. Agents reach it through agentic payment protocols such as [x402](/integrations/x402), so they can run Actors without account setup or ongoing billing. ## Apify AI -[Apify AI](/account/apify-ai) is a conversational interface inside Apify Console for finding and running Actors in natural language, instead of keyword search. +[Apify AI](/account/apify-ai) is a conversational interface inside Apify Console for finding and running Actors in natural language, instead of keyword search. It runs on the same search and execution backend as [Apify Store](https://apify.com/store) search and the [Apify MCP server](/integrations/mcp). ## Apify API -The [Apify API](/api/v2) is the REST API for running Actors, managing storage, and controlling the platform programmatically. +The [Apify API](/api/v2) is the REST API for running Actors, managing storage, and controlling the platform programmatically. It's the basis for the [client libraries](/integrations/api), the [CLI](/cli), and most [integrations](/integrations), and authenticates with an [API token](#api-token). ## Apify CLI -The [Apify CLI](/cli) is the command-line tool for creating, running, and deploying Actors from your local machine. +The [Apify CLI](/cli) is the command-line tool for creating, running, and deploying Actors from your local machine. Use it to scaffold an Actor from a template, run it locally against local storage, and [deploy](/actors/development/deployment) it to the platform. ## Apify Console -[Apify Console](/account/console) is the web application where you run and manage Actors, inspect storage, and handle billing. +[Apify Console](/account/console) is the web application where you run and manage Actors, inspect storage, and handle billing. It renders each Actor's input form from its [input schema](/actors/development/actor-definition/input-schema), and presents run results according to the [output schema](/actors/development/actor-definition/output-schema). ## Apify MCP server -The [Apify MCP server](/integrations/mcp) exposes Actors as tools over the Model Context Protocol, so AI assistants and agents can discover and run them. +The [Apify MCP server](/integrations/mcp) exposes Actors as tools over the Model Context Protocol, so AI assistants and agents can discover and run them. Clients such as Claude, ChatGPT, and Cursor connect to it and call Actors as part of a conversation, without custom integration code. ## Apify Proxy -[Apify Proxy](/proxy) routes requests through datacenter and residential IP addresses to reduce blocking. +[Apify Proxy](/proxy) routes requests through datacenter and residential IP addresses to reduce blocking. It rotates addresses automatically and lets you target specific countries, so Actors can reach sites that restrict traffic by address or geography. ## Apify SDK -The [Apify SDK](/sdk) is the JavaScript and Python toolkit for building Actors and working with the platform programmatically. +The [Apify SDK](/sdk) is the JavaScript and Python toolkit for building Actors and working with the platform programmatically. It wraps [storage](/storage), [proxy](/proxy), and run lifecycle handling, so an Actor reads input and writes results without calling the API directly. ## Apify Store -[Apify Store](https://apify.com/store) is the marketplace of Actors for AI, automation, and data extraction. Anyone can publish an Actor there and earn when others use it. +[Apify Store](https://apify.com/store) is the marketplace of Actors for AI, automation, and data extraction. Anyone can [publish](/actors/publishing) an Actor there and earn when others use it, with placement influenced by the Actor's [quality score](/actors/publishing/quality-score). ## Apify storage -[Apify storage](/storage) is the platform's built-in storage, made up of datasets, key-value stores, and request queues. +[Apify storage](/storage) is the platform's built-in storage, made up of [datasets](/storage/dataset), [key-value stores](/storage/key-value-store), and [request queues](/storage/request-queue). Every Actor run gets one of each by default, and you can also create named stores that persist across runs. ## Build -A [build](/actors/development/builds-and-runs/builds) is a versioned Docker image compiled from an Actor's source code. A run executes a build. +A [build](/actors/development/builds-and-runs/builds) is a versioned Docker image compiled from an Actor's source code. Builds are numbered and tagged, so a run can pin a specific version and stay unaffected by later changes to the Actor. ## Compute unit -A [compute unit](/actors/running/usage-and-resources) (CU) is the platform's usage and billing unit, equal to 1 GB of memory running for one hour. +A [compute unit](/actors/running/usage-and-resources) (CU) is the platform's usage and billing unit, equal to 1 GB of memory running for one hour. It's how Actor runs are metered, so allocating more memory to a run consumes CUs faster. ## Crawlee -[Crawlee](https://crawlee.dev) is Apify's open-source library for building web scrapers and browser automation in Node.js and Python. +[Crawlee](https://crawlee.dev) is Apify's open-source library for building web scrapers and browser automation in Node.js and Python. It handles crawling concerns such as queueing, retries, session management, and browser fingerprinting. Crawlee runs anywhere, and the Apify platform is where you deploy it at scale. ## Datacenter proxy -A [datacenter proxy](/proxy/datacenter-proxy) is the fastest and cheapest proxy type, routing through datacenter IP addresses at a higher risk of blocking. +A [datacenter proxy](/proxy/datacenter-proxy) is the fastest and cheapest proxy type, routing through datacenter IP addresses at a higher risk of blocking. Addresses come from shared pools, which suits high-volume work against targets without strong anti-bot protection. ## Dataset -A [dataset](/storage/dataset) is append-only, table-like storage for an Actor's structured results, exportable to JSON, CSV, Excel, and other formats. +A [dataset](/storage/dataset) is append-only, table-like storage for an Actor's structured results. You export it as JSON, CSV, or Excel, read it through the [API](/integrations/api), and can describe its shape with a [dataset schema](/storage/dataset-schema). ## Google SERP proxy -A [Google SERP proxy](/proxy/google-serp-proxy) is a proxy specialized for collecting localized Google search engine results pages at scale. +A [Google SERP proxy](/proxy/google-serp-proxy) is a proxy specialized for collecting localized Google search engine results pages at scale. It targets specific country domains and languages, so you get results as they appear in a given market. ## Input schema -An [input schema](/actors/development/actor-definition/input-schema) is the JSON definition of an Actor's inputs. It generates the Actor's input form in Apify Console. +An [input schema](/actors/development/actor-definition/input-schema) is the JSON definition of an Actor's inputs. It generates the Actor's input form in [Apify Console](/account/console), validates what users submit, and tells AI agents what parameters the Actor accepts. ## Key-value store -A [key-value store](/storage/key-value-store) holds unstructured or auxiliary data, such as Actor input, files, screenshots, and images. +A [key-value store](/storage/key-value-store) holds unstructured or auxiliary data, such as Actor input, files, screenshots, and images. Each run's store holds its `INPUT` record and any files the Actor writes, and its layout can be described with a [key-value store schema](/storage/key-value-store-schema). ## MCP connectors -[MCP connectors](/integrations/mcp-connectors) let an Actor call third-party services, such as Notion, Slack, and GitHub, over the Model Context Protocol using credentials you authorize once in your account settings. They work in the opposite direction to the Apify MCP server, which exposes Actors to outside AI clients. +[MCP connectors](/integrations/mcp-connectors) let an Actor call third-party services, such as Notion, Slack, and GitHub, over the Model Context Protocol using credentials you authorize once in your account settings. They work in the opposite direction to the [Apify MCP server](/integrations/mcp), which exposes Actors to outside AI clients. ## MCP Proxy @@ -111,44 +111,44 @@ The [Apify MCP Proxy](/integrations/mcp-connectors) is the platform component an ## Output -[Output](/actors/running/input-and-output) is the data an Actor run produces. It's stored in the run's dataset and key-value store, and readable from Apify Console or the API. +[Output](/actors/running/input-and-output) is the data an Actor run produces. Structured results go to the run's [dataset](/storage/dataset) and anything else to its [key-value store](/storage/key-value-store), and you read both from [Apify Console](/account/console) or the [API](/integrations/api). ## Output schema -An [output schema](/actors/development/actor-definition/output-schema) declares where an Actor stores its results and how Apify Console and the run API endpoint present them. Publishing an Actor to Apify Store requires one. +An [output schema](/actors/development/actor-definition/output-schema) declares where an Actor stores its results and how Apify Console and the run API endpoint present them. [Publishing an Actor](/actors/publishing/publish) requires one, and it tells AI agents what results to expect before they run it. ## Pay-per-event -[Pay-per-event](/actors/publishing/monetize/pay-per-event) (PPE) is a pricing model that charges users for specific events an Actor emits, such as each result or action, rather than for compute time. +[Pay-per-event](/actors/publishing/monetize/pay-per-event) (PPE) is a pricing model that charges users for specific events an Actor emits, such as each result or action, rather than for compute time. The Actor triggers the events from its own code, and you choose whether platform usage costs are passed on to users. ## Pay-per-usage -[Pay-per-usage](/actors/publishing/monetize/pricing-and-costs) is a pricing model that charges users for the platform resources an Actor consumes, such as compute, storage, and proxy. +[Pay-per-usage](/actors/publishing/monetize/pricing-and-costs) is a pricing model where users pay only the platform usage costs an Actor generates, with no additional charge. It's one of the two [monetization models](/actors/publishing/monetize) currently offered on Apify Store. ## Quality score -The [quality score](/actors/publishing/quality-score) rates how well a Store Actor meets Apify's quality criteria on a scale of 0 to 100, and influences its visibility in Apify Store. +The [quality score](/actors/publishing/quality-score) rates how well a Store Actor meets Apify's quality criteria, on a scale of 0 to 100. It reflects reliability, ease of use, and popularity, and influences where the Actor places in [Apify Store](/actors/running/actors-in-store). ## Rental -[Rental](/actors/publishing/monetize/rental) is a retiring pricing model that charges users a flat monthly fee after a free trial. Publishing new rental Actors stopped on April 1, 2026, and on October 1, 2026 the remaining ones move to pay-per-usage. +[Rental](/actors/publishing/monetize/rental) is a retiring pricing model that charges users a flat monthly fee after a free trial. Publishing new rental Actors stopped on April 1, 2026, and on October 1, 2026 the remaining ones move to [pay-per-usage](#pay-per-usage). ## Request queue -A [request queue](/storage/request-queue) holds the URLs to crawl, tracks their state, and enables resumable, deduplicated crawls. +A [request queue](/storage/request-queue) holds the URLs to crawl and tracks their state. It deduplicates URLs and records which are pending or handled, so a crawl can resume after an interruption and be shared across runs. ## Residential proxy -A [residential proxy](/proxy/residential-proxy) routes requests through IP addresses of real home devices, making them the hardest to detect and block. +A [residential proxy](/proxy/residential-proxy) routes requests through IP addresses of real home devices, making them the hardest to detect and block. It draws on a wider address pool than [datacenter proxies](/proxy/datacenter-proxy), at a higher price, for targets with strong anti-scraping measures. ## Schedule -A [schedule](/actors/running/schedules) is a cron-based trigger that runs an Actor or task automatically at set intervals. +A [schedule](/actors/running/schedules) is a cron-based trigger that runs an Actor or task automatically at set intervals. You define it with a cron expression and manage it from [Apify Console](/account/console) or the [API](/integrations/api). ## Webhook -A [webhook](/integrations/webhooks) is an HTTP callback the platform sends when an Actor run changes state, used to connect Apify to external systems. +A [webhook](/integrations/webhooks) is an HTTP callback the platform sends when an Actor run changes state. Use it to trigger an external system, or another Actor, when a run succeeds or fails, instead of polling for the result. ## x402 -[x402](/integrations/x402) is an agentic payment protocol the platform supports, so agents can pay per Actor call without an account or ongoing billing. +[x402](/integrations/x402) is an agentic payment protocol the platform supports, so agents can pay per Actor call without an account or ongoing billing. Payment settles in USDC on the Base blockchain, which lets an agent discover and run an Actor in a single unattended flow. From aaed6d87e6b1e3759779e434334e76861887c02c Mon Sep 17 00:00:00 2001 From: Marcel Rebro Date: Mon, 14 Sep 2026 18:31:12 +0200 Subject: [PATCH 5/6] docs: distinguish pay per event + usage from plain PPE Pay per event + usage is an option on the pay-per-event model rather than a pricing model of its own, but it changes what users are charged and it has consequences worth surfacing: it lowers the Actor's quality score and makes the Actor ineligible for agentic payments. Entered under its Console label so a reader who meets the toggle can look it up, and framed as an option so it does not read as a third pricing model. Co-Authored-By: Claude Opus 5 (1M context) Claude-Session: https://claude.ai/code/session_01GmXAuRf1CPE7WyGTr3QR1T --- sources/platform/glossary.md | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/sources/platform/glossary.md b/sources/platform/glossary.md index 1022b3ed02..12037185cd 100644 --- a/sources/platform/glossary.md +++ b/sources/platform/glossary.md @@ -119,7 +119,11 @@ An [output schema](/actors/development/actor-definition/output-schema) declares ## Pay-per-event -[Pay-per-event](/actors/publishing/monetize/pay-per-event) (PPE) is a pricing model that charges users for specific events an Actor emits, such as each result or action, rather than for compute time. The Actor triggers the events from its own code, and you choose whether platform usage costs are passed on to users. +[Pay-per-event](/actors/publishing/monetize/pay-per-event) (PPE) is a pricing model that charges users for specific events an Actor emits, such as each result or action, rather than for compute time. The Actor triggers the events from its own code, and platform usage costs can optionally be passed on as well, as [pay per event + usage](#pay-per-event-usage). + +## Pay per event + usage {#pay-per-event-usage} + +[Pay per event + usage](/actors/publishing/monetize/pay-per-event#platform-usage-costs) is an option on the pay-per-event model, not a pricing model of its own. With it switched on, users pay an Actor's platform usage costs on top of its event charges, which lowers the Actor's [quality score](/actors/publishing/quality-score) and makes it ineligible for [agentic payments](/actors/publishing/monetize), so it suits a stopgap while you work out accurate event prices. ## Pay-per-usage From 8fec70841a2570ff7246386252af45abd666d840 Mon Sep 17 00:00:00 2001 From: Marcel Rebro Date: Mon, 14 Sep 2026 18:40:14 +0200 Subject: [PATCH 6/6] docs: fold pay per event + usage into the PPE entry It is an option on the pay-per-event model rather than a term of its own, so a separate A-Z entry overstated it. The PPE entry now names the option and its two consequences: a lower quality score and ineligibility for agentic payments. Co-Authored-By: Claude Opus 5 (1M context) Claude-Session: https://claude.ai/code/session_01GmXAuRf1CPE7WyGTr3QR1T --- sources/platform/glossary.md | 6 +----- 1 file changed, 1 insertion(+), 5 deletions(-) diff --git a/sources/platform/glossary.md b/sources/platform/glossary.md index 12037185cd..526c4057d6 100644 --- a/sources/platform/glossary.md +++ b/sources/platform/glossary.md @@ -119,11 +119,7 @@ An [output schema](/actors/development/actor-definition/output-schema) declares ## Pay-per-event -[Pay-per-event](/actors/publishing/monetize/pay-per-event) (PPE) is a pricing model that charges users for specific events an Actor emits, such as each result or action, rather than for compute time. The Actor triggers the events from its own code, and platform usage costs can optionally be passed on as well, as [pay per event + usage](#pay-per-event-usage). - -## Pay per event + usage {#pay-per-event-usage} - -[Pay per event + usage](/actors/publishing/monetize/pay-per-event#platform-usage-costs) is an option on the pay-per-event model, not a pricing model of its own. With it switched on, users pay an Actor's platform usage costs on top of its event charges, which lowers the Actor's [quality score](/actors/publishing/quality-score) and makes it ineligible for [agentic payments](/actors/publishing/monetize), so it suits a stopgap while you work out accurate event prices. +[Pay-per-event](/actors/publishing/monetize/pay-per-event) (PPE) is a pricing model that charges users for specific events an Actor emits, such as each result or action, rather than for compute time. The Actor triggers those events from its own code. Its [pay per event + usage](/actors/publishing/monetize/pay-per-event#platform-usage-costs) option also charges users the Actor's platform usage costs, which lowers its [quality score](/actors/publishing/quality-score) and makes it ineligible for [agentic payments](/actors/publishing/monetize). ## Pay-per-usage