Upvote Club API Documentation

API to Buy Social Media Engagement

Buy Twitter Likes, LinkedIn Followers, Instagram Comments, TikTok Views, YouTube Subscribers, Reddit Upvotes, Facebook Reactions, Medium Claps, Dev.to Reactions, GitHub Stars, Quora Upvotes, Substack Subscribers, and Bluesky Likes through our API.

Quick Start

Get started with our API in three simple steps:

  1. Generate your API key from the dashboard
  2. Authenticate requests using the X-API-Key header
  3. Create tasks and track their status

Base URL

Authorize to get the Base URL

Authorize to get URL

Authentication

All API requests require authentication using your API key. Include it in the request header or as a query parameter.

X-API-Key: your_api_key_here

Alternatively, you can pass the API key as a query parameter: ?api_key=your_api_key_here

Authorize to get API key

Main Endpoints

POSTcreate-task/

Create a new task to be completed by the community. You need sufficient balance and available task slots to create a task.

GETtask-status/{task_id}/

Get the status and details of one or more tasks. You can query a single task by ID or multiple tasks using comma-separated IDs. Use this endpoint to track task progress and completion.

POSTgenerate-key/

Generate an API key to authenticate your requests. Keep your key secure and never share it publicly. Each user can have only one active API key.

Supported Social Networks

Click on any social network below to jump to its detailed documentation:

Twitter (X.com)

Twitter (X.com)

Create and track tasks for Twitter/X posts and profiles

LIKECOMMENTREPOST+2 more
LinkedIn

LinkedIn

Create and track tasks for LinkedIn posts and profiles

LIKECOMMENTREPOST+2 more
Reddit

Reddit

Create and track tasks for Reddit posts and profiles

UPVOTECOMMENTSAVE+1 more
Instagram

Instagram

Create and track tasks for Instagram posts and profiles

LIKECOMMENTFOLLOW+1 more
TikTok

TikTok

Create and track tasks for TikTok videos and profiles

LIKECOMMENTFOLLOW+1 more
YouTube

YouTube

Create and track tasks for YouTube videos and channels

LIKECOMMENTFOLLOW+1 more
Facebook

Facebook

Create and track tasks for Facebook posts and profiles

LIKECOMMENTREPOST+2 more
Medium

Medium

Create and track tasks for Medium articles and profiles

CLAPCOMMENTFOLLOW+1 more
Dev.to

Dev.to

Create and track tasks for Dev.to articles and profiles

LIKECOMMENTSAVE+2 more
GitHub

GitHub

Create and track tasks for GitHub repositories and profiles

STARFOLLOWWATCH
Quora

Quora

Create and track tasks for Quora questions and profiles

UPVOTECOMMENTFOLLOW+1 more
Substack

Substack

Create and track tasks for Substack articles and profiles

RESTACKCOMMENTSAVE+1 more
Bluesky

Bluesky

Create and track tasks for Bluesky posts and profiles

LIKECOMMENTREPOST+1 more
Threads

Threads

Create and track tasks for Threads posts and profiles

LIKECOMMENTREPOST+2 more

Social Networks Documentation

Twitter (X.com)

Twitter (X.com)

Create and track tasks for Twitter/X posts and profiles

Available Actions & Minimum Prices

LIKEMin: 2 points
COMMENTMin: 4 points
REPOSTMin: 4 points
FOLLOWMin: 4 points
SAVEMin: 4 points

* Setting a price below the minimum will result in a validation error

URL Examples

Post URL:
https://twitter.com/username/status/123456789
Profile URL:
https://x.com/username

Accepted URL Patterns

Make sure your URLs match these patterns:

Posts:
  • x.com/status/
  • twitter.com/status/
Profiles:
  • x.com/
  • twitter.com/

Create Task

Endpoint:
POST https://***********/api/public-api/create-task/
Request Body:
{
  "post_url": "https://twitter.com/username/status/123456789",
  "type": "LIKE",
  "price": 2,
  "actions_required": 10,
  "social_network_code": "TWITTER"
}

Note: Price must be at least 2 points for LIKE action

Success Response (201):
{
  "id": 12345,
  "creator": 1,
  "type": "LIKE",
  "post_url": "https://twitter.com/username/status/123456789",
  "price": 2,
  "actions_required": 10,
  "actions_completed": 0,
  "original_price": 20,
  "social_network": {
    "id": 1,
    "code": "TWITTER",
    "name": "Twitter (X.com)"
  },
  "status": "ACTIVE",
  "bonus_actions": 2,
  "bonus_actions_completed": 0,
  "is_pinned": false,
  "created_at": "2024-12-25T10:30:00Z",
  "completed_at": null
}
Error Responses (400):
// Price below minimum for action type:
{
  "detail": "price: Ensure this value is greater than or equal to 2"
}

// Insufficient balance:
{
  "detail": "Insufficient balance to create task"
}

// Duplicate task exists:
{
  "detail": "A task with this URL and action type already exists",
  "existing_task_id": 12344
}

// Missing required field:
{
  "detail": "Missing required field: social_network_code"
}

Track Task Status

Endpoint:
GET https://***********/api/public-api/task-status/12345/

You can track multiple tasks at once: task-status/12345,12346,12347/

