Apify SDK environment

Bytewells is compatible with the official Apify SDK. Your existing Actors work without code changes.

ConfigurationCopy Anchor Link

Set these environment variables to point the SDK to your server:

export APIFY_API_BASE_URL=https://bytewells.com/api/v2
export APIFY_TOKEN=your-api-token

That's it. Your Actor code works unchanged:

import { Actor } from 'apify';

await Actor.init();

// All SDK methods work with Bytewells
await Actor.pushData({ title: 'Example' });
const input = await Actor.getInput();
await Actor.setValue('OUTPUT', results);

await Actor.exit();

Injected Environment VariablesCopy Anchor Link

When the runner starts an Actor container, it injects the full Apify SDK environment (see buildActorEnv in packages/runner/src/docker.ts):

When APIFY_PROXY_PASSWORD is not injected, the SDK falls back to resolving it via GET /v2/users/me (data.proxy.password).

Run-scoped APIFY_TOKENCopy Anchor Link

Actor code on Bytewells often belongs to someone other than the user running it, so the runner never injects the user's API key. APIFY_TOKEN is a token minted for this run only. It authenticates as the run's owner while the run is active (plus a 10-minute grace period) and only on the endpoints an Actor needs: datasets, key-value stores, request queues, its own run and log, GET /v2/users/me, and starting runs of Actors the owner is entitled to. Anything else returns 403. Actors that call the API with APIFY_TOKEN through the SDK or apify-client need no changes.

Supported FeaturesCopy Anchor Link

Pointing an Actor at BytewellsCopy Anchor Link

When you run an Actor on Bytewells, the platform sets APIFY_API_BASE_URL and APIFY_TOKEN for you. To exercise the same code from your laptop against the hosted API:

export APIFY_API_BASE_URL=https://bytewells.com/api/v2
export APIFY_TOKEN=<your Bytewells API key>
npm start

Pushing ActorsCopy Anchor Link

# Log in
bw login --url https://bytewells.com/api

# Push the Actor in the current directory (name from .actor/actor.json)
bw push

Apify vs BytewellsCopy Anchor Link

*Before Stripe's card and billing fees, which are passed on to the developer at cost with no markup.