Build with the
Sharingtools API

Only pending jobs can be cancelled. Once a job reaches processing it cannot be stopped.

POST /api/v1/post-actions/jobs
Authorization: Bearer sht_your_key

{
  "post_url": "https://www.instagram.com/p/ABC123XYZ/",
  "action":   "like",
  "count":    10
}

// 201 Created
{
  "success": true,
  "data": {
    "id":           42,
    "post_url":     "https://www.instagram.com/p/ABC123XYZ/",
    "action":       "like",
    "count":        10,
    "comment_text": null,
    "status":       "pending",
    "scheduled_at": "2026-03-15T10:01:00Z",
    "created_at":   "2026-03-15T10:00:05Z"
  }
}

POST /api/v1/post-actions/jobs
Authorization: Bearer sht_your_key

{
  "target_username": "cristiano",
  "action":          "follow",
  "count":           5
}

// 201 Created — job queued for 5 accounts to follow @cristiano

GET /api/v1/post-actions/logs/42
Authorization: Bearer sht_your_key

{
  "success": true,
  "data": [
    {
      "id":              88,
      "schedule_id":     42,
      "post_url":        "https://www.instagram.com/p/ABC123XYZ/",
      "action":          "like",
      "requested_count": 10,
      "performed_count": 9,
      "status":          "partial",
      "message":         "1 account skipped (already liked)",
      "details": {
        "results": [
          { "account_id": 7,  "username": "acct_one",  "status": "success" },
          { "account_id": 12, "username": "acct_two",  "status": "skipped", "reason": "already liked" }
        ]
      },
      "started_at":  "2026-03-15T10:01:12Z",
      "finished_at": "2026-03-15T10:01:48Z"
    }
  ]
}

GET /api/v1/leads/schedules
Authorization: Bearer sht_your_key

{
  "status": "success",
  "data": {
    "items": [
      {
        "id":                      12,
        "account_id":              7,
        "task_name":               "fashion-followers-march",
        "status":                  "active",
        "is_active":               true,
        "is_running":              false,
        "targets":                 [{"type":"people_followers","value":"fashionnova","id":"123456789"}],
        "target_count":            1,
        "speed":                   3,
        "estimated_speed":         480,
        "estimated_speed_parsed":  9600,
        "analyzed_percentage":     34.5,
        "parser_data_type":        "username",
        "data_fields": {
          "nickname": true, "user_id": false, "user_link": false,
          "full_name": true, "is_business": false, "business_category": false,
          "city": false, "link": false, "profile_bio": false,
          "followers_count": true, "is_verified": false, "home_country": false,
          "whatsapp_number": false, "is_new_to_instagram": false,
          "is_new_to_instagram_30d": false
        },
        "filters": {
          "followers_min": 500, "followers_max": 50000,
          "followings_min": 0,  "followings_max": 0,
          "posts_min": 3,       "posts_max": 0,
          "last_posted_min": 0, "last_posted_max": 90
        },
        "language_filter": {
          "languages": [], "language_detection_notices": false
        },
        "telegram": {
          "analytics_enabled": false, "errors_enabled": false,
          "chat_id": 0, "delay": 0
        },
        "accelerators": {
          "enabled": false, "accounts": [],
          "stop_if_all_disconnected": false,
          "get_followers_limit": 0, "get_following_limit": 0,
          "get_hashtag_limit": 0,   "get_location_limit": 0,
          "get_liker_limit": 0,     "get_info_limit": 0
        },
        "custom_delays": {
          "enabled": false,
          "get_followers": 0, "get_following": 0,
          "get_hashtag": 0,   "get_location": 0,
          "get_info": 0,      "get_likers": 0
        },
        "schedule_date":    "2026-03-15 10:00:00",
        "end_date":         "2200-12-12 23:59:59",
        "last_action_date": "2026-03-15 11:42:00"
      }
    ],
    "total": 1, "page": 1, "per_page": 20
  }
}

GET /api/v1/leads/schedules/12/export?page=1&per_page=500
Authorization: Bearer sht_your_key

// 200 OK — paginated list of collected usernames:
{
  "status": "success",
  "data": {
    "items":    ["johndoe", "janesmith", "insta_user_99"],
    "total":    14872,
    "page":     1,
    "per_page": 500,
    "file_path": "data-parsed-by-fashionnova_acc.txt"
  }
}