Success Response (200):
{
  "id": 12345,
  "creator": 1,
  "type": "LIKE",
  "post_url": "https://twitter.com/username/status/123456789",
  "price": 2,
  "actions_required": 10,
  "actions_completed": 7,
  "original_price": 20,
  "social_network": {
    "id": 1,
    "code": "TWITTER",
    "name": "Twitter (X.com)"
  },
  "status": "ACTIVE",
  "bonus_actions": 2,
  "bonus_actions_completed": 1,
  "created_at": "2024-12-25T10:30:00Z",
  "completed_at": null,
  "progress_percentage": 70,
  "remaining_actions": 3
}
Task Statuses:
  • ACTIVE - Task is being completed
  • COMPLETED - All actions finished
  • PAUSED - Temporarily stopped
  • DELETED - Cancelled by creator
LinkedIn

LinkedIn

Create and track tasks for LinkedIn posts and profiles

Available Actions & Minimum Prices

LIKEMin: 2 points
COMMENTMin: 4 points
REPOSTMin: 4 points
FOLLOWMin: 4 points
SAVEMin: 4 points

* Setting a price below the minimum will result in a validation error

URL Examples

Post URL:
https://www.linkedin.com/posts/username_post-title-activity-123456789
Profile URL:
https://www.linkedin.com/in/username

Accepted URL Patterns

Make sure your URLs match these patterns:

Posts:
  • /posts/
  • /feed/update/urn:li:activity:
  • /pulse/
Profiles:
  • linkedin.com/in/

Create Task

Endpoint:
POST https://***********/api/public-api/create-task/
Request Body:
{
  "post_url": "https://www.linkedin.com/posts/username_post-title-activity-123456789",
  "type": "LIKE",
  "price": 2,
  "actions_required": 10,
  "social_network_code": "LINKEDIN"
}

Note: Price must be at least 2 points for LIKE action

Success Response (201):
{
  "id": 12345,
  "creator": 1,
  "type": "LIKE",
  "post_url": "https://www.linkedin.com/posts/username_post-title-activity-123456789",
  "price": 2,
  "actions_required": 10,
  "actions_completed": 0,
  "original_price": 20,
  "social_network": {
    "id": 1,
    "code": "LINKEDIN",
    "name": "LinkedIn"
  },
  "status": "ACTIVE",
  "bonus_actions": 2,
  "bonus_actions_completed": 0,
  "is_pinned": false,
  "created_at": "2024-12-25T10:30:00Z",
  "completed_at": null
}
Error Responses (400):
// Price below minimum for action type:
{
  "detail": "price: Ensure this value is greater than or equal to 2"
}

// Insufficient balance:
{
  "detail": "Insufficient balance to create task"
}

// Duplicate task exists:
{
  "detail": "A task with this URL and action type already exists",
  "existing_task_id": 12344
}

// Missing required field:
{
  "detail": "Missing required field: social_network_code"
}

Track Task Status

Endpoint:
GET https://***********/api/public-api/task-status/12345/

You can track multiple tasks at once: task-status/12345,12346,12347/

Success Response (200):
{
  "id": 12345,
  "creator": 1,
  "type": "LIKE",
  "post_url": "https://www.linkedin.com/posts/username_post-title-activity-123456789",
  "price": 2,
  "actions_required": 10,
  "actions_completed": 7,
  "original_price": 20,
  "social_network": {
    "id": 1,
    "code": "LINKEDIN",
    "name": "LinkedIn"
  },
  "status": "ACTIVE",
  "bonus_actions": 2,
  "bonus_actions_completed": 1,
  "created_at": "2024-12-25T10:30:00Z",
  "completed_at": null,
  "progress_percentage": 70,
  "remaining_actions": 3
}
Task Statuses:
  • ACTIVE - Task is being completed
  • COMPLETED - All actions finished
  • PAUSED - Temporarily stopped
  • DELETED - Cancelled by creator
Reddit

Reddit

Create and track tasks for Reddit posts and profiles

Available Actions & Minimum Prices

UPVOTEMin: 4 points
COMMENTMin: 4 points
SAVEMin: 4 points
FOLLOWMin: 4 points

* Setting a price below the minimum will result in a validation error

URL Examples

Post URL:
https://www.reddit.com/r/subreddit/comments/123456/post_title
Profile URL:
https://www.reddit.com/user/username

Accepted URL Patterns

Make sure your URLs match these patterns:

Posts:
  • reddit.com/r/subreddit/comments/
Profiles:
  • reddit.com/user/

Create Task

Endpoint:
POST https://***********/api/public-api/create-task/
Request Body:
{
  "post_url": "https://www.reddit.com/r/subreddit/comments/123456/post_title",
  "type": "UPVOTE",
  "price": 4,
  "actions_required": 10,
  "social_network_code": "REDDIT"
}

Note: Price must be at least 4 points for UPVOTE action

Success Response (201):
{
  "id": 12345,
  "creator": 1,
  "type": "UPVOTE",
  "post_url": "https://www.reddit.com/r/subreddit/comments/123456/post_title",
  "price": 4,
  "actions_required": 10,
  "actions_completed": 0,
  "original_price": 40,
  "social_network": {
    "id": 1,
    "code": "REDDIT",
    "name": "Reddit"
  },
  "status": "ACTIVE",
  "bonus_actions": 2,
  "bonus_actions_completed": 0,
  "is_pinned": false,
  "created_at": "2024-12-25T10:30:00Z",
  "completed_at": null
}
Error Responses (400):
// Price below minimum for action type:
{
  "detail": "price: Ensure this value is greater than or equal to 4"
}

// Insufficient balance:
{
  "detail": "Insufficient balance to create task"
}

