API Management

Gerenciamento de API

Crie e gerencie chaves de API para acesso programático à sua conta

Faça login na sua conta para gerar e gerenciar chaves API.

Documentação da API

Cabeçalho de Autenticação

Inclua sua chave de API em cada solicitação usando o cabeçalho X-API-Key:

X-API-Key: your_api_key_here

Limite de Taxa: 1.000 solicitações por hora por chave de API

Endpoints

Endpoints Padrão

POST

/jobs/add

Cria uma nova tarefa/campanha com os detalhes especificados. Requer tipo de conteúdo multipart/form-data. Defina approve_once_full como true para aprovar automaticamente todas as submissões e pagar os trabalhadores assim que a tarefa atingir o total de disponibilidades.

Solicitação

Content-Type: multipart/form-data

title: string (required)
description: string (required)
pay_rate: decimal (required)
total_availabilities: integer (required)
proof_required_description: string (required)
category: string (required)
sub_category: string (optional)
campaign_image: file (optional)
countries: array (optional. Omit to include all countries)
approve_once_full: boolean (optional, default: false. When true, all submissions are automatically approved and workers paid once the job reaches its total availabilities)

Resposta

// 201 Created
{
  "success": true,
  "message": "Job created successfully",
  "job": {
    "public_id": "123e4567-e89b-12d3-a456-426614174000",
    "title": "Test Job",
    "status": "Active",
    "pay_rate": "5.00",
    "total_availabilities": 10
  },
  "deduction_details": {
    "total_cost": "50.00",
    "commission": "5.00",
    "total_deducted": "55.00",
    "new_balance": "945.00"
  }
}

Respostas de Erro

400 — Invalid data or insufficient balance
401 — Invalid or missing API key
403 — Job rejected by legitimacy check

Exemplo de Código

import requests

# Create a job without image
job_data = {
    "title": "Complete a Survey",
    "description": "Fill out our 5-minute customer satisfaction survey",
    "pay_rate": "2.50",
    "total_availabilities": "100",
    "proof_required_description": "Submit a screenshot of the completion page",
    "category": "Survey",
    "sub_category": (None, "Customer Feedback"),
    "countries": (None, '["US", "CA", "GB"]'),  # Omit to include all countries
}
response = requests.post(
    "https://api.rapidworkers.io/jobs/add",
    headers={"X-API-Key": "your_api_key_here"},
    files=job_data
)
job = response.json()
print(f"Job created: {job['job']['public_id']}")

POST

/account/get_balance

Recupera o saldo atual da sua conta.

Solicitação

Content-Type: application/json
{} // Empty body

Resposta

// 200 OK
{
  "balance": "1000.00"
}

Respostas de Erro

401 — Invalid or missing API key
404 — User not found

Exemplo de Código

import requests

response = requests.post(
    "https://api.rapidworkers.io/account/get_balance",
    headers={"X-API-Key": "your_api_key_here"}
)
print(f"Balance: {response.json()['balance']}")

POST

/api/campaigns/{campaign_id}/submissions/{submission_id}/approve/

Aprova o envio de um trabalhador para sua campanha.

Parâmetros de Caminho

campaign_id (UUID)
submission_id (integer)

Solicitação

Content-Type: application/json

{
  "notes": "Great work!" // Optional
}

Resposta

// 200 OK
{
  "success": true,
  "message": "Submission approved successfully",
  "submission": {
    "id": 123,
    "user": "worker_username",
    "status": "Approved",
    "amount_paid": "5.00"
  }
}

Respostas de Erro

400 — Submission already processed or insufficient funds
403 — You don't own this campaign
404 — Submission not found

Exemplo de Código

import requests

campaign_id = "your_campaign_public_id"
submission_id = 456

response = requests.post(
    f"https://api.rapidworkers.io/api/campaigns/{campaign_id}/submissions/{submission_id}/approve/",
    headers={"X-API-Key": "your_api_key_here"},
    json={"notes": "Great work!"}
)
print(f"Submission approved: {response.json()}")

