Süper Marketing Skript Yapılandırması

Bu sayfa, Süper Marketing skriptinin API endpoint'lerini belgeler. Diğer skriptlerin aksine, süper marketing genel POST /api/v1/task endpoint'i üzerinden oluşturulmaz — yeniden kullanılabilir bir hedef veri seti üzerinde çalışır ve kendine özgü özel endpoint'leri vardır.

Genel Bakış

Süper marketing kampanyası, bir hedef havuzunda birden fazla büyüme eylemini (takip et, takibi bırak, raporla, DM, güçlendir, toplu yorum) tek bir çalıştırmada birleştirir. Hedef havuzu bir veri seti olarak saklanır:

Veri tipi — veri seti usernames (TikTok/Instagram/Threads kullanıcı adları) veya post_links (gönderi URL'leri) içerir.
Strateji — hedeflerin cihazlarınıza nasıl dağıtılacağını kontrol eder:
- shared_pool — her seçili cihaz/hesap tüm hedefleri işler.
- consume_once — hedefler cihazlar arasında bölünür ve her biri bir kez tüketilir.

Threads profil gezintisi, takip/takipten çıkma, DM (hedef bir Mesaj butonu ortaya koyduysa), gönderi görüntüleme/beğenme/kaydetme/yeniden paylaşma ve yorumları destekler. SMS'e paylaşma Threads için eşdeğer bir iş akışına sahip olmadığından atlanır. Hesap raporlaması, Threads otomatik yol tarafından desteklenmeyen insan tarafından seçilen bir rapor nedeni gerektirdiğinden atlanır.

Tipik akış:

Hedefleri bir veri setine içe aktarın → dataset_id alın.
O dataset_id'yi bir veya daha fazla cihazda referans alan bir kampanya çalıştırın.

Özellik geçişleri (takip / DM / yorum vb.) ve ayrıntılı ayarlar masaüstü uygulamasında kaydedilen yapılandırmadan (super_marketing_settings.json) okunur. Çalıştırma isteğinde script_config göndererek bunları çalıştırma bazında geçersiz kılabilirsiniz.

Lisans Gereksinimi

Tüm süper marketing endpoint'leri, Yerel API'nin geri kalanı gibi Pro, Team veya Business planı gerektirir.

Veri Seti İçe Aktarma

Yeni bir veri seti oluşturun veya mevcut birine hedefler ekleyin.

Endpoint: POST /api/v1/super-marketing/dataset

Request Body

Alan	Tür	Gerekli	Varsayılan	Açıklama
dataset_id	integer	No	—	Eklemek/değiştirmek için mevcut veri seti ID'si. Yeni veri seti oluşturmak için `0` kullanın veya atlayın.
data_type	string	Yes	—	`usernames` veya `post_links`
strategy	string	Yes	—	`shared_pool` veya `consume_once`
entries	string[]	Yes*	`[]`	JSON dizisi olarak hedefler. `raw_text`'e göre önceliklidir.
raw_text	string	Yes*	—	Yeni satırla ayrılmış hedefler (`entries` alternatifi).
mode	string	No	`append`	`append` mevcut girişlere ekler; `replace` önce mevcut girişleri temizler.
label	string	No	—	Veri seti için isteğe bağlı okunabilir etiket.

not

Hedefleri entries veya raw_text aracılığıyla sağlayın. Yinelenen ve boş girişler yoksayılır. Tek bir içe aktarma 100.000 girişle sınırlıdır.

Örnek

curl -X POST http://localhost:50809/api/v1/super-marketing/dataset \
  -H "Content-Type: application/json" \
  -d '{
    "data_type": "usernames",
    "strategy": "shared_pool",
    "label": "Campaign A targets",
    "entries": ["@user_one", "@user_two", "@user_three"]
  }'

Yeni satırla ayrılmış metin kullanarak mevcut veri setine daha fazla hedef ekleyin:

curl -X POST http://localhost:50809/api/v1/super-marketing/dataset \
  -H "Content-Type: application/json" \
  -d '{
    "dataset_id": 7,
    "data_type": "usernames",
    "strategy": "shared_pool",
    "mode": "append",
    "raw_text": "@user_four\n@user_five\n@user_six"
  }'

Örnek Yanıt