// Duplicate task exists:
{
  "detail": "A task with this URL and action type already exists",
  "existing_task_id": 12344
}

// Missing required field:
{
  "detail": "Missing required field: social_network_code"
}

Track Task Status

Endpoint:
GET https://***********/api/public-api/task-status/12345/

You can track multiple tasks at once: task-status/12345,12346,12347/

Success Response (200):
{
  "id": 12345,
  "creator": 1,
  "type": "UPVOTE",
  "post_url": "https://www.reddit.com/r/subreddit/comments/123456/post_title",
  "price": 4,
  "actions_required": 10,
  "actions_completed": 7,
  "original_price": 40,
  "social_network": {
    "id": 1,
    "code": "REDDIT",
    "name": "Reddit"
  },
  "status": "ACTIVE",
  "bonus_actions": 2,
  "bonus_actions_completed": 1,
  "created_at": "2024-12-25T10:30:00Z",
  "completed_at": null,
  "progress_percentage": 70,
  "remaining_actions": 3
}
Task Statuses:
  • ACTIVE - Task is being completed
  • COMPLETED - All actions finished
  • PAUSED - Temporarily stopped
  • DELETED - Cancelled by creator
Instagram

Instagram

Create and track tasks for Instagram posts and profiles

Available Actions & Minimum Prices

LIKEMin: 2 points
COMMENTMin: 4 points
FOLLOWMin: 4 points
SAVEMin: 4 points

* Setting a price below the minimum will result in a validation error

URL Examples

Post URL:
https://www.instagram.com/p/ABC123xyz/
Profile URL:
https://www.instagram.com/username/

Accepted URL Patterns

Make sure your URLs match these patterns:

Posts:
  • instagram.com/p/
  • instagram.com/reel/
Profiles:
  • instagram.com/

Create Task

Endpoint:
POST https://***********/api/public-api/create-task/
Request Body:
{
  "post_url": "https://www.instagram.com/p/ABC123xyz/",
  "type": "LIKE",
  "price": 2,
  "actions_required": 10,
  "social_network_code": "INSTAGRAM"
}

Note: Price must be at least 2 points for LIKE action

Success Response (201):
{
  "id": 12345,
  "creator": 1,
  "type": "LIKE",
  "post_url": "https://www.instagram.com/p/ABC123xyz/",
  "price": 2,
  "actions_required": 10,
  "actions_completed": 0,
  "original_price": 20,
  "social_network": {
    "id": 1,
    "code": "INSTAGRAM",
    "name": "Instagram"
  },
  "status": "ACTIVE",
  "bonus_actions": 2,
  "bonus_actions_completed": 0,
  "is_pinned": false,
  "created_at": "2024-12-25T10:30:00Z",
  "completed_at": null
}
Error Responses (400):
// Price below minimum for action type:
{
  "detail": "price: Ensure this value is greater than or equal to 2"
}

// Insufficient balance:
{
  "detail": "Insufficient balance to create task"
}

// Duplicate task exists:
{
  "detail": "A task with this URL and action type already exists",
  "existing_task_id": 12344
}

// Missing required field:
{
  "detail": "Missing required field: social_network_code"
}

Track Task Status

Endpoint:
GET https://***********/api/public-api/task-status/12345/

You can track multiple tasks at once: task-status/12345,12346,12347/

Success Response (200):
{
  "id": 12345,
  "creator": 1,
  "type": "LIKE",
  "post_url": "https://www.instagram.com/p/ABC123xyz/",
  "price": 2,
  "actions_required": 10,
  "actions_completed": 7,
  "original_price": 20,
  "social_network": {
    "id": 1,
    "code": "INSTAGRAM",
    "name": "Instagram"
  },
  "status": "ACTIVE",
  "bonus_actions": 2,
  "bonus_actions_completed": 1,
  "created_at": "2024-12-25T10:30:00Z",
  "completed_at": null,
  "progress_percentage": 70,
  "remaining_actions": 3
}
Task Statuses:
  • ACTIVE - Task is being completed
  • COMPLETED - All actions finished
  • PAUSED - Temporarily stopped
  • DELETED - Cancelled by creator
TikTok

TikTok

Create and track tasks for TikTok videos and profiles

Available Actions & Minimum Prices

LIKEMin: 2 points
COMMENTMin: 4 points
FOLLOWMin: 4 points
SAVEMin: 4 points

* Setting a price below the minimum will result in a validation error

URL Examples

Post URL:
https://www.tiktok.com/@username/video/1234567890
Profile URL:
https://www.tiktok.com/@username

Accepted URL Patterns

Make sure your URLs match these patterns:

Posts:
  • tiktok.com/@
  • /video/
Profiles:
  • tiktok.com/@

Create Task

Endpoint:
POST https://***********/api/public-api/create-task/
Request Body:
{
  "post_url": "https://www.tiktok.com/@username/video/1234567890",
  "type": "LIKE",
  "price": 2,
  "actions_required": 10,
  "social_network_code": "TIKTOK"
}

Note: Price must be at least 2 points for LIKE action

Success Response (201):
{
  "id": 12345,
  "creator": 1,
  "type": "LIKE",
  "post_url": "https://www.tiktok.com/@username/video/1234567890",
  "price": 2,
  "actions_required": 10,
  "actions_completed": 0,
  "original_price": 20,
  "social_network": {
    "id": 1,
    "code": "TIKTOK",
    "name": "TikTok"
  },
  "status": "ACTIVE",
  "bonus_actions": 2,
  "bonus_actions_completed": 0,
  "is_pinned": false,
  "created_at": "2024-12-25T10:30:00Z",
  "completed_at": null
}
Error Responses (400):
// Price below minimum for action type:
{
  "detail": "price: Ensure this value is greater than or equal to 2"
}

