Publish an Actor
Push source, create a Store listing, set price and trial, configure passes, and complete Stripe Connect.
1. Push your Actor
npm install -g @thoughtpivot/bytewells-cli
bw login --url https://bytewells.com/api
bw pushOr import Actors you already publish on Apify:
- Console — Settings → Connect Apify, then pick Actors on Actors → New. See Import from Apify.
- CLI —
bw import apify <actorIdOrName>with an Apify API token.
Both copy source, README, input schema and run defaults into a draft listing. In the console, Preview listing opens that draft on the Store. Only your account can see it, and it is not listed or indexed until you publish.
bw push uploads the source as a tar.gz, and Bytewells builds the image from that archive. Renters run the image and do not receive the source. Bytewells may inspect the source for legal, compliance, or security reasons. The Publisher Terms also say we will not use your source to publish a competing Bytewells-owned Actor or to list it on another marketplace as our product.
2. Create or edit the listing
In the console: Publish → List an Actor, or use the API (POST /v2/me/listings).
Paid listings use pricingModel: FLAT_PRICE_PER_MONTH with:
monthlyPriceCents— monthly rentaltrialDays— 1–30, developer-set free trial (becomes Stripetrial_period_days)- Optional pass tiers (Flash / Burst / Sprint) when passes launch — see Passes (coming soon; not configurable in production yet)
Free listings (FREE) need no payout setup; customers pay only compute.
Choose your payout country when you create the first paid listing (PUT /v2/me/payout-country). Paid listings are available for developers in supported payout countries (see below); other countries can publish free listings only for now.
Payouts run through Stripe Connect on ThoughtPivot, Inc. (United States). We are working on expanding developer payouts globally; the supported country list will grow over time.
3. Get paid: verify with Stripe
You can publish a paid listing and start earning before you verify with Stripe. Earnings accrue in your balance; you need a verified Stripe Connect account (Accounts v2 recipient) to receive the money:
- $50 balance (held plus payable) — verify with Stripe to receive payouts. If a balance of $50 or more stays unverified for 90 days, new sales on your listings pause until you finish.
curl -X POST -H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{"country":"DE"}' \
https://bytewells.com/api/v2/billing/connect/onboardComplete the hosted onboarding URL. Rent/pass purchases against a publisher who has been unpayable for over 90 days return 409 publisher-not-payable.
Supported payout countries (today): the EU, Liechtenstein, Norway, Switzerland, the UK, the United States, Canada, Bosnia and Herzegovina, and Pakistan. Your payout country is fixed once your Stripe account exists. Free listings work from any country while we expand payout coverage.
4. Publish
Publishing a listing agrees to the Publisher Terms.
bw publish <actor>
# or POST /v2/me/listings/{id}/publishPass prices, from the CLI:
bw publish my-scraper --price 29 --flash 2 --burst 8 --sprint 15The same fields are monthlyPriceCents, flashPriceCents, burstPriceCents, and sprintPriceCents on PUT /v2/me/listings/:id (integer cents). The MCP server exposes list-my-listings, get-my-listing, create-my-listing, update-my-listing, publish-my-listing, and unpublish-my-listing.
Unlisted
An unlisted Actor stays on its slug. Anyone with the link can open it, rent it, and run it. It does not appear in Store search, on the publisher page, or in the sitemap, and the page tells Google not to index it.
bw publish <actor> --unlisted
# or POST /v2/me/listings/{id}/publish with { "status": "UNLISTED" }In the console, use Publish as unlisted on a draft, or Make unlisted on a listing that is already on the Store. bw publish <actor> lists it again. --unpublish returns it to a draft, which only you can preview.
Share an Actor
Share a private or Store Actor with another Bytewells username so they can open and run it without a rental or pass. Their runs use their user, storages, and compute credits. They do not see your source, env, image, or proxy password, and you do not see their runs.
In the console: open the Actor → Config → Share this Actor. Or use the API:
# List / add / revoke (owner only)
GET /v2/acts/:actorId/shares
POST /v2/acts/:actorId/shares {"username":"other-user"}
DELETE /v2/acts/:actorId/shares/:usernameGET /v2/acts includes Actors shared with you (shared: true, owner's username). Revoking a share blocks new runs; runs already in flight keep going.
Price changes
After the first publish, those prices can change once every 14 days. The listing tells you priceChangeAvailableAt. A change sooner than that is rejected. Trial length and listing copy can change any time. Taking the listing off the Store does not reset the lock. A draft that has never been published can be repriced freely.
Earnings and payouts
- Rentals and passes are charged on the Bytewells platform account and recorded in your earnings ledger.
- Net per sale = charge − Bytewells commission − Stripe card processing − Stripe Billing fee (rentals). Commission is 10%, or 0% if the renter used your referral. Stripe's variable fees are passed through at cost with no markup; Bytewells pays the fixed Connect account and payout fees. A typical $17.50 rental nets about 85%.
- Each earning is held for 14 days (refund and dispute window), then becomes payable.
- Payouts are monthly, in one Stripe transfer, once your payable balance reaches $50. Smaller balances roll over.
- Refunds and disputes reverse the matching earning. Money already paid out is netted from your next payout; a dispute freezes the earning until it closes.
- The $5 sign-up credit pays for compute only; it cannot buy passes, so it never produces earnings.
Track renters and payouts under Publish → Customers / Earnings / Payouts.