Odesk Bangladesh API Documentation

Integrate our micro-task and promotional services, manage user tasks, and facilitate payouts through the secure **Odesk Bangladesh** API.

Introduction

Welcome to the **Odesk Bangladesh** API documentation! This interface is designed for clients and partners who wish to programmatically submit tasks (e.g., social media likes, video views), manage campaign progress, or integrate our payment/star distribution features. All communication is handled via secure **HTTPS** connections.

Our base domain for all API calls is: https://api.odeskbd.com/v1

Authentication

Access to all endpoints is secured using a unique **API Key** provided to registered clients. You must include this key in the Authorization header of every request using the **Bearer Token** scheme. Your API key can be found in your client dashboard.

API Key Structure

Header Example
Authorization: Bearer YOUR_ODESKBD_API_KEY

Example Call (cURL)

bash
// Example: Checking account balance and limits
curl -H "Authorization: Bearer YOUR_API_KEY" \
     -H "Content-Type: application/json" \
     -X GET https://api.odeskbd.com/v1/client/status

Core Endpoints: Task Submission

POST /v1/tasks/submit

Submits a new micro-task (e.g., Facebook Like, YouTube View) to the Odesk Bangladesh platform for processing by our users.

Request Body Parameters

  • task_type (string, required): Type of task. e.g., FB_LIKE, YT_VIEW, VIDEO_PROMO.
  • link (string, required): The URL of the content (post, video, etc.) to be promoted.
  • quantity (number, required): The number of engagements/actions requested (min 10).
  • budget_per_task (number, required): The amount you are willing to pay per successful action (in BDT).
Request JSON (Submit Facebook Like Task)
{
  "task_type": "FB_LIKE",
  "link": "https://facebook.com/post/12345",
  "quantity": 100,
  "budget_per_task": 2.50
}

Response Body (Success)

Response JSON (201 Created)
{
  "status": "success",
  "campaign_id": "ODESK-COMP-4567",
  "estimated_cost": 250.00,
  "message": "Task successfully submitted and is awaiting approval."
}

Payment & Creator Star Endpoints

POST /v1/payouts/request

Allows partners to trigger a user payment/withdrawal request directly via API. This is typically used by internal systems or trusted partners.

Request Body Parameters

  • user_id (string, required): The internal ID of the Odesk Bangladesh user.
  • amount (number, required): The amount to be paid out (min 100 BDT).
  • method (string, required): Payout method: BKASH, NAGAD, ROCKET, or GOOGLE_PAY.
  • account_number (string, required): The recipient's mobile or account number.

POST /v1/creator/distribute-stars

Used to fulfill the "Facebook Stars" challenge requirement by transferring star value to a specified Facebook account/post.

Request Body Parameters

  • user_id (string, required): The internal ID of the Odesk Bangladesh user who earned the stars.
  • facebook_post_link (string, required): The URL of the Facebook content to receive the Stars.
  • star_value_bdt (number, required): The BDT equivalent value of Stars to be transferred.

Rate Limiting & Error Codes

All client accounts are subject to rate limits to ensure platform stability, typically set at **120 requests per minute**. Common error codes include:

  • 401 Unauthorized: Invalid or missing API key.
  • 400 Bad Request: Missing required parameters or invalid data format.
  • 403 Forbidden: Insufficient account funds or permissions to perform the requested action.
  • 429 Too Many Requests: Rate limit exceeded.