View-script Configuratie

Deze pagina documenteert de configuratieparameters voor het view-script.

Overzicht

Het view-script opent een bericht op TikTok of Instagram en bekijkt het voor een configureerbare duur — handig voor het verhogen van kijktijd/impressies. Met meerdere doel-URLs via de API, wordt één taak per doel-URL aangemaakt. Stuur timing met de start_time parameter.

Scriptconfiguratie (script_config)

Configuratieparameters voor het view-script:

Parameters

Parameter	Type	Vereist	Standaard	Beschrijving
target_post_urls	string[]	Ja*	[]	Array van doel-URLs om te bekijken (één taak per URL)
target_post_url	string	Ja*	""	Enkelvoudige doel-URL of meerdere URLs gescheiden door regeleinden/komma's
view_duration	integer	Nee	10	Seconden om het bericht te bekijken
view_durations	integer[]	Nee	—	[min, max] bereik in seconden; een willekeurige waarde binnen het bereik wordt gebruikt. Heeft prioriteit boven view_duration

notitie

Ofwel target_post_urls-array of target_post_url-string moet worden opgegeven. Als beide, heeft target_post_urls prioriteit.

Taak aanmaken

Met meerdere doel-URLs maakt de API één taak per doel-URL aan. Bijvoorbeeld: 3 URLs + 2 apparaten = 6 taken. Gebruik start_time om te bepalen wanneer taken starten.

Voorbeelden

Één bericht bekijken

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "view",
    "script_config": {
      "target_post_url": "https://www.tiktok.com/@username/video/1234567890"
    }
  }'

Bekijken met een vaste kijkduur

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "view",
    "script_config": {
      "target_post_url": "https://www.tiktok.com/@username/video/1234567890",
      "view_duration": 30
    }
  }'

Bekijken met een willekeurig kijkduurbereik

Een willekeurige kijktijd tussen 15 en 45 seconden per taak:

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "view",
    "script_config": {
      "target_post_urls": [
        "https://www.tiktok.com/@user1/video/111",
        "https://www.tiktok.com/@user2/video/222"
      ],
      "view_durations": [15, 45]
    }
  }'

Berichten bekijken via gebruikersnaamlijst

Maak view-taken voor specifieke accounts:

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "usernames": ["@my_account1", "@my_account2"],
    "script_name": "view",
    "script_config": {
      "target_post_url": "https://www.tiktok.com/@target/video/123",
      "view_duration": 20
    }
  }'

Instagram voorbeeld

Dezelfde API werkt voor Instagram berichten en reels:

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "view",
    "script_config": {
      "target_post_url": "https://www.instagram.com/reel/ABC123/",
      "view_durations": [10, 30]
    }
  }'

Reactie

{
  "code": 0,
  "message": "success",
  "data": {
    "task_ids": [501, 502],
    "created_count": 2
  }
}

URL-formaten

TikTok

https://www.tiktok.com/@username/video/1234567890123456
https://vm.tiktok.com/ABCDEFG/

Instagram

https://www.instagram.com/p/ABCDEFGHIJK/
https://www.instagram.com/reel/ABCDEFGHIJK/

Aanbevolen Procedures

1. Varieer de kijktijd: Gebruik view_durations in plaats van een vaste view_duration zodat elke weergave natuurlijker lijkt.

2. Plan taken: Gebruik de start_time parameter om weergaven over de tijd te spreiden.

3. Multi-account: Schakel enable_multi_account in om berichten te bekijken met meerdere accounts op hetzelfde apparaat.

Foutcodes

Code	Beschrijving
40001	Doel-URL ontbreekt
40003	Script niet ondersteund via API
40301	Pro+-abonnement vereist

Zie Ook

• Like-script Configuratie - Like posts
• Favorite-script Configuratie - Berichten opslaan in Favorieten
• Taakbeheer API - Taken aanmaken, beheren en opvragen
• Local API Overzicht - API-overzicht en snelstart