{
  "code": 0,
  "message": "success",
  "data": {
    "dataset": {
      "stats": {
        "id": 7,
        "data_type": "usernames",
        "strategy": "shared_pool",
        "label": "Campaign A targets",
        "total": 3,
        "consumed": 0,
        "remaining": 3,
        "created_at": "2026-06-22 09:00:00",
        "updated_at": "2026-06-22 09:00:00"
      },
      "entries": [
        { "id": 1, "value": "@user_one", "consumed": false, "consumed_by": null, "consumed_at": null, "created_at": "2026-06-22 09:00:00", "updated_at": "2026-06-22 09:00:00" }
      ]
    },
    "summary": {
      "inserted": 3,
      "duplicates": 0,
      "skipped_empty": 0,
      "removed": 0,
      "truncated": 0
    }
  }
}

Veri Setlerini Listele

Tüketim istatistikleriyle tüm veri setlerini alın.

Endpoint: GET /api/v1/super-marketing/datasets

Query Parametreleri

Parametre	Tür	Varsayılan	Açıklama
data_type	string	—	İsteğe bağlı filtre: `usernames` veya `post_links`

Örnek

curl "http://localhost:50809/api/v1/super-marketing/datasets?data_type=usernames"

Örnek Yanıt

{
  "code": 0,
  "message": "success",
  "data": [
    {
      "id": 7,
      "data_type": "usernames",
      "strategy": "shared_pool",
      "label": "Campaign A targets",
      "total": 6,
      "consumed": 0,
      "remaining": 6,
      "created_at": "2026-06-22 09:00:00",
      "updated_at": "2026-06-22 09:05:00"
    }
  ]
}

Veri Setini Getir

Veri setinin istatistiklerini ve bir sayfa girişini alın.

Endpoint: GET /api/v1/super-marketing/dataset/{id}

Query Parametreleri

Parametre	Tür	Varsayılan	Açıklama
limit	integer	`50`	Sayfa başına girişler (maks. `500`)
offset	integer	`0`	Atlanacak girişler

Örnek

curl "http://localhost:50809/api/v1/super-marketing/dataset/7?limit=100&offset=0"

Veri Setini Temizle

Veri setindeki tüm girişleri kaldırın. Veri seti kaydı tutulur (ve dataset_id gelecekteki içe aktarmalar için geçerli kalır).

Endpoint: DELETE /api/v1/super-marketing/dataset/{id}

Örnek

curl -X DELETE http://localhost:50809/api/v1/super-marketing/dataset/7

Örnek Yanıt

{
  "code": 0,
  "message": "success",
  "data": { "cleared": true, "dataset_id": 7 }
}

Kampanya Çalıştır

Verilen cihazlarda, veri setinin hedeflerini kullanarak bir süper marketing kampanyası başlatın.

Endpoint: POST /api/v1/super-marketing/run

Request Body

Alan	Tür	Gerekli	Varsayılan	Açıklama
serials	string[]	Yes	`[]`	Çalıştırılacak cihaz seri numaraları
dataset_id	integer	Yes	—	Kampanyayı yönlendiren hedeflerin veri seti
enable_multi_account	boolean	No	`false`	Her cihazda hesap başına bir görev oluştur
merge_same_username_tasks	boolean	No	`false`	Hedef başına bir görev yerine cihazın tüm hedeflerini tek göreve paketle
platform	string	No	—	Platform geçersiz kılma (`tiktok` / `instagram`)
min_interval	integer	No	`0`	Kademeli görev başlangıç zamanları arasındaki minimum dakika
max_interval	integer	No	`0`	Kademeli görev başlangıç zamanları arasındaki maksimum dakika
start_time	string	No	—	`HH:MM` formatında ilk görev başlangıç zamanı
rotate_proxy	boolean	No	`false`	Çalıştırmadan önce cihaz proxy'sini döndür
switch_account_method	string	No	—	Çoklu hesap modunda hesap değiştirme yöntemi
official_packages	string[]	No	`[]`	Yürütmeyi bu resmi paketlerle sınırla
clone_package_prefix	string	No	—	Yürütmeyi paket adı bu önekle başlayan klon uygulamalarla sınırla
script_config	object	No	—	Masaüstünde kaydedilen yapılandırmayı geçersiz kılan özellik geçişleri/ayarlar