POST

/api/campaigns/{campaign_id}/submissions/{submission_id}/reject/

Rejeita o envio de um trabalhador com um motivo.

Parâmetros de Caminho

campaign_id (UUID)
submission_id (integer)

Solicitação

Content-Type: application/json

{
  "notes": "Does not meet requirements" // Required
}

Resposta

// 200 OK
{
  "success": true,
  "message": "Submission rejected",
  "submission": {
    "id": 123,
    "user": "worker_username",
    "status": "Rejected",
    "notes": "Does not meet requirements"
  }
}

Respostas de Erro

400 — Missing rejection reason
403 — You don't own this campaign
404 — Submission not found

Exemplo de Código

import requests

campaign_id = "your_campaign_public_id"
submission_id = 456

response = requests.post(
    f"https://api.rapidworkers.io/api/campaigns/{campaign_id}/submissions/{submission_id}/reject/",
    headers={"X-API-Key": "your_api_key_here"},
    json={"notes": "Screenshot does not show completion page"}
)
print(f"Submission rejected: {response.json()}")

POST

/api/campaigns/{campaign_id}/submissions/bulk_action/

Aprove todos os envios pendentes de uma campanha de uma só vez.

Parâmetros de Caminho

campaign_id (UUID)

Solicitação

Content-Type: application/json

{
  "notes": "Bulk action notes" // Optional
}

Resposta

// 200 OK
{
  "success": true,
  "message": "All submissions approved successfully.",
  "submissions": [
    { "id": 123, "status": "Approved", "user": "worker1" },
    { "id": 124, "status": "Approved", "user": "worker2" }
  ]
}

Respostas de Erro

403 — You don't own this campaign
404 — No pending submissions found

Exemplo de Código

import requests

campaign_id = "your_campaign_public_id"

# Bulk approve all pending
response = requests.post(
    f"https://api.rapidworkers.io/api/campaigns/{campaign_id}/submissions/bulk_action/",
    headers={"X-API-Key": "your_api_key_here"},
    json={"notes": "All submissions verified"}
)
print(f"Bulk action result: {response.json()}")

GET

/api/campaigns/

Recupera todas as campanhas do usuário autenticado, com filtragem opcional por status.

Solicitação

Query Parameters (optional):

status: string ("Active", "Pending", "Completed", "Canceled")
language: string (default: "en")

Resposta

// 200 OK
[
  {
    "jobId": "123e4567-e89b-12d3-a456-426614174000",
    "jobTitle": "Complete a Survey",
    "jobCategory": "Survey",
    "jobPay": "2.50",
    "jobLocation": "In",
    "jobCreatedAt": "2025-01-15T10:30:00Z",
    "jobStatus": "Active",
    "jobInstancesCompleted": 45,
    "jobTotalAvailabilities": 100,
    "jobSuccessRate": "40%",
    "description": "Fill out our customer satisfaction survey",
    "canceled": false,
    "remainingAvailabilities": 55,
    "pendingSubmissions": 12,
    "approvedSubmissions": 40,
    "rejectedSubmissions": 5
  }
]

Respostas de Erro

401 — Invalid or missing API key

Exemplo de Código

import requests

# List all campaigns
response = requests.get(
    "https://api.rapidworkers.io/api/campaigns/",
    headers={"X-API-Key": "your_api_key_here"}
)
campaigns = response.json()
for campaign in campaigns["results"]:
    print(f"{campaign['jobTitle']} - {campaign['jobStatus']}")

# Filter by status
response = requests.get(
    "https://api.rapidworkers.io/api/campaigns/?status=Active",
    headers={"X-API-Key": "your_api_key_here"}
)

GET

/api/campaigns/detail/{campaign_id}/

Recupera informações detalhadas sobre uma campanha específica, incluindo contagens de envios e disponibilidade restante.

Parâmetros de Caminho

campaign_id (UUID)

Solicitação

Query Parameters (optional):

language: string (default: "en")

Resposta