// Insufficient balance:
{
  "detail": "Insufficient balance to create task"
}

// Duplicate task exists:
{
  "detail": "A task with this URL and action type already exists",
  "existing_task_id": 12344
}

// Missing required field:
{
  "detail": "Missing required field: social_network_code"
}

Track Task Status

Endpoint:
GET https://***********/api/public-api/task-status/12345/

You can track multiple tasks at once: task-status/12345,12346,12347/

Success Response (200):
{
  "id": 12345,
  "creator": 1,
  "type": "LIKE",
  "post_url": "https://www.tiktok.com/@username/video/1234567890",
  "price": 2,
  "actions_required": 10,
  "actions_completed": 7,
  "original_price": 20,
  "social_network": {
    "id": 1,
    "code": "TIKTOK",
    "name": "TikTok"
  },
  "status": "ACTIVE",
  "bonus_actions": 2,
  "bonus_actions_completed": 1,
  "created_at": "2024-12-25T10:30:00Z",
  "completed_at": null,
  "progress_percentage": 70,
  "remaining_actions": 3
}
Task Statuses:
  • ACTIVE - Task is being completed
  • COMPLETED - All actions finished
  • PAUSED - Temporarily stopped
  • DELETED - Cancelled by creator
YouTube

YouTube

Create and track tasks for YouTube videos and channels

Available Actions & Minimum Prices

LIKEMin: 2 points
COMMENTMin: 4 points
FOLLOWMin: 4 points
SAVEMin: 4 points

* Setting a price below the minimum will result in a validation error

URL Examples

Post URL:
https://www.youtube.com/watch?v=dQw4w9WgXcQ
Profile URL:
https://www.youtube.com/@username

Accepted URL Patterns

Make sure your URLs match these patterns:

Posts:
  • youtube.com/watch
  • youtu.be/
Profiles:
  • youtube.com/@
  • youtube.com/channel/

Create Task

Endpoint:
POST https://***********/api/public-api/create-task/
Request Body:
{
  "post_url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
  "type": "LIKE",
  "price": 2,
  "actions_required": 10,
  "social_network_code": "YOUTUBE"
}

Note: Price must be at least 2 points for LIKE action

Success Response (201):
{
  "id": 12345,
  "creator": 1,
  "type": "LIKE",
  "post_url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
  "price": 2,
  "actions_required": 10,
  "actions_completed": 0,
  "original_price": 20,
  "social_network": {
    "id": 1,
    "code": "YOUTUBE",
    "name": "YouTube"
  },
  "status": "ACTIVE",
  "bonus_actions": 2,
  "bonus_actions_completed": 0,
  "is_pinned": false,
  "created_at": "2024-12-25T10:30:00Z",
  "completed_at": null
}
Error Responses (400):
// Price below minimum for action type:
{
  "detail": "price: Ensure this value is greater than or equal to 2"
}

// Insufficient balance:
{
  "detail": "Insufficient balance to create task"
}

// Duplicate task exists:
{
  "detail": "A task with this URL and action type already exists",
  "existing_task_id": 12344
}

// Missing required field:
{
  "detail": "Missing required field: social_network_code"
}

Track Task Status

Endpoint:
GET https://***********/api/public-api/task-status/12345/

You can track multiple tasks at once: task-status/12345,12346,12347/

Success Response (200):
{
  "id": 12345,
  "creator": 1,
  "type": "LIKE",
  "post_url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
  "price": 2,
  "actions_required": 10,
  "actions_completed": 7,
  "original_price": 20,
  "social_network": {
    "id": 1,
    "code": "YOUTUBE",
    "name": "YouTube"
  },
  "status": "ACTIVE",
  "bonus_actions": 2,
  "bonus_actions_completed": 1,
  "created_at": "2024-12-25T10:30:00Z",
  "completed_at": null,
  "progress_percentage": 70,
  "remaining_actions": 3
}
Task Statuses:
  • ACTIVE - Task is being completed
  • COMPLETED - All actions finished
  • PAUSED - Temporarily stopped
  • DELETED - Cancelled by creator
Facebook

Facebook

Create and track tasks for Facebook posts and profiles

Available Actions & Minimum Prices

LIKEMin: 2 points
COMMENTMin: 4 points
REPOSTMin: 4 points
FOLLOWMin: 4 points
SAVEMin: 4 points

* Setting a price below the minimum will result in a validation error

URL Examples

Post URL:
https://www.facebook.com/username/posts/123456789
Profile URL:
https://www.facebook.com/username

Accepted URL Patterns

Make sure your URLs match these patterns:

Posts:
  • facebook.com/
  • /posts/
Profiles:
  • facebook.com/

Create Task

Endpoint:
POST https://***********/api/public-api/create-task/
Request Body:
{
  "post_url": "https://www.facebook.com/username/posts/123456789",
  "type": "LIKE",
  "price": 2,
  "actions_required": 10,
  "social_network_code": "FACEBOOK"
}

Note: Price must be at least 2 points for LIKE action

