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) |
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 |
---|---|
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 |