> ## Documentation Index
> Fetch the complete documentation index at: https://docs.appeeky.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

> Multi-channel social lead generation — scan communities for high-intent posts, score with AI, and approve replies before publishing.

**Growth Channels** is Appeeky's growth layer for organic distribution — community lead generation and visual social posting. It watches communities where your users hang out, surfaces posts worth engaging with, drafts replies you review, and publishes through connected accounts — starting with **Reddit**. **Pinterest** covers screenshot-to-pin marketing for your apps via the Social Media API.

***

## Channels

| Channel           | Status    | Docs                                                |
| ----------------- | --------- | --------------------------------------------------- |
| **Reddit**        | Available | [Reddit Growth](/docs/growth-channels-reddit)       |
| **Pinterest**     | Available | [Pinterest Growth](/docs/growth-channels-pinterest) |
| More integrations | Planned   | —                                                   |

Use `GET /v1/growth/channels` to discover which channels are enabled on a deployment and their config schemas. Each project is bound to one `channel` (`reddit` today).

***

## Shared concepts

Every channel shares the same core model:

### Projects

A **project** is your product's Growth configuration: target communities, intent thresholds, scan cadence, LLM budget, and draft rules. Create via bootstrap from an App Store app or manually.

### Opportunities (inbox)

An **opportunity** is a scored post worth replying to. The pipeline assigns an intent score, urgency (`must_reply` / `browse`), buyer stage, and an LLM-drafted reply. You **approve** or **dismiss** before anything is published.

### Scheduled posts

**Scheduled posts** are standalone channel posts (not thread replies) queued for a future time. A background worker dispatches due posts; you can also publish immediately.

### Review-first publishing

Inbox drafts are never auto-posted. You stay in control of tone, timing, and disclosure — especially important on communities with strict promo rules.

***

## How it works (all channels)

```
scan (cron or manual)  →  pre-filter  →  LLM intent score  →  draft reply  →  inbox (pending)
                                                                                    │
                                                                          approve / dismiss
                                                                                    │
                                                                          post or schedule
```

* **Hard dedupe** — each source post is processed once per project.
* **Per-project LLM budget** — auto-pauses scanning when the daily cap is hit.
* **Reply linter** — flags missing disclosure, generic openers, links, etc. Drafts are surfaced with warnings, not silently dropped.

***

## REST API surface (shared)

These endpoints are channel-agnostic; filter by `channel` or `projectId` where needed:

| Area             | Base path                    |
| ---------------- | ---------------------------- |
| Projects         | `/v1/growth/projects`        |
| Inbox            | `/v1/growth/opportunities`   |
| Scheduled posts  | `/v1/growth/scheduled-posts` |
| Channel registry | `/v1/growth/channels`        |

Channel-specific connect flows live under `/v1/growth/connect/{channel}/…` (Reddit today).

***

## MCP tools

Growth is exposed as `growth_*` tools on the Appeeky MCP server. See [MCP → Growth Channels](/docs/mcp#growth-channels-reddit-lead-generation).

***

## Channel guides

<CardGroup cols={2}>
  <Card title="Reddit Growth" icon="reddit" href="/docs/growth-channels-reddit">
    Subreddit scanning, Composio OAuth, inbox replies, scheduled posts, and REST reference.
  </Card>

  <Card title="Reddit account warmup" icon="fire" href="/docs/reddit-account-warmup">
    Build account trust before API posting so Reddit's spam filters don't remove your content.
  </Card>

  <Card title="Pinterest Growth" icon="pinterest" href="/docs/growth-channels-pinterest">
    Pins from app screenshots, board picker, scheduling, and screenshot automations.
  </Card>
</CardGroup>