Skip to main content
POST
/
api
/
external
/
jobs
/
create
curl -X POST "https://wurkapi.fun/api/external/jobs/create" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "social",
    "tweet_url": "https://x.com/user/status/1234567890123456789",
    "min_rank": 1,
    "cooldown_minutes": 5,
    "jobtype": "repost",
    "max_completions": 100,
    "total_usdc": 5.0
  }'

{
  "jobId": "89e57c15",
  "status": "unpaid",
  "type": "social",
  "balancePayment": 0
}

​
Authentication

​
X-API-Key
string
required
Your WURK API key

​
Request Body

​
type
string
required
Must be "social"
​
tweet_url
string
required
X/Twitter status URL or numeric tweet ID
  • Tweet must exist
  • Tweets with > 500 reposts are rejected
  • Author may be blocked (returns 403)
​
min_rank
integer
required
Minimum worker rank (1-3)
​
cooldown_minutes
number
required
Cooldown period between completions (0-1440 minutes)
​
jobtype
string
required
Type of engagement: repost, comment, or repost_comment
​
max_completions
integer
required
Number of completions needed
  • Minimum: 25
  • Maximum for repost: 1000
  • Maximum for comment/repost_comment: 250
​
message_markdown
string
Instructions for workers. Required when jobtype is comment or repost_comment

​
Payment Options

Choose one payment method:

​
Option 1: USDC Payment (x402)

​
total_usdc
number
Payment amount in USDC. Must be ≥ max(2.50, 0.025 × max_completions)

​
Option 2: Platform Balance (SOL)

​
balance_payment
number
Set to 1 to use platform balance
​
total_bounty_sol
number
Required when balance_payment = 1. Must be ≥ max(0.01, 0.00012 × max_completions)

​
Response

​
jobId
string
Primary job identifier (use this for all API calls)
​
status
string
Job status: unpaid (USDC) or pending (balance)
​
type
string
Always social
​
balancePayment
number
Payment method: 0 for USDC, 1 for balance

​
Field Constraints

  • min_rank: 1-3
  • cooldown_minutes: 0-1440
  • jobtype: repost, comment, or repost_comment
  • max_completions:
    • Minimum: 25
    • repost: max 1000
    • comment/repost_comment: max 250
  • message_markdown: Required for comment/repost_comment
  • total_usdc: ≥ max(2.50, 0.025 × max_completions)
  • total_bounty_sol: ≥ max(0.01, 0.00012 × max_completions)
curl -X POST "https://wurkapi.fun/api/external/jobs/create" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "social",
    "tweet_url": "https://x.com/user/status/1234567890123456789",
    "min_rank": 1,
    "cooldown_minutes": 5,
    "jobtype": "repost",
    "max_completions": 100,
    "total_usdc": 5.0
  }'

{
  "jobId": "89e57c15",
  "status": "unpaid",
  "type": "social",
  "balancePayment": 0
}