Upvote.club Public API

REST API to create and manage social engagement tasks — likes, comments, follows, upvotes, and more across 18 platforms.

Quick start

Three steps to your first API call.

Subscribe to MATE — API access requires an active MATE plan.
Generate an API key (upv_...) using the button below or from Dashboard → API.
Send authenticated requests with header X-API-Key: upv_...

Authentication

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

Header	Value
X-API-Key	upv_your_api_key

Your API key

Base URL

https://***********/api/public-api/

Endpoints

Method	Path	Description
POST		Create a new task to be completed by the community.
GET		Get the status and details of one or more tasks.
DELETE		Delete a task you created.

Pricing

Rule	Value
Global minimum per action	2 points
GitHub / Product Hunt	16 points per action
Meaningful COMMENT	64 points per action
Charge formula	price × actions_required
MATE plan task creation	Unlimited
MATE plan point discount	Up to 80% lower per-action cost vs pay-as-you-go
Refund on delete	Incomplete actions refunded

Platforms

Each platform supports specific action types. Pass social_network_code and type in create-task.

Platform	Code	Actions
	TWITTER	LIKE, COMMENT, FOLLOW, SAVE
	LINKEDIN	LIKE, COMMENT, FOLLOW, SAVE
	REDDIT	UPVOTE, COMMENT
	INSTAGRAM	LIKE, COMMENT, FOLLOW, SAVE
	TIKTOK	LIKE, COMMENT, FOLLOW, SAVE
	YOUTUBE	LIKE, COMMENT, SAVE, SUBSCRIBE
	FACEBOOK	LIKE, COMMENT, FOLLOW, SAVE
	MEDIUM	CLAP, COMMENT, FOLLOW, SAVE
	DEVTO	LIKE, SAVE, FOLLOW
	GITHUB	STAR, FOLLOW
	QUORA	UPVOTE, COMMENT, FOLLOW, SHARE
	SUBSTACK	RESTACK, COMMENT, SAVE, FOLLOW
	BLUESKY	LIKE, COMMENT, FOLLOW
	THREADS	LIKE, COMMENT, FOLLOW, SAVE
	MASTODON	BOOST, FAVORITE, REPLY, FOLLOW, SAVE
	PRODUCTHUNT	UPVOTE
	HACKERNEWS	UPVOTE
	INDIEHACKERS	UPVOTE, COMMENT

Request examples

Create task

Example

curl -X POST "https://api.upvote.club/api/public-api/create-task/" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your_api_key_here" \
  -d '{  "social_network_code": "TWITTER",  "type": "LIKE",  "post_url": "https://twitter.com/username/status/123456789",  "actions_required": 10,  "price": 2,  "is_pinned": false}'

Get task status

Example

curl -X GET "https://api.upvote.club/api/public-api/task-status/12345/" \
  -H "X-API-Key: your_api_key_here" \

Common errors

HTTP	Error
401	Invalid or missing API key
403	MATE plan required
400	Missing required fields
400	Minimum price per action is 2 points
400	Insufficient balance
400	Duplicate URL + type + platform

Related resources

MCP integrations

Open-source MCP servers for Cursor, Claude Desktop, and other MCP hosts.

upvote-club-mcp-core
Shared MCP server library (6 Public API tools)
upvote-club-mcp-local
Local MCP for Cursor, Claude Code, and stdio hosts
upvote-club-mcp-mcpb
Claude Desktop .mcpb one-click install
upvote-club-mcp-remote
Remote MCP for Claude.ai custom connector (HTTP)
upvote-club-mcp-apps
MCP Apps with inline task progress UI

Agent reference: API_REFERENCE.md

MATE subscription — required for API access
API key management
Base URL (production): https://api.upvote.club/api/public-api/