---
title: "Remix a Post to Your Niche"
method: POST
path: "/api/v1/remixes"
---

# Remix a Post to Your Niche

`POST /api/v1/remixes`

## Request

- Base URL: `https://viraloutliers.com`
- URL: `https://viraloutliers.com/api/v1/remixes`
- Auth: HTTP bearer

Takes a post (pass a public post URL or an internal post id) plus a target niche/brand description, and produces an adapted content idea: rewritten title and description, segment-by-segment script, a short analysis of why the original went viral, and an execution checklist, the proven format transplanted into your niche. The URL does NOT need to be tracked: an unknown post is fetched and ingested automatically as part of the job, so any public TikTok/Instagram/YouTube link works with no crawl_profile round-trip. Asynchronous (~1–3 minutes, a few minutes longer for an untracked URL): returns a jobRef; poll get_remix_result until its "remix" field is populated (it returns status + result together). For video posts the remix auto-generates the transcript and visual analysis first, so quality no longer depends on you transcribing beforehand. Credits are refunded automatically if the remix fails.

Cost: 20 credits per call. Asynchronous: poll GET /api/v1/jobs/{jobRef}.

## Request body

- object
  - `url` string: Public post URL. The easy path when a user hands you a link they saw. Does not need to be tracked: unknown posts are ingested automatically.
  - `postId` string: Internal post id (from search results). Provide this or url.
  - `targetNiche` string, required: Your niche/brand/audience, 5–500 chars (e.g. "B2B SaaS founders selling analytics tools").
  - `tone` string: Preferred tone of voice for the adaptation.

## Response `200`

Success

- object

## Other responses

- `401`: Invalid or revoked API key (or, on free skills, no key sent); code key_suspended means the key was suspended when its account was claimed by the email owner and can be reactivated in Settings
- `402`: Payment required. Without an API key (billable skills only) the code is payment_required and error.payment.checkoutUrl (or, when no link is configured, error.payment.pageUrl at https://viraloutliers.com/api-access) buys a key without an account; with a key it is insufficient_credits and error.payment points at create_topup_link.
- `429`: Rate limited

---

[API](https://skmtc.dev/viraloutliers/apis/viral-outliers-agent-api.md) · [All operations](https://skmtc.dev/viraloutliers/apis/viral-outliers-agent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/viraloutliers/apis/viral-outliers-agent-api/revisions/0099977bd629?raw)