// 200 OK
{
  "jobId": "123e4567-e89b-12d3-a456-426614174000",
  "jobTitle": "Complete a Survey",
  "jobCategory": "Survey",
  "jobPay": "2.50",
  "jobLocation": "In",
  "jobCreatedAt": "2025-01-15T10:30:00Z",
  "jobStatus": "Active",
  "jobInstancesCompleted": 45,
  "jobTotalAvailabilities": 100,
  "jobSuccessRate": "40%",
  "description": "Fill out our customer satisfaction survey",
  "canceled": false,
  "remainingAvailabilities": 55,
  "pendingSubmissions": 12,
  "approvedSubmissions": 40,
  "rejectedSubmissions": 5
}

Respostas de Erro

401 — Invalid or missing API key
403 — You don't own this campaign
404 — Campaign not found

Exemplo de Código

import requests

campaign_id = "123e4567-e89b-12d3-a456-426614174000"
response = requests.get(
    f"https://api.rapidworkers.io/api/campaigns/detail/{campaign_id}/",
    headers={"X-API-Key": "your_api_key_here"}
)
campaign = response.json()
print(f"Remaining slots: {campaign['remaining_availabilities']}")
print(f"Pending: {campaign['pending_submissions']}")

GET

/api/campaigns/{campaign_id}/submissions/

Recupera todos os envios de uma campanha específica com metadados do trabalhador, filtragem opcional por status e paginação.

Parâmetros de Caminho

campaign_id (UUID)

Solicitação

Query Parameters (optional):

status: string ("Pending", "Approved", "Rejected")
search: string (search by worker name)
page: integer (default: 1)
rowsPerPage: integer (default: 1000)
language: string (default: "en")

Resposta

// 200 OK
{
  "count": 45,
  "next": null,
  "previous": null,
  "results": {
    "submissions": [
      {
        "submissionId": 123,
        "userId": "abc-def-123",
        "userName": "WorkerName",
        "userAvatar": "https://...",
        "campaignId": "123e4567-e89b-12d3-a456-426614174000",
        "campaignTitle": "Complete a Survey",
        "status": "Pending",
        "country_name": "United States",
        "submittedAt": "2025-01-16T14:30:00Z",
        "proof_text": "Completed the survey as requested",
        "images": [
          { 
            "id": "img_1", 
            "url": "https://...", 
            "thumbnailUrl": "https://..." 
          }
        ],
        "notes": null,
        "workerAccountAgeDays": 120,
        "workerApprovalRate": "85%",
        "workerTotalCompleted": 47
      }
    ],
    "pagination": {
      "totalCount": 45,
      "pageCount": 1,
      "currentPage": 1,
      "rowsPerPage": 1000
    }
  }
}

Respostas de Erro

401 — Invalid or missing API key
403 — You don't own this campaign
404 — Campaign not found

Exemplo de Código

import requests

campaign_id = "123e4567-e89b-12d3-a456-426614174000"

# List all submissions
response = requests.get(
    f"https://api.rapidworkers.io/api/campaigns/{campaign_id}/submissions/",
    headers={"X-API-Key": "your_api_key_here"}
)
data = response.json()
for sub in data["results"]["submissions"]:
    print(f"#{sub['submissionId']} - {sub['status']} - Age: {sub['worker_account_age_days']}d")

# Filter pending only
response = requests.get(
    f"https://api.rapidworkers.io/api/campaigns/{campaign_id}/submissions/?status=Pending",
    headers={"X-API-Key": "your_api_key_here"}
)

POST

/api/workers/block/

Bloqueia um trabalhador de enviar provas para qualquer uma das suas campanhas. Trabalhadores bloqueados não verão suas campanhas na lista de trabalhos.

Solicitação

Content-Type: application/json

{
  "worker_id": 12345 // Worker public ID
}

Resposta

// 201 Created
{
  "success": true,
  "message": "Worker blocked successfully",
  "worker_id": 12345
}

Respostas de Erro

400 — Missing worker_id, self-block attempt, or worker already blocked
401 — Invalid or missing API key
404 — Worker not found

