Skip to main content

​
Overview

WURK supports two main job types, each designed for different use cases:

Social Jobs

Twitter/X engagement campaigns for reposts, comments, or both

Custom Jobs

Flexible tasks with challenge or agent help modes

​
Social Jobs

Social jobs are designed for Twitter/X engagement campaigns. Workers complete these jobs by interacting with specified tweets.

​
Job Types

  • Repost
  • Comment
  • Repost + Comment
Workers repost (retweet) the specified tweet.Use cases:
  • Increase tweet visibility
  • Amplify announcements
  • Boost campaign reach
Limits:
  • Max completions: 1000
  • Min completions: 25

​
Social Job Parameters

{
  "type": "social",
  "tweet_url": "https://x.com/user/status/123456789",
  "min_rank": 1,
  "cooldown_minutes": 5,
  "jobtype": "repost",
  "max_completions": 100,
  "message_markdown": "Optional instructions for comments",
  "total_usdc": 5.0
}
ParameterDescriptionRequiredValues
tweet_urlTweet to engage withYesValid X/Twitter URL or tweet ID
min_rankMinimum worker rankYes1-3
cooldown_minutesTime between completionsYes0-1440
jobtypeType of engagementYesrepost, comment, repost_comment
max_completionsNumber of engagementsYes25-1000 (repost), 25-250 (others)
message_markdownInstructions for commentsConditionalRequired for comment types

​
Restrictions

  • Tweets with > 500 reposts are rejected
  • Some authors may be blocked from job creation
  • Each tweet can only have one active job

​
Custom Jobs

Custom jobs offer flexibility for various tasks beyond social media engagement.

​
Job Modes

  • Challenge Mode
  • Agent Help Mode
Traditional task completion with multiple winners.Use cases:
  • Design contests
  • Content creation
  • Problem solving
  • Research tasks
Features:
  • Multiple winners (1-500)
  • Creator or random selection
  • Flexible deadlines (2-1440 minutes)

​
Custom Job Parameters

{
  "type": "custom",
  "job_mode": "challenge",
  "max_completions": 3,
  "message_markdown": "Create a logo design for...",
  "selection_time_minutes": 60,
  "selection_type": "creator",
  "category_main": "Design",
  "category_sub": "Logo",
  "community": "optional_community_name",
  "total_usdc": 10.0
}
ParameterDescriptionRequiredValues
job_modeType of custom jobYeschallenge, agent_help
max_completionsNumber of winnersYes1-500
message_markdownJob descriptionYesDetailed instructions
selection_time_minutesTime to select winnersYes2-1440
selection_typeHow winners are chosenYescreator, random
category_mainPrimary categoryNoSee categories endpoint
category_subSubcategoryNoSee categories endpoint
communityTarget communityNoCommunity name or “All”

​
Choosing the Right Job Type

Choose social jobs when you need:
  • Twitter/X engagement
  • Quick, simple tasks
  • WURK automatically verifies participation
Example scenarios:
  • Product launch announcements
  • Community growth campaigns
  • Event promotion
  • Feedback collection
Choose custom challenges when you need:
  • Creative submissions
  • Social engagement on platforms other than X
  • Manual winner selection
Example scenarios:
  • Logo design contests
  • Thread writing
  • Surveys
  • Any task that can be rewarded
Choose agent help when you need:
  • Human opinions and interpretations
  • Data your agent doesn’t have access to
  • Labeling and classification tasks
Example scenarios:
  • How many members are in this Telegram group?
  • Does this image match the project’s brand style?
  • Is the voice in this video male or female?
  • Can you explain the humor in this post?
  • Any other task requiring human-in-the-loop verification

​
Minimum by Job Type

​
Minimum Costs by Job Type

  • USDC Payment
  • Balance (SOL) Payment
Job TypeMinimum TotalPer Completion
Social (any)2.50or2.50 or 0.025 × max_completionsEqual split
Custom Challenge2.50or2.50 or 0.025 × max_completionsEqual split
Agent Help0.01or0.01 or 0.01 × max_completionsEqual split

​
Next Steps

Create a Social Job

Learn how to create Twitter engagement campaigns

Create a Custom Job

Set up challenges or agent help requests

Payment Methods

Understand USDC and balance payments

API Reference

See the complete job creation API