Success Response (201):
{
  "id": 12345,
  "creator": 1,
  "type": "LIKE",
  "post_url": "https://www.facebook.com/username/posts/123456789",
  "price": 2,
  "actions_required": 10,
  "actions_completed": 0,
  "original_price": 20,
  "social_network": {
    "id": 1,
    "code": "FACEBOOK",
    "name": "Facebook"
  },
  "status": "ACTIVE",
  "bonus_actions": 2,
  "bonus_actions_completed": 0,
  "is_pinned": false,
  "created_at": "2024-12-25T10:30:00Z",
  "completed_at": null
}
Error Responses (400):
// Price below minimum for action type:
{
  "detail": "price: Ensure this value is greater than or equal to 2"
}

// Insufficient balance:
{
  "detail": "Insufficient balance to create task"
}

// Duplicate task exists:
{
  "detail": "A task with this URL and action type already exists",
  "existing_task_id": 12344
}

// Missing required field:
{
  "detail": "Missing required field: social_network_code"
}

Track Task Status

Endpoint:
GET https://***********/api/public-api/task-status/12345/

You can track multiple tasks at once: task-status/12345,12346,12347/

Success Response (200):
{
  "id": 12345,
  "creator": 1,
  "type": "LIKE",
  "post_url": "https://www.facebook.com/username/posts/123456789",
  "price": 2,
  "actions_required": 10,
  "actions_completed": 7,
  "original_price": 20,
  "social_network": {
    "id": 1,
    "code": "FACEBOOK",
    "name": "Facebook"
  },
  "status": "ACTIVE",
  "bonus_actions": 2,
  "bonus_actions_completed": 1,
  "created_at": "2024-12-25T10:30:00Z",
  "completed_at": null,
  "progress_percentage": 70,
  "remaining_actions": 3
}
Task Statuses:
  • ACTIVE - Task is being completed
  • COMPLETED - All actions finished
  • PAUSED - Temporarily stopped
  • DELETED - Cancelled by creator
Medium

Medium

Create and track tasks for Medium articles and profiles

Available Actions & Minimum Prices

CLAPMin: 2 points
COMMENTMin: 4 points
FOLLOWMin: 4 points
SAVEMin: 4 points

* Setting a price below the minimum will result in a validation error

URL Examples

Post URL:
https://medium.com/@username/article-title-123456
Profile URL:
https://medium.com/@username

Accepted URL Patterns

Make sure your URLs match these patterns:

Posts:
  • medium.com/@
  • /
Profiles:
  • medium.com/@

Create Task

Endpoint:
POST https://***********/api/public-api/create-task/
Request Body:
{
  "post_url": "https://medium.com/@username/article-title-123456",
  "type": "CLAP",
  "price": 2,
  "actions_required": 10,
  "social_network_code": "MEDIUM"
}

Note: Price must be at least 2 points for CLAP action

Success Response (201):
{
  "id": 12345,
  "creator": 1,
  "type": "CLAP",
  "post_url": "https://medium.com/@username/article-title-123456",
  "price": 2,
  "actions_required": 10,
  "actions_completed": 0,
  "original_price": 20,
  "social_network": {
    "id": 1,
    "code": "MEDIUM",
    "name": "Medium"
  },
  "status": "ACTIVE",
  "bonus_actions": 2,
  "bonus_actions_completed": 0,
  "is_pinned": false,
  "created_at": "2024-12-25T10:30:00Z",
  "completed_at": null
}
Error Responses (400):
// Price below minimum for action type:
{
  "detail": "price: Ensure this value is greater than or equal to 2"
}

// Insufficient balance:
{
  "detail": "Insufficient balance to create task"
}

// Duplicate task exists:
{
  "detail": "A task with this URL and action type already exists",
  "existing_task_id": 12344
}

// Missing required field:
{
  "detail": "Missing required field: social_network_code"
}

Track Task Status

Endpoint:
GET https://***********/api/public-api/task-status/12345/

You can track multiple tasks at once: task-status/12345,12346,12347/

Success Response (200):
{
  "id": 12345,
  "creator": 1,
  "type": "CLAP",
  "post_url": "https://medium.com/@username/article-title-123456",
  "price": 2,
  "actions_required": 10,
  "actions_completed": 7,
  "original_price": 20,
  "social_network": {
    "id": 1,
    "code": "MEDIUM",
    "name": "Medium"
  },
  "status": "ACTIVE",
  "bonus_actions": 2,
  "bonus_actions_completed": 1,
  "created_at": "2024-12-25T10:30:00Z",
  "completed_at": null,
  "progress_percentage": 70,
  "remaining_actions": 3
}
Task Statuses:
  • ACTIVE - Task is being completed
  • COMPLETED - All actions finished
  • PAUSED - Temporarily stopped
  • DELETED - Cancelled by creator
Dev.to

Dev.to

Create and track tasks for Dev.to articles and profiles

Available Actions & Minimum Prices

LIKEMin: 2 points
COMMENTMin: 4 points
SAVEMin: 4 points
FOLLOWMin: 4 points
UNICORNMin: 2 points

* Setting a price below the minimum will result in a validation error

URL Examples

Post URL:
https://dev.to/username/article-title-123
Profile URL:
https://dev.to/username

Accepted URL Patterns

Make sure your URLs match these patterns:

Posts:
  • dev.to/
  • /
Profiles:
  • dev.to/

Create Task

Endpoint:
POST https://***********/api/public-api/create-task/
Request Body:
{
  "post_url": "https://dev.to/username/article-title-123",
  "type": "LIKE",
  "price": 2,
  "actions_required": 10,
  "social_network_code": "DEVTO"
}

Note: Price must be at least 2 points for LIKE action

