---
title: "Repurpose a URL or block of text into platform-specific post variants"
method: POST
path: "/contentripple"
tags: ["ContentRipple"]
---

# Repurpose a URL or block of text into platform-specific post variants

`POST /contentripple`

## Request

- Base URL: `https://api.misar.io/post`
- URL: `https://api.misar.io/post/contentripple`
- Auth: API key in header `Authorization`

Parses the source (fetches and extracts a URL, or uses pasted text directly), then generates one variant per requested platform. Persists both the parsed source and the generated variants. Rate limit: 10 requests/minute.

## Request body

- ContentrippleRequest
  - `sourceType` 'url' | 'text' | 'docforge' | 'rss', required
  - `sourceUrl` string, uri: Required when sourceType is url.
  - `rawContent` string: Required when sourceType is text or docforge.
  - `platforms` string[]: Defaults to every supported platform when omitted.
  - `tone` string

## Response `201`

Parsed source + generated variants.

- ContentrippleResponse
  - `source` object, required
    - `id` string, uuid
    - `source_type` string
    - `source_url` string, uri, nullable
    - `title` string
    - `core_message` string
    - `key_quotes` string[]
    - `stats` unknown
    - `cta` string, nullable
  - `variants` object[], required
    - `id` string, uuid
    - `platform` string
    - `content` string
    - `hashtags` string[]
    - `tone` string
    - `status` 'generated'

## Other responses

- `400`: Validation failed, or neither `sourceUrl` nor `rawContent` was provided for a `text`/`docforge` source.
- `401`: Missing, malformed, revoked, or invalid API key/session.
- `402`: No active plan (`code: "plan_limit_exceeded"`, `reason: "no_active_plan"`, with the plan offer), or the plan's monthly repurpose limit was reached.
- `403`: The API key lacks the scope this operation requires (`code: "insufficient_scope"`, `required_scope`).
- `429`: Per-user, per-route rate limit exceeded for this endpoint.

---

[API](https://skmtc.dev/misarpost/apis/misarpost-api.md) · [All operations](https://skmtc.dev/misarpost/apis/misarpost-api/llms.txt) · [OpenAPI document](https://skmtc.dev/misarpost/apis/misarpost-api/revisions/deec26db1305?raw)