// 404 if the parser has not produced a file yet:
{
  "status": "error",
  "message": "No exported leads file found for this schedule. The parser may not have run yet."
}

GET /api/v1/ai-dm/schedules
Authorization: Bearer sht_your_key

// 200 OK
{
  "status": "success",
  "data": {
    "items": [{
      "id": 7,
      "account_id": 42,
      "account_name": "my_brand_account",
      "status": "active",
      "is_active": true,
      "daily_pause": { "enabled": false, "from": null, "to": null },
      "cta": { "platform": "whatsapp", "username": "+1234567890", "spintax": null },
      "settings": {
        "system_prompt": "You are a helpful brand assistant...",
        "api_key_configured": true,
        "model": "gpt-4",
        "folder": "0",
        "max_per_conversation": 5,
        "max_per_day_requests": 200,
        "max_per_run_requests": 50,
        "max_per_day_messages": 100,
        "max_per_run_messages": 25,
        "max_time": 300
      },
      "schedule_date": "2026-03-15 08:00:00",
      "last_action_date": "2026-03-15 14:32:11"
    }],
    "total": 1, "page": 1, "per_page": 20
  }
}

GET /api/v1/ai-dm/threads/3/messages?page=1&per_page=20
Authorization: Bearer sht_your_key

// 200 OK
{
  "status": "success",
  "data": {
    "items": [
      { "id": 101, "thread_id": 3, "item_id": "340282...", "timestamp": "1710505200000000",
        "item_type": "text", "is_sent_by_us": false, "content": { "text": "Hey, do you ship to EU?" } },
      { "id": 102, "thread_id": 3, "item_id": "340282...", "timestamp": "1710505260000000",
        "item_type": "text", "is_sent_by_us": true,  "content": { "text": "Yes! We ship worldwide. ..." } }
    ],
    "total": 2, "page": 1, "per_page": 20
  }
}

GET /api/v1/welcomedm/schedules
Authorization: Bearer sht_your_key

// 200 OK
{
  "status": "success",
  "data": {
    "items": [{
      "id": 3,
      "account_id": 42,
      "is_active": true,
      "status": "active",
      "messages": [
        { "text": "Hey {username}, welcome! 👋 Check our latest drops at {link}" },
        { "text": "Thanks for following! Use code WELCOME10 for 10% off 🎉" }
      ],
      "message_count": 2,
      "speed": "auto",
      "daily_pause": { "enabled": true, "from": "22:00", "to": "08:00" },
      "settings": {
        "skip_opened": true,
        "mute_thread": false,
        "has_attachment": false,
        "debug_mode": false
      },
      "schedule_date": "2026-03-10 09:00:00",
      "end_date": null,
      "last_action_date": "2026-03-15 14:45:00"
    }],
    "total": 1, "page": 1, "per_page": 20
  }
}

// Log entry:
GET /api/v1/welcomedm/logs/55
{
  "status": "success",
  "data": {
    "id": 55, "account_id": 42,
    "status": "sent",
    "follower_id": "9876543210",
    "message": null, "details": null,
    "date": "2026-03-15 14:45:00"
  }
}

// Refresh cookies
POST /api/v1/accounts/42/refresh-cookies
Authorization: Bearer sht_your_key
// 200 OK
{ "status": "success", "data": { "account_id": 42 }, "message": "Cookies refreshed." }

// Change proxy (auto-allocate)
POST /api/v1/accounts/42/change-proxy
Authorization: Bearer sht_your_key
// 200 OK
{ "status": "success", "data": { "account_id": 42, "proxy": "socks5://1.2.3.4:1080" }, "message": "Proxy updated." }

// Bulk change proxy
POST /api/v1/accounts/change-proxy/bulk
Authorization: Bearer sht_your_key
Content-Type: application/json
{ "account_ids": [42, 43, 44] }
// 200 OK
{ "status": "success", "data": { "updated": 3, "results": [
  { "account_id": 42, "proxy": "socks5://1.2.3.4:1080" },
  { "account_id": 43, "proxy": "socks5://5.6.7.8:1080" },
  { "account_id": 44, "proxy": "socks5://9.10.11.12:1080" }
]}}

// Set public
POST /api/v1/accounts/42/set-public
// 200 OK
{ "status": "success", "data": { "account_id": 42, "is_private": false }, "message": "Account set to public." }

