SocialEarning API Documentation

Register as an Advertiser to Generate Key
API Details
  • Base URL: https://socialearning.org/api
  • Allowed Methods: GET, POST
  • Response: JSON
  • Authentication: Token (Your Key)
Endpoints
Endpoint Method Parameters Response
/balance GET None Current balance and total withdrawal
/service/list GET None List of services and IDs
/order/list GET status (optional) All orders you have placed
/get/order GET id or link Order details for the given ID/Link
/update/order GET id, type (pause, resume, cancel) Status update response
/create/post POST Social_Media, link, rate_needed, custom_text (optional) Success message with order ID
/increase/audience POST id, rate_needed Success message with updated order
/search/order POST filt_data (required), social_media (optional) Filtered list of orders

Retrieves your current balance and total withdrawal.

https://socialearning.org/api/balance
Request
curl -X GET 'https://socialearning.org/api/balance' \
-H 'Authorization: Token YOUR_API_KEY'
Response
{
  "status": true,
  "data": {
    "Wallet_balance": "27839.00",
    "Total_deposit": "2254237.00"
  }
}

Retrieves all the active services.

curl -X GET "https://socialearning.org/api/service/list" \
-H "Authorization: Token YOUR_API_KEY"
{
  "status": true,
  "data": [
    {
      "id": 60,
      "Social_Media": "YOUTUBEMUSIC",
      "Type": "Music Like",
      "poster_price": "8.00",
      "partner_price": "5.00",
      "is_active": true,
      "poster_descriptions":"Service Instructions"
    }
    {
      "id": 60,
      "Social_Media": "TWITTRER POST",
      "Type": "Music Like",
      "poster_price": "8.00",
      "partner_price": "5.00",
      "is_active": false,
      "poster_descriptions":"Service Instructions"
    }
  ]
}

Creates a new order.

  • Social_Media – Service ID (Required)
  • link – Valid link (Required)
  • rate_needed – Audience count (Required)
  • custom_text – Custom text (Optional)
curl -X POST 'https://socialearning.org/api/create/post' \
-H 'Authorization: Token YOUR_API_KEY' \
-H 'Content-Type: application/json' \
--data-raw '{
  "Social_Media": "11",
  "link": "https://twitter.com/Social_Earning",
  "rate_needed": "50",
  "custom_text": "Good job \r\n Keep going"
}'
{
  "status": true,
  "message": "Order posted successfully",
  "data": {
    'id': 106, 
      'Social_Media': 11, 
      'status': 'approved', 
      'message': None, 
      'progressing': False, 
      'link': 'https://twitter.com/Social_Earning/', 
      'date_posted': '2023-04-19T09:29:51.826621Z', 
      'rate_needed': 510, 
      'rate_done': 0, 
      'amount_paid':1000.00
      'amount_refunded':0.00
      'custom_text': 'Good boy \r\n Bad boy Spending', 
      'order_method': 'API'
  }
}

Retrieves all the orders you have placed (paginated).

  • Status – (pending, approved, rejected, finished, cancel, paused)
  • link – Valid link (Optional)
  • id – Custom text (Optional)
curl -X GET 'https://socialearning.org/api/order/list' \
-H 'Authorization: Token YOUR_API_KEY'
{
"status":true or false,
"count":9434,
"total_pages":189,
"current_page_number":1,
"next":"https://socialearning.org/api/order/list?page=2",
"next_page_number":2,
"previous":null,
"previous_page_number":null,
'data': 
    [
    {
        'id': 106, 
        'Social_Media': 11, 
        'status': 'approved', 
        'message': None, 
        'progressing': True, 
        'link': 'https://twitter.com/Social_Earning/', 
        'date_posted': '2023-04-19T09:29:51.826621Z', 
        'rate_needed': 510, 
        'rate_done': 500, 
        'amount_paid':1000.00
        'amount_refunded':0.00
        'custom_text': 'Good boy \r\n Bad boy Spending', 
        'order_method': 'API'
    }, 
    {
        'id': 105, 
        'Social_Media': 11, 
        'status': 'pending', 
        'message': None, 
        'progressing': False, 
        'link': 'https://twitter.com/Social_Earning/status/1639208170282270720', 
        'date_posted': '2023-04-16T09:03:39.972090Z', 
        'rate_needed': 500, 
        'rate_done': 0, 
        'custom_text': '', 
        'order_method': 'API'
    },
    ]
}

Retrieves a post by ID or link.

  • id or link – Post id or the Post link (Required)
curl -X GET 'https://socialearning.org/api/get/order?id=106' \
-H 'Authorization: Token YOUR_API_KEY'
{
  "status": true,
  "data": {
    'id': 106, 
    'Social_Media': 11, 
    'status': 'approved', 
    'message': None, 
    'progressing': True, 
    'link': 'https://twitter.com/Social_Earning', 
    'date_posted': '2023-04-19T09:29:51.826621Z', '
    rate_needed': 510, 
    'rate_done': 500, 
    'custom_text': '', 
    'order_method': 'API'
  }
}

Update an order status (pause, resume, cancel).

  • id – Post ID (Required)
  • type – (pause,resume,cancel) (Required)
curl -X GET 'https://socialearning.org/api/update/order?id=106&type=pause' \
-H 'Authorization: Token YOUR_API_KEY'
{
  "status": true,
  "message": "Order paused successfully",
  "post_id": 106
}

Increase the rate needed for an existing order.

  • id – The id of the order you want you want to continue. (Required)
  • rate_needed – The amount of the audience you need more. (Required)
curl -X POST 'https://socialearning.org/api/increase/audience' \
-H 'Authorization: Token YOUR_API_KEY' \
-H 'Content-Type: application/json' \
--data-raw '{
  "id": "106",
  "rate_needed": "50"
}'
{
  "status": true,
  "message": "Order updated successfully",
  "post_id": 106
}

Search for orders using ID or link.

  • filt_data – it can be a post link or a post id. (Required)
  • social_media – Service ID (Optional)
curl -X GET 'https://socialearning.org/api/search/order?filt_data=instagram&social_media=1' \
-H 'Authorization: Token YOUR_API_KEY'
{
  "status":true or false,
  "count":9434,
  "total_pages":189,
  "current_page_number":1,
  "next":"https://127.0.0.1:9000/api/search/order?page=2",
  "next_page_number":2,
  "previous":null,
  "previous_page_number":null,
  'data': 
      [
      {
          'id': 106, 
          'Social_Media': 11, 
          'status': 'approved', 
          'message': None, 
          'progressing': True, 
          'link': 'https://twitter.com/Social_Earning/', 
          'date_posted': '2023-04-19T09:29:51.826621Z', 
          'rate_needed': 510, 
          'rate_done': 500, 
          'amount_paid':1000.00
          'amount_refunded':0.00
          'custom_text': 'Good boy \r\n Bad boy Spending', 
          'order_method': 'API'
      }, 
      {
          'id': 105, 
          'Social_Media': 11, 
          'status': 'pending', 
          'message': None, 
          'progressing': False, 
          'link': 'https://twitter.com/Social_Earning/status/1639208170282270720', 
          'date_posted': '2023-04-16T09:03:39.972090Z', 
          'rate_needed': 500, 
          'rate_done': 0, 
          'custom_text': '', 
          'order_method': 'API'
      },
      ]
}
Response Codes
Code Description
200OK – Request was successful
400Bad Request – Invalid input
401Unauthorized – Invalid/missing token
404Not Found – Resource does not exist
500Internal Server Error – Try again later