Skip to main content

​
Base URL

All API requests should be made to: 
https://wurkapi.fun

​
Two Ways to Use WURK API

Quick Endpoints

No API key needed! Create preconfigured jobs with just 2 HTTP requests and x402 payment.

Full API

Complete control with API key authentication. Customize every aspect of your jobs.

​
Quick Endpoints (No API Key)

Quick Endpoints allow instant job creation without registration:
  • No API key required - Just make HTTP requests
  • Fixed pricing - $2.50 USDC per job
  • 100 completions - Preconfigured for optimal results
  • Two-step flow - Discovery request, then payment

​
Quick Endpoint Format

https://wurkapi.fun/api/x402/quick/{network}/{job-type}?url={target}
Available on both Solana and Base networks. See Quick Endpoints for details.

​
Full API (With API Key)

For complete control, use authenticated endpoints:

​
Authentication

All authenticated endpoints require your API key in the X-API-Key header: 
curl -H "X-API-Key: YOUR_API_KEY" https://wurkapi.fun/api/external/...
Get your API key at wurk.fun/apikey.

​
Available Endpoints

​
Quick Endpoints (No API Key)

  • GET /api/x402/quick/solana/{job-type} - Quick jobs on Solana
  • GET /api/x402/quick/base/{job-type} - Quick jobs on Base
    • Job types: reposts-100, xlikes-100, insta-likes-100, dex-rocket-100

​
Create Jobs (API Key Required)

  • POST /api/external/jobs/create - Create a social job (see Social Jobs)
  • POST /api/external/jobs/create - Create a custom job (see Custom Jobs)

​
List Jobs (API Key Required)

  • GET /api/external/jobs/open/custom - List your open custom jobs
  • GET /api/external/jobs/open/social - List your open social jobs

​
Payments - Solana (x402)

  • GET /api/x402/jobs/:jobId/accepts - Get payment requirements
  • GET /api/x402/jobs/:jobId/pay - Process USDC payment

​
Payments - Base (x402)

  • GET /api/x402/base/jobs/:jobId/accepts - Get payment requirements
  • GET /api/x402/base/jobs/:jobId/pay - Process USDC payment

​
Submissions (API Key Required)

  • GET /api/external/jobs/:jobId/submissions - Get job submissions
  • POST /api/external/jobs/:jobId/choose-winners - Select winners

​
Utilities (API Key Required)

  • GET /api/external/categories - List categories
  • GET /api/external/balance - Check platform balance
  • GET /api/external/change-log - View platform updates
  • GET /api/external/health - Health check

​
Response Format

All responses are in JSON format: 
{
  "data": "...",
  "status": "success"
}

​
Error Handling

Error responses include appropriate HTTP status codes:
  • 400 - Bad Request (invalid parameters)
  • 401 - Unauthorized (invalid API key)
  • 403 - Forbidden (blocked or no access)
  • 404 - Not Found
  • 409 - Conflict (duplicate job, etc.)
  • 429 - Too Many Requests (rate limited)
Error response format: 
  {
  "error": "Error message",
  "status": 400
  }

​
Rate Limits

See Rate Limits for detailed information about API rate limits.