// 2FA backup codes
GET /api/v1/accounts/42/2fa-backup
// 200 OK
{ "status": "success", "data": { "backup_codes": ["12345678","23456789","34567890"] }}

// Bulk password update
POST /api/v1/accounts/password/bulk
Content-Type: application/json
{ "accounts": [
  { "account_id": 42, "password": "newpass1" },
  { "account_id": 43, "password": "newpass2" }
]}
// 200 OK
{ "status": "success", "data": { "updated": 2 }, "message": "Passwords updated." }

POST /api/v1/first-comment/schedules
Authorization: Bearer sht_your_key
Content-Type: application/json
{
  "account_id": 42,
  "targets": [
    { "username": "nike", "user_pk": "19038780" },
    { "username": "adidas", "user_pk": "17841400" }
  ],
  "comments": [
    "Amazing! 🔥",
    "{Love|Great|Stunning} this post! 👏",
    "So inspiring! 💯"
  ],
  "comment_mode": "random",
  "is_active": true
}

// 201 Created
{
  "status": "success",
  "data": {
    "id": 12,
    "account_id": 42,
    "is_active": true,
    "running": false,
    "comment_mode": "random",
    "targets": [
      { "username": "nike", "user_pk": "19038780" },
      { "username": "adidas", "user_pk": "17841400" }
    ],
    "comments": ["Amazing! 🔥", "{Love|Great|Stunning} this post! 👏", "So inspiring! 💯"],
    "schedule_date": "2026-03-24 10:05:30",
    "last_action_date": "2026-03-24 10:05:30"
  },
  "message": "Schedule created."
}

// List threads
GET /api/v1/inbox/threads?channel_type=dm&status=open
Authorization: Bearer sht_your_key

// 200 OK
{
  "status": "success",
  "data": {
    "threads": [{
      "thread_id": "42_dm_dF8xNzg0MTQ3NzQ0NDc5Mg",
      "account_id": 42,
      "channel_type": "dm",
      "participants": [{ "id": "178414", "username": "john_doe", "avatar": null }],
      "unread_count": 2,
      "last_message": { "content_type": "text", "content": "Hey, is this available?", "timestamp": "2026-03-24T09:12:00Z", "is_sent_by_us": false },
      "last_activity_at": "2026-03-24T09:12:00Z",
      "is_archived": false,
      "status": "open",
      "tags": [{ "id": 3, "name": "VIP", "color": "#f59e0b" }]
    }],
    "next_cursor": "eyJpZCI6NDJ9",
    "total": 1
  }
}

// Reply in thread
POST /api/v1/inbox/threads/42_dm_dF8xNzg0MTQ3NzQ0NDc5Mg/reply
Content-Type: application/json
{ "content": "Yes, still available! DM us for details 🙌" }

// 200 OK
{ "status": "success", "data": { "thread_id": "42_dm_dF8xNzg0MTQ3NzQ0NDc5Mg", "sent": true }, "message": "Reply sent." }

// Get primary inbox
GET /api/v1/direct/42/inbox?folder=0
Authorization: Bearer sht_your_key

// 200 OK
{
  "status": "success",
  "data": {
    "threads": [{
      "thread_id": "340282366841710300949128224619416664029",
      "thread_title": "jane_smith",
      "is_group": false,
      "unread_count": 1,
      "participants": [{ "id": "9876543210", "username": "jane_smith" }],
      "last_message": { "type": "text", "timestamp": 1711270800000000, "text": "Hi, do you ship internationally?" },
      "last_activity": 1711270800000000,
      "pending": false,
      "archived": false
    }],
    "next_cursor": "QVFEZ...",
    "pending_count": 3
  }
}

// Get messages in thread
GET /api/v1/direct/42/threads/340282366841710300949128224619416664029/messages
// 200 OK
{
  "status": "success",
  "data": {
    "thread_id": "340282366841710300949128224619416664029",
    "messages": [{
      "id": "29:1",
      "type": "text",
      "timestamp": 1711270800000000,
      "user_id": "9876543210",
      "text": "Hi, do you ship internationally?",
      "is_sent_by_me": false
    }],
    "next_cursor": null
  }
}

// Accept pending thread
POST /api/v1/direct/42/threads/340282366841710300949128224619416664029/accept
// 200 OK
{ "status": "success", "data": { "thread_id": "340282366841710300949128224619416664029" }, "message": "Thread accepted." }