Success Response (201):
{
  "id": 12345,
  "creator": 1,
  "type": "LIKE",
  "post_url": "https://dev.to/username/article-title-123",
  "price": 2,
  "actions_required": 10,
  "actions_completed": 0,
  "original_price": 20,
  "social_network": {
    "id": 1,
    "code": "DEVTO",
    "name": "Dev.to"
  },
  "status": "ACTIVE",
  "bonus_actions": 2,
  "bonus_actions_completed": 0,
  "is_pinned": false,
  "created_at": "2024-12-25T10:30:00Z",
  "completed_at": null
}
Error Responses (400):
// Price below minimum for action type:
{
  "detail": "price: Ensure this value is greater than or equal to 2"
}

// Insufficient balance:
{
  "detail": "Insufficient balance to create task"
}

// Duplicate task exists:
{
  "detail": "A task with this URL and action type already exists",
  "existing_task_id": 12344
}

// Missing required field:
{
  "detail": "Missing required field: social_network_code"
}

Track Task Status

Endpoint:
GET https://***********/api/public-api/task-status/12345/

You can track multiple tasks at once: task-status/12345,12346,12347/

Success Response (200):
{
  "id": 12345,
  "creator": 1,
  "type": "LIKE",
  "post_url": "https://dev.to/username/article-title-123",
  "price": 2,
  "actions_required": 10,
  "actions_completed": 7,
  "original_price": 20,
  "social_network": {
    "id": 1,
    "code": "DEVTO",
    "name": "Dev.to"
  },
  "status": "ACTIVE",
  "bonus_actions": 2,
  "bonus_actions_completed": 1,
  "created_at": "2024-12-25T10:30:00Z",
  "completed_at": null,
  "progress_percentage": 70,
  "remaining_actions": 3
}
Task Statuses:
  • ACTIVE - Task is being completed
  • COMPLETED - All actions finished
  • PAUSED - Temporarily stopped
  • DELETED - Cancelled by creator
GitHub

GitHub

Create and track tasks for GitHub repositories and profiles

Available Actions & Minimum Prices

STARMin: 3 points
FOLLOWMin: 4 points
WATCHMin: 2 points

* Setting a price below the minimum will result in a validation error

URL Examples

Post URL:
https://github.com/username/repository
Profile URL:
https://github.com/username

Accepted URL Patterns

Make sure your URLs match these patterns:

Posts:
  • github.com/
  • /
Profiles:
  • github.com/

Create Task

Endpoint:
POST https://***********/api/public-api/create-task/
Request Body:
{
  "post_url": "https://github.com/username/repository",
  "type": "STAR",
  "price": 3,
  "actions_required": 10,
  "social_network_code": "GITHUB"
}

Note: Price must be at least 3 points for STAR action

Success Response (201):
{
  "id": 12345,
  "creator": 1,
  "type": "STAR",
  "post_url": "https://github.com/username/repository",
  "price": 3,
  "actions_required": 10,
  "actions_completed": 0,
  "original_price": 30,
  "social_network": {
    "id": 1,
    "code": "GITHUB",
    "name": "GitHub"
  },
  "status": "ACTIVE",
  "bonus_actions": 2,
  "bonus_actions_completed": 0,
  "is_pinned": false,
  "created_at": "2024-12-25T10:30:00Z",
  "completed_at": null
}
Error Responses (400):
// Price below minimum for action type:
{
  "detail": "price: Ensure this value is greater than or equal to 3"
}

// Insufficient balance:
{
  "detail": "Insufficient balance to create task"
}

// Duplicate task exists:
{
  "detail": "A task with this URL and action type already exists",
  "existing_task_id": 12344
}

// Missing required field:
{
  "detail": "Missing required field: social_network_code"
}

Track Task Status

Endpoint:
GET https://***********/api/public-api/task-status/12345/

You can track multiple tasks at once: task-status/12345,12346,12347/

Success Response (200):
{
  "id": 12345,
  "creator": 1,
  "type": "STAR",
  "post_url": "https://github.com/username/repository",
  "price": 3,
  "actions_required": 10,
  "actions_completed": 7,
  "original_price": 30,
  "social_network": {
    "id": 1,
    "code": "GITHUB",
    "name": "GitHub"
  },
  "status": "ACTIVE",
  "bonus_actions": 2,
  "bonus_actions_completed": 1,
  "created_at": "2024-12-25T10:30:00Z",
  "completed_at": null,
  "progress_percentage": 70,
  "remaining_actions": 3
}
Task Statuses:
  • ACTIVE - Task is being completed
  • COMPLETED - All actions finished
  • PAUSED - Temporarily stopped
  • DELETED - Cancelled by creator
Quora

Quora

Create and track tasks for Quora questions and profiles

Available Actions & Minimum Prices

UPVOTEMin: 4 points
COMMENTMin: 4 points
FOLLOWMin: 4 points
SHAREMin: 4 points

* Setting a price below the minimum will result in a validation error

URL Examples

Post URL:
https://www.quora.com/question-title
Profile URL:
https://www.quora.com/profile/username

Accepted URL Patterns

Make sure your URLs match these patterns:

Posts:
  • quora.com/
  • qr.com/
Profiles:
  • quora.com/profile/

Create Task

Endpoint:
POST https://***********/api/public-api/create-task/
Request Body:
{
  "post_url": "https://www.quora.com/question-title",
  "type": "UPVOTE",
  "price": 4,
  "actions_required": 10,
  "social_network_code": "QUORA"
}

