Skip to main content

​
Endpoint

POST https://api.ugc.inc/accounts/niche-switch

​
Overview

Switch the niche for one or more accounts by updating their keywords and description. This automatically resets warmup so the accounts will re-warm with the new keywords.
Niche switching resets all warmup progress for the affected accounts. They will need to re-warm from scratch with the new keywords.

​
Request Body

​
updates
array
required
Array of niche switch updates to apply. Each update object contains:

​
Response

​
data
object
Response object containing success summary and results
import { UGCClient } from 'ugcinc';

const client = new UGCClient({
  apiKey: 'YOUR_API_KEY'
});

const response = await client.accounts.nicheSwitch({
  updates: [
    {
      accountId: 'acc_123456',
      keywords: ['fitness', 'gym', 'workout', 'health'],
      description: 'Fitness and workout content, gym motivation videos'
    }
  ]
});

if (response.ok) {
  console.log(`Niche switch applied to ${response.data.successful} account(s)`);
}

curl -X POST https://api.ugc.inc/accounts/niche-switch \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "updates": [
      {
        "accountId": "acc_123456",
        "keywords": ["fitness", "gym", "workout", "health"],
        "description": "Fitness and workout content, gym motivation videos"
      }
    ]
  }'

{
  "ok": true,
  "code": 200,
  "message": "Niche switch submitted for 1 account(s). Warmup has been reset and will re-run with new keywords.",
  "data": {
    "message": "Niche switch submitted for 1 account(s). Warmup has been reset and will re-run with new keywords.",
    "successful": 1,
    "failed": 0,
    "results": [
      {
        "accountId": "acc_123456",
        "success": true
      }
    ]
  }
}