​

Keyword Warmup

• implemented
• live verified
• allowed for unattended use

​

What It Does

• searches one or more keywords
• watches result videos
• optionally likes, saves, and comments based on configured probabilities

​

Minimal Request

{
  "request_id": "warmup-2026-03-22-001",
  "capability": "keyword_warmup",
  "mode": "manual",
  "target": {
    "routing": "direct",
    "phone_id": "phone_01",
    "account_id": "account_user095916355"
  },
  "inputs": {
    "keywords": ["healthy dinner ideas", "meal prep"],
    "videos_per_keyword": 2,
    "interaction_mode": "smart",
    "comment_probability": 0
  },
  "callback": {
    "url": "https://ugc-tracker.example.com/phonefarm/process-updates",
    "metadata": {}
  },
  "requested_by": {
    "system": "ugc-tracker",
    "user": "operator@example.com",
    "metadata": {}
  }
}

​

Inputs

​

Interaction Modes

​

Comment Rules

• either provide comment_plan
• or provide keyword_comment_plan_prompt

​

comment_plan rules

• must be an object
• keys must match the resolved keyword set exactly
• each keyword bucket must contain at least one non-empty comment string

{
  "healthy dinner ideas": [
    "this is actually useful",
    "saving this one for later"
  ],
  "meal prep": [
    "needed this reminder honestly",
    "this was way more practical than most meal prep tips"
  ]
}

​

Routing Guidance

• Use direct for agent-like or immediate single-target execution.
• Use queue when your control plane wants Phonefarm to materialize work later.
• Use group for explicit multi-target fanout.

​

Failure Cases To Expect

• duplicate keywords
• unknown interaction mode
• missing comment prompt when comments are enabled
• malformed comment plan

​

Read Next

• Capability Requests
• Capability Registry
• Errors and Idempotency