Exemplo de Código

import requests

worker_id = 12345

response = requests.post(
    "https://api.rapidworkers.io/api/workers/block/",
    headers={"X-API-Key": "your_api_key_here", "Content-Type": "application/json"},
    json={"worker_id": worker_id}
)
print(f"Worker blocked: {response.json()}")

POST

/api/workers/unblock/

Desbloqueia um trabalhador previamente bloqueado, permitindo que ele veja e envie provas para suas campanhas novamente.

Solicitação

Content-Type: application/json

{
  "worker_id": 12345
}

Resposta

// 200 OK
{
  "success": true,
  "message": "Worker unblocked successfully",
  "worker_id": 12345
}

Respostas de Erro

400 — Missing worker_id or worker is not blocked
401 — Invalid or missing API key
404 — Worker not found

Exemplo de Código

import requests

worker_id = 12345

response = requests.post(
    "https://api.rapidworkers.io/api/workers/unblock/",
    headers={"X-API-Key": "your_api_key_here", "Content-Type": "application/json"},
    json={"worker_id": worker_id}
)
print(f"Worker unblocked: {response.json()}")

GET

/api/workers/blocked/

Recupera a lista de todos os trabalhadores que você bloqueou.

Solicitação

No request body required.

Resposta

// 200 OK
[
  {
    "worker_id": 12345,
    "worker_name": "WorkerName",
    "blocked_at": "2025-01-15T10:30:00Z"
  }
]

Respostas de Erro

401 — Invalid or missing API key

Exemplo de Código

import requests

response = requests.get(
    "https://api.rapidworkers.io/api/workers/blocked/",
    headers={"X-API-Key": "your_api_key_here"}
)
blocked = response.json()
for worker in blocked:
    print(f"Blocked: {worker['worker_name']} (ID: {worker['worker_id']})")

Endpoints de Trabalhos Pré-preenchidos

Endpoints simplificados para tarefas comuns de engajamento em redes sociais. Requer apenas um link e quantidade. Todas as tarefas pré-configuradas têm aprovação automática habilitada: as submissões são automaticamente aprovadas e os trabalhadores pagos assim que a tarefa atingir o total de disponibilidades.

POST

/api/jobs/facebook-likes/

Crie um trabalho simplificado para obter curtidas em postagens do Facebook. Requer apenas um link e quantidade. Preço automático: $0.05 por tarefa. As submissões são automaticamente aprovadas quando a tarefa está cheia.

Solicitação

Content-Type: application/json

{
  "link": "https://facebook.com/post/123", // Required
  "quantity": 50, // Required (minimum: 6)
  "countries": ["US", "GB"], // Omit to include all countries
  "language": "en", // Optional
  "approve_once_full": true // Optional (default: true). Auto-approve all submissions once job is full
}

Resposta

// 201 Created
{
  "success": true,
  "message": "Job created successfully",
  "job_id": "123e4567-e89b-12d3-a456-426614174000",
  "total_cost": "2.50"
}

Respostas de Erro

400 — Invalid data, insufficient balance, or quantity below minimum (6)
401 — Invalid or missing API key

Exemplo de Código

import requests

response = requests.post(
    "https://api.rapidworkers.io/api/jobs/facebook-likes/",
    headers={"X-API-Key": "your_api_key_here", "Content-Type": "application/json"},
    json={
        "link": "https://facebook.com/post/123",
        "quantity": 50  # Minimum: 6
    }
)
job = response.json()
print(f"Job created: {job['job_id']}")

POST

/api/jobs/facebook-shares/

Crie um trabalho simplificado para obter compartilhamentos em postagens do Facebook. Requer apenas um link e quantidade. Preço automático: $0.05 por tarefa. As submissões são automaticamente aprovadas quando a tarefa está cheia.

Solicitação

Content-Type: application/json

