What is a worker?
A worker is any function you package and deploy to Seek API. It can be written in Node.js or Python, accept structured input, and return structured output. Think of it as a serverless endpoint you own and can monetize.
- Define input parameters via worker.yaml schema
- Any logic: scraping, AI, data processing, automation
- Runs in an isolated Lambda container, 128 MB–3 GB RAM
- Deploy in seconds with the CLI
What is a job?
A job is a single execution of a worker. You trigger it via REST API and get back a job_uuid immediately. The job runs asynchronously — you check back for results when ready.
- Triggered via POST /v1/workers/{id}/jobs
- Returns a job_uuid instantly, execution is async
- Job timeout: 30s (Free) to 60 min (Team)
- Results include JSON output, file URLs, cost, and duration
Public vs private workers
Workers are private by default — only you can call them. When you're ready, you can list a worker publicly on the marketplace. Public workers are discoverable, callable by anyone, and billable to callers.
- Private: only callable with your API key
- Public: listed on the marketplace, callable by others
- You set the price per run for public workers
- Public status can be changed at any time
How billing and credits work
Every run deducts credits from the caller's balance. Credits are the universal billing unit — 1 credit = $0.001. Your monthly plan includes a credit allocation; additional credits are pay-as-you-go.
- Credits deducted per run based on worker price
- Included credits reset monthly
- Extra credits: $10 per 10,000 (never expire)
- Cost visible on every job response
Earning from your workers
On the Creator plan, you earn 70% of every credit spent by callers on your public workers. Seek API handles billing, credit deduction, and monthly payouts. You just ship great workers.
- 70% revenue share on all public worker runs
- Real-time usage tracking in your dashboard
- Payouts monthly above $10 threshold
- Set your own price — any value from $0.001/run
Deploy flow
From local code to live API in under 2 minutes
The seekapi CLI handles everything: zipping, uploading, deploying, and activating your worker. One command, no YAML gymnastics.
Install CLI →# Install the CLI
npm install -g seekapi-cli
# Login
seekapi-cli login --api-key sk_prod_...
# Navigate to your worker directory
cd my-worker
# Edit src/index.js — write your function
# Edit worker.yaml — define worker_id, price, timeout
# Deploy (reads worker_id from worker.yaml)
seekapi-cli worker deploy
# List your workers
seekapi-cli worker ls