Veri tipi veri setinden alınır

Çalıştırma isteğinde data_source_type göndermezsiniz — kampanya otomatik olarak veri setinin data_type'ını (usernames veya post_links) kullanır. Post-link veri setleri yalnızca boost_posts ve mass_comment özelliklerini destekler.

`script_config` Geçersiz Kılmaları

script_config isteğe bağlıdır. Atlandığında kampanya masaüstü uygulamasında yapılandırdığınız özellik geçişlerini ve ayarları kullanır. Tamamen bağımsız bir kampanya çalıştırmak veya belirli alanları geçersiz kılmak için sağlayın. Anahtarlar hem camelCase hem de snake_case kabul eder.

Alan	Tür	Açıklama
access_method	string	Kullanıcı adı hedeflerine ulaşma yöntemi: `search` veya `direct`
features.follow_users	boolean	Her hedefi takip et
features.unfollow_users	boolean	Her hedefin takibini bırak
features.report_account	boolean	Her hedef hesabı raporla
features.send_dm	boolean	Her hedefe doğrudan mesaj gönder
features.boost_posts	boolean	Hedefin gönderilerini beğen/favori ekle/yeniden paylaş/paylaş
features.mass_comment	boolean	Hedefin gönderilerine yorum yap
follow_settings.boost_type	string	`follow` veya `unfollow`
dm_settings.message_format	string	`multiline` (varsayılan) veya `spintax` — aşağıdaki DM mesaj biçimleri bölümüne bakın
dm_settings.message_contents	string	DM metni. `multiline` biçiminde her satır ayrı bir mesajdır (`###` = mesaj içinde satır sonu); `spintax` biçiminde dizenin tamamı tek bir mesajdır (normal satır sonları, `{option1\|option2}` grupları). `{username}` ve `{sender_username}` desteklenir.
dm_settings.message_order	string	`random` veya `sequential` (yalnızca `multiline` biçimi için geçerlidir)
dm_settings.insert_emoji	boolean	DM'e rastgele emoji ekle
dm_settings.generate_by_chatgpt	boolean	DM'i ChatGPT ile oluştur
dm_settings.chatgpt_settings	object	`{ url, api_key, model, system_prompt }`
post_settings.skip_posts_count	integer	İşlem yapmadan önce atlanacak gönderi sayısı (0–8, yalnızca kullanıcı adı)
post_settings.max_posts_count	integer	Hedef başına işlenecek maksimum gönderi
post_settings.enable_like	boolean	Gönderileri beğen
post_settings.enable_favorite	boolean	Gönderileri favorilere ekle
post_settings.enable_repost	boolean	Gönderileri yeniden paylaş
post_settings.enable_share	boolean	Gönderileri paylaş
post_settings.repeat_times	integer	Gönderi eylemlerini tekrar sayısı
post_settings.view_durations	integer[]	Her gönderiyi izlemek için `[min, max]` saniye
comment_settings.comment_content	string	Yorum metni (birden fazla varyant için yeni satırla ayrılmış)
comment_settings.comment_order	string	`random` veya `sequential`
comment_settings.insert_emoji	boolean	Yoruma rastgele emoji ekle
comment_settings.generate_by_chatgpt	boolean	Yorumu ChatGPT ile oluştur
comment_settings.chatgpt_settings	object	`{ url, api_key, model, system_prompt }`
task_finish_wait_time	integer	Tamamlamadan önce beklenecek saniye (veri kaybını önler)

DM mesaj biçimleri

dm_settings.message_contents, gönderi açıklamalarının caption_format ile işlenmesiyle aynı şekilde dm_settings.message_format değerine göre işlenir:

Biçim	Şablonlar	Satır sonları	Rastgele varyasyon
`multiline` (varsayılan)	Boş olmayan her satır için bir tane, `message_order` ile seçilir	Satır içinde `###`	Satırlar arasında, `message_order` ile
`spintax`	Dizenin tamamı tek bir şablondur	Dize içindeki normal `\n`	`{option1\|option2}` grupları

{username} ve {sender_username}, spintax grupları çözülmeden önce değiştirilir; bu nedenle bir değişken hiçbir zaman tek seçenekli spintax grubu olarak işlenmez.