{
  "link": "https://facebook.com/post/123", // Required
  "quantity": 25, // Required (minimum: 6)
  "countries": ["US", "CA"], // Omit to include all countries
  "language": "en", // Optional
  "approve_once_full": true // Optional (default: true). Auto-approve all submissions once job is full
}

Resposta

// 201 Created
{
  "success": true,
  "message": "Job created successfully",
  "job_id": "123e4567-e89b-12d3-a456-426614174000",
  "total_cost": "1.25"
}

Respostas de Erro

400 — Invalid data, insufficient balance, or quantity below minimum (6)
401 — Invalid or missing API key

Exemplo de Código

import requests

response = requests.post(
    "https://api.rapidworkers.io/api/jobs/facebook-shares/",
    headers={"X-API-Key": "your_api_key_here", "Content-Type": "application/json"},
    json={
        "link": "https://facebook.com/post/123",
        "quantity": 25  # Minimum: 6
    }
)
job = response.json()
print(f"Job created: {job['job_id']}")

POST

/api/jobs/instagram-likes/

Crie um trabalho simplificado para obter curtidas em postagens do Instagram. Requer apenas um link e quantidade. Preço automático: $0.05 por tarefa. As submissões são automaticamente aprovadas quando a tarefa está cheia.

Solicitação

Content-Type: application/json

{
  "link": "https://instagram.com/ABC123", // Required
  "quantity": 100, // Required (minimum: 6)
  "countries": ["US", "GB"], // Omit to include all countries
  "language": "en", // Optional
  "approve_once_full": true // Optional (default: true). Auto-approve all submissions once job is full
}

Resposta

// 201 Created
{
  "success": true,
  "message": "Job created successfully",
  "job_id": "123e4567-e89b-12d3-a456-426614174000",
  "total_cost": "5.00"
}

Respostas de Erro

400 — Invalid data, insufficient balance, or quantity below minimum (6)
401 — Invalid or missing API key

Exemplo de Código

import requests

response = requests.post(
    "https://api.rapidworkers.io/api/jobs/instagram-likes/",
    headers={"X-API-Key": "your_api_key_here", "Content-Type": "application/json"},
    json={
        "link": "https://instagram.com/ABC123",
        "quantity": 100  # Minimum: 6
    }
)
job = response.json()
print(f"Job created: {job['job_id']}")

POST

/api/jobs/instagram-followers/

Crie um trabalho simplificado para ganhar seguidores do Instagram. Requer apenas um link e quantidade. Preço automático: $0.05 por tarefa. As submissões são automaticamente aprovadas quando a tarefa está cheia.

Solicitação

Content-Type: application/json

{
  "link": "https://instagram.com/username", // Required
  "quantity": 50, // Required (minimum: 6)
  "countries": ["US", "CA"], // Omit to include all countries
  "language": "en", // Optional
  "approve_once_full": true // Optional (default: true). Auto-approve all submissions once job is full
}

Resposta

// 201 Created
{
  "success": true,
  "message": "Job created successfully",
  "job_id": "123e4567-e89b-12d3-a456-426614174000",
  "total_cost": "2.50"
}

Respostas de Erro

400 — Invalid data, insufficient balance, or quantity below minimum (6)
401 — Invalid or missing API key

Exemplo de Código

import requests

response = requests.post(
    "https://api.rapidworkers.io/api/jobs/instagram-followers/",
    headers={"X-API-Key": "your_api_key_here", "Content-Type": "application/json"},
    json={
        "link": "https://instagram.com/username",
        "quantity": 50  # Minimum: 6
    }
)
job = response.json()
print(f"Job created: {job['job_id']}")

POST

/api/jobs/twitter-likes/

Crie um trabalho simplificado para obter curtidas em postagens do Twitter/X. Requer apenas um link e quantidade. Preço automático: $0.05 por tarefa. As submissões são automaticamente aprovadas quando a tarefa está cheia.

Solicitação

Content-Type: application/json

{
  "link": "https://twitter.com/user/status/123", // Required
  "quantity": 75, // Required (minimum: 6)
  "countries": ["US", "GB"], // Omit to include all countries
  "language": "en", // Optional
  "approve_once_full": true // Optional (default: true). Auto-approve all submissions once job is full
}

