Konfiguration av Super Marketing Script

Den här sidan dokumenterar API-slutpunkterna för Super Marketing-skriptet. Till skillnad från andra skript skapas super marketing inte via den generiska POST /api/v1/task-slutpunkten — det körs på en återanvändbar datamängd av mål med egna dedikerade slutpunkter.

Översikt

En super marketing-kampanj kombinerar flera tillväxtåtgärder (följa, avfölja, rapportera, DM, boosta, masskommentera) i en enda körning över en pool av mål. Måldatamängden lagras som en dataset:

Datatyp — datamängden innehåller antingen usernames (TikTok/Instagram-handles) eller post_links (inläggs-URL:er).
Strategi — styr hur mål fördelas över dina enheter:
- shared_pool — varje vald enhet/konto behandlar alla mål.
- consume_once — mål delas upp över enheter och varje mål förbrukas en gång.

Det typiska flödet är:

Importera mål till en datamängd → få ett dataset_id.
Starta en kampanj som refererar till det dataset_id på en eller flera enheter.

Funktionskontroller (följa / DM / kommentera, etc.) och deras detaljerade inställningar läses från desktopappens sparade konfiguration (super_marketing_settings.json). Du kan åsidosätta dessa per körning genom att ange script_config i körförfrågan.

Licenskrav

Alla super marketing-slutpunkter kräver ett Pro, Team eller Business-plan, precis som resten av det lokala API:et.

Importera Datamängd

Skapa en ny datamängd eller lägg till mål i en befintlig.

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

Förfrågans body

Fält	Typ	Krävs	Standard	Beskrivning
dataset_id	integer	Nej	—	Befintligt dataset-id att lägga till i / ersätta. Utelämna eller använd `0` för att skapa en ny datamängd.
data_type	string	Ja	—	`usernames` eller `post_links`
strategy	string	Ja	—	`shared_pool` eller `consume_once`
entries	string[]	Ja*	`[]`	Mål som JSON-array. Har prioritet över `raw_text`.
raw_text	string	Ja*	—	Mål som en radbrytningseparerad sträng (alternativ till `entries`).
mode	string	Nej	`append`	`append` lägger till befintliga poster; `replace` rensar befintliga poster först.
label	string	Nej	—	Valfri läsbar etikett för datamängden.

anteckning

Ange mål via antingen entries eller raw_text. Dubbletter och tomma poster ignoreras. En enskild import är begränsad till 100 000 poster.

Exempel

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

Lägg till fler mål i en befintlig datamängd med radbrytningseparerad text:

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

Exempelsvar

