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"
  }
}