Resposta

// 201 Created
{
  "success": true,
  "message": "Job created successfully",
  "job_id": "123e4567-e89b-12d3-a456-426614174000",
  "total_cost": "3.75"
}

Respostas de Erro

400 — Invalid data, insufficient balance, or quantity below minimum (6)
401 — Invalid or missing API key

Exemplo de Código

import requests

response = requests.post(
    "https://api.rapidworkers.io/api/jobs/twitter-likes/",
    headers={"X-API-Key": "your_api_key_here", "Content-Type": "application/json"},
    json={
        "link": "https://twitter.com/user/status/123",
        "quantity": 75  # Minimum: 6
    }
)
job = response.json()
print(f"Job created: {job['job_id']}")

POST

/api/jobs/twitter-followers/

Crie um trabalho simplificado para ganhar seguidores do Twitter/X. Requer apenas um link e quantidade. Preço automático: $0.05 por tarefa. As submissões são automaticamente aprovadas quando a tarefa está cheia.

Solicitação

Content-Type: application/json

{
  "link": "https://twitter.com/username", // Required
  "quantity": 50, // Required (minimum: 6)
  "countries": ["US", "CA"], // Omit to include all countries
  "language": "en", // Optional
  "approve_once_full": true // Optional (default: true). Auto-approve all submissions once job is full
}

Resposta

// 201 Created
{
  "success": true,
  "message": "Job created successfully",
  "job_id": "123e4567-e89b-12d3-a456-426614174000",
  "total_cost": "2.50"
}

Respostas de Erro

400 — Invalid data, insufficient balance, or quantity below minimum (6)
401 — Invalid or missing API key

Exemplo de Código

import requests

response = requests.post(
    "https://api.rapidworkers.io/api/jobs/twitter-followers/",
    headers={"X-API-Key": "your_api_key_here", "Content-Type": "application/json"},
    json={
        "link": "https://twitter.com/username",
        "quantity": 50  # Minimum: 6
    }
)
job = response.json()
print(f"Job created: {job['job_id']}")

POST

/api/jobs/twitter-retweets/

Crie um trabalho simplificado para obter retweets do Twitter/X. Requer apenas um link e quantidade. Preço automático: $0.05 por tarefa. As submissões são automaticamente aprovadas quando a tarefa está cheia.

Solicitação

Content-Type: application/json

{
  "link": "https://twitter.com/user/status/123", // Required
  "quantity": 30, // Required (minimum: 6)
  "countries": ["US", "GB"], // Omit to include all countries
  "language": "en", // Optional
  "approve_once_full": true // Optional (default: true). Auto-approve all submissions once job is full
}

Resposta

// 201 Created
{
  "success": true,
  "message": "Job created successfully",
  "job_id": "123e4567-e89b-12d3-a456-426614174000",
  "total_cost": "1.50"
}

Respostas de Erro

400 — Invalid data, insufficient balance, or quantity below minimum (6)
401 — Invalid or missing API key

Exemplo de Código

import requests

response = requests.post(
    "https://api.rapidworkers.io/api/jobs/twitter-retweets/",
    headers={"X-API-Key": "your_api_key_here", "Content-Type": "application/json"},
    json={
        "link": "https://twitter.com/user/status/123",
        "quantity": 30  # Minimum: 6
    }
)
job = response.json()
print(f"Job created: {job['job_id']}")

POST

/api/jobs/trustpilot-reviews/

Crie um trabalho simplificado para obter avaliações do Trustpilot. Requer apenas um link e quantidade. Preço automático: $0.05 por tarefa. As submissões são automaticamente aprovadas quando a tarefa está cheia.

Solicitação

Content-Type: application/json

{
  "link": "https://trustpilot.com/review/example.com", // Required
  "quantity": 20, // Required (minimum: 6)
  "countries": ["US", "CA"], // Omit to include all countries
  "language": "en", // Optional
  "approve_once_full": true // Optional (default: true). Auto-approve all submissions once job is full
}