{
  "code": 0,
  "message": "success",
  "data": {
    "dataset": {
      "stats": {
        "id": 7,
        "data_type": "usernames",
        "strategy": "shared_pool",
        "label": "Kampanj A mål",
        "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
    }
  }
}

Lista Datamängder

Hämta alla datamängder med förbrukningsstatistik.

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

Frågeparametrar

Parameter	Typ	Standard	Beskrivning
data_type	string	—	Valfritt filter: `usernames` eller `post_links`

Exempel

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

Exempelsvar

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

Hämta Datamängd

Hämta en datamängds statistik och en sida med poster.

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

Frågeparametrar

Parameter	Typ	Standard	Beskrivning
limit	integer	`50`	Poster per sida (max `500`)
offset	integer	`0`	Antal poster att hoppa över

Exempel

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

Rensa Datamängd

Ta bort alla poster från en datamängd. Datamängdsposten bevaras (och dess dataset_id förblir giltigt för framtida importer).

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

Exempel

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

Exempelsvar

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

Starta Kampanj

Starta en super marketing-kampanj på de angivna enheterna med en datamängds mål.

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

Förfrågans body

Fält	Typ	Krävs	Standard	Beskrivning
serials	string[]	Ja	`[]`	Enhetens serienummer att köra på
dataset_id	integer	Ja	—	Datamängd vars mål driver kampanjen
enable_multi_account	boolean	Nej	`false`	Skapa en uppgift per konto på varje enhet
merge_same_username_tasks	boolean	Nej	`false`	Packa alla mål för en enhet i en uppgift istället för en uppgift per mål
platform	string	Nej	—	Plattformsåsidosättning (`tiktok` / `instagram`)
min_interval	integer	Nej	`0`	Minsta minuter mellan förskjutna uppgiftsstarttider
max_interval	integer	Nej	`0`	Maximala minuter mellan förskjutna uppgiftsstarttider
start_time	string	Nej	—	Första uppgiftens starttid i `HH:MM`
rotate_proxy	boolean	Nej	`false`	Rotera enhetsproxyn innan körning
switch_account_method	string	Nej	—	Hur konton ska bytas i multikontolage
official_packages	string[]	Nej	`[]`	Begränsa körning till dessa officiella paket
clone_package_prefix	string	Nej	—	Begränsa körning till klonappar vars paketnamn börjar med detta prefix
script_config	object	Nej	—	Funktionskontroller / per-funktion inställningar som åsidosätter den desktop-sparade konfigurationen (se nedan)

Datatypen hämtas från datamängden

Du anger inte data_source_type i körförfrågan — kampanjen använder automatiskt datamängdens data_type (usernames eller post_links). Datamängder med inläggslänkar stöder bara funktionerna boost_posts och mass_comment.

`script_config`-åsidosättningar

script_config är valfritt. När det utelämnas använder kampanjen de funktionskontroller och inställningar du konfigurerade i desktopappen. Ange det för att köra en helt fristående kampanj eller för att åsidosätta specifika fält. Nycklar accepterar både camelCase och snake_case.

Fält	Typ	Beskrivning
access_method	string	Hur användarnamnsmål nås: `search` eller `direct`
features.follow_users	boolean	Följ varje mål
features.unfollow_users	boolean	Avfölja varje mål
features.report_account	boolean	Rapportera varje målkonto
features.send_dm	boolean	Skicka ett direktmeddelande till varje mål
features.boost_posts	boolean	Gilla / favorit / reosta / dela målets inlägg
features.mass_comment	boolean	Kommentera målets inlägg
follow_settings.boost_type	string	`follow` eller `unfollow`
dm_settings.message_contents	string	DM-text (radbrytningseparerad för flera varianter)
dm_settings.message_order	string	`random` eller `sequential`
dm_settings.insert_emoji	boolean	Infoga slumpmässig emoji i DM:en
dm_settings.generate_by_chatgpt	boolean	Generera DM:en med ChatGPT
dm_settings.chatgpt_prompt	string	Prompt som används vid generering av DM
dm_settings.chatgpt_settings	object	`{ url, api_key, model, system_prompt }`
post_settings.skip_posts_count	integer	Inlägg att hoppa över innan åtgärd (0–8, endast användarnamnskälla)
post_settings.max_posts_count	integer	Max inlägg att bearbeta per mål
post_settings.enable_like	boolean	Gilla inlägg
post_settings.enable_favorite	boolean	Lägg till inlägg i favoriter
post_settings.enable_repost	boolean	Reosta inlägg
post_settings.enable_share	boolean	Dela inlägg
post_settings.repeat_times	integer	Gånger att upprepa inläggsåtgärderna
post_settings.view_durations	integer[]	`[min, max]` sekunder att titta på varje inlägg
comment_settings.comment_content	string	Kommentartext (radbrytningseparerad för flera varianter)
comment_settings.comment_order	string	`random` eller `sequential`
comment_settings.insert_emoji	boolean	Infoga slumpmässig emoji i kommentaren
comment_settings.generate_by_chatgpt	boolean	Generera kommentaren med ChatGPT
comment_settings.chatgpt_settings	object	`{ url, api_key, model, system_prompt }`
task_finish_wait_time	integer	Sekunder att vänta innan avslut (förhindrar dataförlust)

Exempel

Minimal körning (använd desktop-sparade inställningar)

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

Fristående följa + DM-kampanj

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_contents": "Hey! Love your content 🙌\nGreat posts, keep it up!",
        "message_order": "random",
        "insert_emoji": true
      }
    }
  }'

Masskommentering på en inläggslänksdatamängd

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

Exempelsvar

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

created_count är antalet uppgifter som skapades. De väntande uppgifterna körs sedan på sina tilldelade enheter — spåra dem via Uppgiftshantering API.

Felsvar

HTTP-status	Kod	Beskrivning
400	40001	Ogiltiga parametrar
403	40301	Förbjuden — API-åtkomst kräver Pro+-plan
404	40401	Datamängd hittades inte
500	50001	Internt serverfel

Inga uppgifter skapades

Om körningen returnerar kod 40001 med meddelandet "No tasks created", verifiera att datamängden fortfarande har återstående mål (för consume_once-strategi) och att de valda enheterna är online.

Se Även

Lokalt API Översikt - API-översikt och snabbstart
Uppgiftshantering API - Spåra och hantera de skapade uppgifterna
Kontostatus-API - Fråga konto- och enhetsstatus

Översikt​

Importera Datamängd​

Förfrågans body​

Exempel​

Exempelsvar​

Lista Datamängder​

Frågeparametrar​

Exempel​

Exempelsvar​

Hämta Datamängd​

Frågeparametrar​

Exempel​

Rensa Datamängd​

Exempel​

Exempelsvar​

Starta Kampanj​

Förfrågans body​

script_config-åsidosättningar​

Exempel​

Minimal körning (använd desktop-sparade inställningar)​

Fristående följa + DM-kampanj​

Masskommentering på en inläggslänksdatamängd​

Exempelsvar​

Felsvar​

Se Även​

Översikt

Importera Datamängd

Förfrågans body

Exempel

Exempelsvar

Lista Datamängder

Frågeparametrar

Exempel

Exempelsvar

Hämta Datamängd

Frågeparametrar

Exempel

Rensa Datamängd

Exempel

Exempelsvar

Starta Kampanj

Förfrågans body

`script_config`-åsidosättningar

Exempel

Minimal körning (använd desktop-sparade inställningar)

Fristående följa + DM-kampanj

Masskommentering på en inläggslänksdatamängd

Exempelsvar

Felsvar

Se Även