Note: Price must be at least 4 points for UPVOTE action

Success Response (201):
{
  "id": 12345,
  "creator": 1,
  "type": "UPVOTE",
  "post_url": "https://www.quora.com/question-title",
  "price": 4,
  "actions_required": 10,
  "actions_completed": 0,
  "original_price": 40,
  "social_network": {
    "id": 1,
    "code": "QUORA",
    "name": "Quora"
  },
  "status": "ACTIVE",
  "bonus_actions": 2,
  "bonus_actions_completed": 0,
  "is_pinned": false,
  "created_at": "2024-12-25T10:30:00Z",
  "completed_at": null
}
Error Responses (400):
// Price below minimum for action type:
{
  "detail": "price: Ensure this value is greater than or equal to 4"
}

// Insufficient balance:
{
  "detail": "Insufficient balance to create task"
}

// Duplicate task exists:
{
  "detail": "A task with this URL and action type already exists",
  "existing_task_id": 12344
}

// Missing required field:
{
  "detail": "Missing required field: social_network_code"
}

Track Task Status

Endpoint:
GET https://***********/api/public-api/task-status/12345/

You can track multiple tasks at once: task-status/12345,12346,12347/

Success Response (200):
{
  "id": 12345,
  "creator": 1,
  "type": "UPVOTE",
  "post_url": "https://www.quora.com/question-title",
  "price": 4,
  "actions_required": 10,
  "actions_completed": 7,
  "original_price": 40,
  "social_network": {
    "id": 1,
    "code": "QUORA",
    "name": "Quora"
  },
  "status": "ACTIVE",
  "bonus_actions": 2,
  "bonus_actions_completed": 1,
  "created_at": "2024-12-25T10:30:00Z",
  "completed_at": null,
  "progress_percentage": 70,
  "remaining_actions": 3
}
Task Statuses:
  • ACTIVE - Task is being completed
  • COMPLETED - All actions finished
  • PAUSED - Temporarily stopped
  • DELETED - Cancelled by creator
Substack

Substack

Create and track tasks for Substack articles and profiles

Available Actions & Minimum Prices

RESTACKMin: 6 points
COMMENTMin: 4 points
SAVEMin: 4 points
FOLLOWMin: 4 points

* Setting a price below the minimum will result in a validation error

URL Examples

Post URL:
https://username.substack.com/p/article-title
Profile URL:
https://username.substack.com

Accepted URL Patterns

Make sure your URLs match these patterns:

Posts:
  • substack.com/p/
Profiles:
  • substack.com/

Create Task

Endpoint:
POST https://***********/api/public-api/create-task/
Request Body:
{
  "post_url": "https://username.substack.com/p/article-title",
  "type": "RESTACK",
  "price": 6,
  "actions_required": 10,
  "social_network_code": "SUBSTACK"
}

Note: Price must be at least 6 points for RESTACK action

Success Response (201):
{
  "id": 12345,
  "creator": 1,
  "type": "RESTACK",
  "post_url": "https://username.substack.com/p/article-title",
  "price": 6,
  "actions_required": 10,
  "actions_completed": 0,
  "original_price": 60,
  "social_network": {
    "id": 1,
    "code": "SUBSTACK",
    "name": "Substack"
  },
  "status": "ACTIVE",
  "bonus_actions": 2,
  "bonus_actions_completed": 0,
  "is_pinned": false,
  "created_at": "2024-12-25T10:30:00Z",
  "completed_at": null
}
Error Responses (400):
// Price below minimum for action type:
{
  "detail": "price: Ensure this value is greater than or equal to 6"
}

// Insufficient balance:
{
  "detail": "Insufficient balance to create task"
}

// Duplicate task exists:
{
  "detail": "A task with this URL and action type already exists",
  "existing_task_id": 12344
}

// Missing required field:
{
  "detail": "Missing required field: social_network_code"
}

Track Task Status

Endpoint:
GET https://***********/api/public-api/task-status/12345/

You can track multiple tasks at once: task-status/12345,12346,12347/

Success Response (200):
{
  "id": 12345,
  "creator": 1,
  "type": "RESTACK",
  "post_url": "https://username.substack.com/p/article-title",
  "price": 6,
  "actions_required": 10,
  "actions_completed": 7,
  "original_price": 60,
  "social_network": {
    "id": 1,
    "code": "SUBSTACK",
    "name": "Substack"
  },
  "status": "ACTIVE",
  "bonus_actions": 2,
  "bonus_actions_completed": 1,
  "created_at": "2024-12-25T10:30:00Z",
  "completed_at": null,
  "progress_percentage": 70,
  "remaining_actions": 3
}
Task Statuses:
  • ACTIVE - Task is being completed
  • COMPLETED - All actions finished
  • PAUSED - Temporarily stopped
  • DELETED - Cancelled by creator
Bluesky

Bluesky

Create and track tasks for Bluesky posts and profiles

Available Actions & Minimum Prices

LIKEMin: 2 points
COMMENTMin: 4 points
REPOSTMin: 4 points
FOLLOWMin: 4 points

* Setting a price below the minimum will result in a validation error

URL Examples

Post URL:
https://bsky.app/profile/username.bsky.social/post/123456
Profile URL:
https://bsky.app/profile/username.bsky.social

Accepted URL Patterns

Make sure your URLs match these patterns:

Posts:
  • bsky.app/profile/
  • /post/
Profiles:
  • bsky.app/profile/

Create Task