Resposta

// 201 Created
{
  "success": true,
  "message": "Job created successfully",
  "job_id": "123e4567-e89b-12d3-a456-426614174000",
  "total_cost": "1.00"
}

Respostas de Erro

400 — Invalid data, insufficient balance, or quantity below minimum (6)
401 — Invalid or missing API key

Exemplo de Código

import requests

response = requests.post(
    "https://api.rapidworkers.io/api/jobs/trustpilot-reviews/",
    headers={"X-API-Key": "your_api_key_here", "Content-Type": "application/json"},
    json={
        "link": "https://trustpilot.com/review/example.com",
        "quantity": 20  # Minimum: 6
    }
)
job = response.json()
print(f"Job created: {job['job_id']}")

POST

/api/jobs/9gag-upvotes/

Crie um trabalho simplificado para obter votos positivos do 9GAG. Requer apenas um link e quantidade. Preço automático: $0.05 por tarefa. As submissões são automaticamente aprovadas quando a tarefa está cheia.

Solicitação

Content-Type: application/json

{
  "link": "https://9gag.com/gag/abc123", // Required
  "quantity": 50, // Required (minimum: 6)
  "countries": ["US", "GB"], // Omit to include all countries
  "language": "en", // Optional
  "approve_once_full": true // Optional (default: true). Auto-approve all submissions once job is full
}

Resposta

// 201 Created
{
  "success": true,
  "message": "Job created successfully",
  "job_id": "123e4567-e89b-12d3-a456-426614174000",
  "total_cost": "2.50"
}

Respostas de Erro

400 — Invalid data, insufficient balance, or quantity below minimum (6)
401 — Invalid or missing API key

Exemplo de Código

import requests

response = requests.post(
    "https://api.rapidworkers.io/api/jobs/9gag-upvotes/",
    headers={"X-API-Key": "your_api_key_here", "Content-Type": "application/json"},
    json={
        "link": "https://9gag.com/gag/abc123",
        "quantity": 50  # Minimum: 6
    }
)
job = response.json()
print(f"Job created: {job['job_id']}")

POST

/api/jobs/youtube-likes/

Crie um trabalho simplificado para obter curtidas em vídeos do YouTube. Requer apenas um link e quantidade. Preço automático: $0.05 por tarefa. As submissões são automaticamente aprovadas quando a tarefa está cheia.

Solicitação

Content-Type: application/json

{
  "link": "https://youtube.com/watch?v=abc123", // Required
  "quantity": 100, // Required (minimum: 6)
  "countries": ["US", "CA"], // Omit to include all countries
  "language": "en", // Optional
  "approve_once_full": true // Optional (default: true). Auto-approve all submissions once job is full
}

Resposta

// 201 Created
{
  "success": true,
  "message": "Job created successfully",
  "job_id": "123e4567-e89b-12d3-a456-426614174000",
  "total_cost": "5.00"
}

Respostas de Erro

400 — Invalid data, insufficient balance, or quantity below minimum (6)
401 — Invalid or missing API key

Exemplo de Código

import requests

response = requests.post(
    "https://api.rapidworkers.io/api/jobs/youtube-likes/",
    headers={"X-API-Key": "your_api_key_here", "Content-Type": "application/json"},
    json={
        "link": "https://youtube.com/watch?v=abc123",
        "quantity": 100  # Minimum: 6
    }
)
job = response.json()
print(f"Job created: {job['job_id']}")

Tratamento de Erros

Todos os erros de API seguem um formato consistente:

{
  "error": "Error message describing what went wrong"
}

Códigos de Status HTTP Comuns:

200 Solicitação bem-sucedida
201 Recurso criado com sucesso
400 Dados de solicitação inválidos
401 Chave de API ausente ou inválida
403 Permissões insuficientes
404 Recurso não encontrado
429 Limite de taxa excedido (1.000/hora)
500 Erro do lado do servidor