// multiline
"dm_settings": {
  "message_format": "multiline",
  "message_contents": "Hey {username}! Love your content 🙌\nHi {username}###Here is a video I made###v.example.com/{username}",
  "message_order": "sequential"
}

// spintax
"dm_settings": {
  "message_format": "spintax",
  "message_contents": "{Hi|Hello} {username}\n\nHere is a video I made\n\nv.example.com/{username}"
}

Örnekler

Minimal çalıştırma (masaüstünde kaydedilen ayarları kullan)

curl -X POST http://localhost:50809/api/v1/super-marketing/run \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1", "device_serial_2"],
    "dataset_id": 7
  }'

Bağımsız takip + DM kampanyası

curl -X POST http://localhost:50809/api/v1/super-marketing/run \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "dataset_id": 7,
    "enable_multi_account": true,
    "min_interval": 1,
    "max_interval": 3,
    "script_config": {
      "access_method": "search",
      "features": {
        "follow_users": true,
        "send_dm": true
      },
      "follow_settings": { "boost_type": "follow" },
      "dm_settings": {
        "message_format": "multiline",
        "message_contents": "Hey! Love your content 🙌\nGreat posts, keep it up!",
        "message_order": "random",
        "insert_emoji": true
      }
    }
  }'

Post-link veri setinde toplu yorum

curl -X POST http://localhost:50809/api/v1/super-marketing/run \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "dataset_id": 9,
    "merge_same_username_tasks": true,
    "script_config": {
      "features": { "mass_comment": true },
      "comment_settings": {
        "comment_content": "🔥🔥🔥\nAmazing!\nLove this",
        "comment_order": "random"
      }
    }
  }'

Örnek Yanıt

{
  "code": 0,
  "message": "success",
  "data": { "created_count": 6 }
}

created_count oluşturulan görev sayısıdır. Bekleyen görevler daha sonra atanmış cihazlarında diğer görevler gibi çalışır — Görev Yönetimi API aracılığıyla takip edin.

Hata Yanıtları

HTTP Durumu	Code	Açıklama
400	40001	Geçersiz parametreler
403	40301	Yasak — API erişimi Pro+ planı gerektirir
404	40401	Veri seti bulunamadı
500	50001	Dahili sunucu hatası

Görev oluşturulmadı

Çalıştırma 40001 kodu ve "No tasks created" mesajıyla dönerse, veri setinin hâlâ kalan hedefleri olduğunu (consume_once stratejisi için) ve seçilen cihazların çevrimiçi olduğunu doğrulayın.

Ayrıca Bakınız

Yerel API Genel Bakış - API genel bakış ve hızlı başlangıç
Görev Yönetimi API - Oluşturulan görevleri takip edin ve yönetin
Hesap Durumu API'si - Hesap ve cihaz durumunu sorgulayın

Genel Bakış​

Veri Seti İçe Aktarma​

Request Body​

Örnek​

Örnek Yanıt​

Veri Setlerini Listele​

Query Parametreleri​

Örnek​

Örnek Yanıt​

Veri Setini Getir​

Query Parametreleri​

Örnek​

Veri Setini Temizle​

Örnek​

Örnek Yanıt​

Kampanya Çalıştır​

Request Body​

script_config Geçersiz Kılmaları​

DM mesaj biçimleri​

Örnekler​

Minimal çalıştırma (masaüstünde kaydedilen ayarları kullan)​

Bağımsız takip + DM kampanyası​

Post-link veri setinde toplu yorum​

Örnek Yanıt​

Hata Yanıtları​

Ayrıca Bakınız​

Genel Bakış

Veri Seti İçe Aktarma

Request Body

Örnek

Örnek Yanıt

Veri Setlerini Listele

Query Parametreleri

Örnek

Örnek Yanıt

Veri Setini Getir

Query Parametreleri

Örnek

Veri Setini Temizle

Örnek

Örnek Yanıt

Kampanya Çalıştır

Request Body

`script_config` Geçersiz Kılmaları

DM mesaj biçimleri

Örnekler

Minimal çalıştırma (masaüstünde kaydedilen ayarları kullan)

Bağımsız takip + DM kampanyası

Post-link veri setinde toplu yorum

Örnek Yanıt

Hata Yanıtları

Ayrıca Bakınız