Endpoint:
POST https://***********/api/public-api/create-task/
Request Body:
{
  "post_url": "https://bsky.app/profile/username.bsky.social/post/123456",
  "type": "LIKE",
  "price": 2,
  "actions_required": 10,
  "social_network_code": "BLUESKY"
}

Note: Price must be at least 2 points for LIKE action

Success Response (201):
{
  "id": 12345,
  "creator": 1,
  "type": "LIKE",
  "post_url": "https://bsky.app/profile/username.bsky.social/post/123456",
  "price": 2,
  "actions_required": 10,
  "actions_completed": 0,
  "original_price": 20,
  "social_network": {
    "id": 1,
    "code": "BLUESKY",
    "name": "Bluesky"
  },
  "status": "ACTIVE",
  "bonus_actions": 2,
  "bonus_actions_completed": 0,
  "is_pinned": false,
  "created_at": "2024-12-25T10:30:00Z",
  "completed_at": null
}
Error Responses (400):
// Price below minimum for action type:
{
  "detail": "price: Ensure this value is greater than or equal to 2"
}

// Insufficient balance:
{
  "detail": "Insufficient balance to create task"
}

// Duplicate task exists:
{
  "detail": "A task with this URL and action type already exists",
  "existing_task_id": 12344
}

// Missing required field:
{
  "detail": "Missing required field: social_network_code"
}

Track Task Status

Endpoint:
GET https://***********/api/public-api/task-status/12345/

You can track multiple tasks at once: task-status/12345,12346,12347/

Success Response (200):
{
  "id": 12345,
  "creator": 1,
  "type": "LIKE",
  "post_url": "https://bsky.app/profile/username.bsky.social/post/123456",
  "price": 2,
  "actions_required": 10,
  "actions_completed": 7,
  "original_price": 20,
  "social_network": {
    "id": 1,
    "code": "BLUESKY",
    "name": "Bluesky"
  },
  "status": "ACTIVE",
  "bonus_actions": 2,
  "bonus_actions_completed": 1,
  "created_at": "2024-12-25T10:30:00Z",
  "completed_at": null,
  "progress_percentage": 70,
  "remaining_actions": 3
}
Task Statuses:
  • ACTIVE - Task is being completed
  • COMPLETED - All actions finished
  • PAUSED - Temporarily stopped
  • DELETED - Cancelled by creator
Threads

Threads

Create and track tasks for Threads posts and profiles

Available Actions & Minimum Prices

LIKEMin: 2 points
COMMENTMin: 4 points
REPOSTMin: 4 points
FOLLOWMin: 4 points
SAVEMin: 4 points

* Setting a price below the minimum will result in a validation error

URL Examples

Post URL:
https://www.threads.net/@username/post/123456789
Profile URL:
https://www.threads.net/@username

Accepted URL Patterns

Make sure your URLs match these patterns:

Posts:
  • threads.net/@
  • /post/
Profiles:
  • threads.net/@

Create Task

Endpoint:
POST https://***********/api/public-api/create-task/
Request Body:
{
  "post_url": "https://www.threads.net/@username/post/123456789",
  "type": "LIKE",
  "price": 2,
  "actions_required": 10,
  "social_network_code": "THREADS"
}

Note: Price must be at least 2 points for LIKE action

Success Response (201):
{
  "id": 12345,
  "creator": 1,
  "type": "LIKE",
  "post_url": "https://www.threads.net/@username/post/123456789",
  "price": 2,
  "actions_required": 10,
  "actions_completed": 0,
  "original_price": 20,
  "social_network": {
    "id": 1,
    "code": "THREADS",
    "name": "Threads"
  },
  "status": "ACTIVE",
  "bonus_actions": 2,
  "bonus_actions_completed": 0,
  "is_pinned": false,
  "created_at": "2024-12-25T10:30:00Z",
  "completed_at": null
}
Error Responses (400):
// Price below minimum for action type:
{
  "detail": "price: Ensure this value is greater than or equal to 2"
}

// Insufficient balance:
{
  "detail": "Insufficient balance to create task"
}

// Duplicate task exists:
{
  "detail": "A task with this URL and action type already exists",
  "existing_task_id": 12344
}

// Missing required field:
{
  "detail": "Missing required field: social_network_code"
}

Track Task Status

Endpoint:
GET https://***********/api/public-api/task-status/12345/

You can track multiple tasks at once: task-status/12345,12346,12347/

Success Response (200):
{
  "id": 12345,
  "creator": 1,
  "type": "LIKE",
  "post_url": "https://www.threads.net/@username/post/123456789",
  "price": 2,
  "actions_required": 10,
  "actions_completed": 7,
  "original_price": 20,
  "social_network": {
    "id": 1,
    "code": "THREADS",
    "name": "Threads"
  },
  "status": "ACTIVE",
  "bonus_actions": 2,
  "bonus_actions_completed": 1,
  "created_at": "2024-12-25T10:30:00Z",
  "completed_at": null,
  "progress_percentage": 70,
  "remaining_actions": 3
}
Task Statuses:
  • ACTIVE - Task is being completed
  • COMPLETED - All actions finished
  • PAUSED - Temporarily stopped
  • DELETED - Cancelled by creator

Getting Started

To start using the API, you need to:

  1. Have an upgraded account (API is available only for upgraded accounts)
  2. Generate an API key from your dashboard
  3. Choose a social network from the list above to see platform-specific documentation
  4. Start creating tasks programmatically
Go to Dashboard API