SocialEarning API Documentation
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),id (optional),link (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, stopandrefund) |
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 from all general orders placed on socialearning |
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) (Optional)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, stopandrefund).
id– Post ID (Required)type– (pause,resume,cancel, stopandrefund) (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 from all socialearning 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 |
|---|---|
| 200 | OK – Request was successful |
| 400 | Bad Request – Invalid input |
| 401 | Unauthorized – Invalid/missing token |
| 404 | Not Found – Resource does not exist |
| 500 | Internal Server Error – Try again later |