# DansUGC - UGC Creator Marketplace & B-Roll API

> Authentic UGC reaction videos from real human creators, not AI. Instant B-Roll from $3/video or custom orders from $8/video. Full commercial rights. REST API + MCP integration for programmatic access. Includes a Posting API for connecting TikTok/Instagram accounts, scheduling content, and reading analytics.

> For the complete AI integration guide with request/response examples, code patterns, and MCP usage recipes, see: https://dansugc.com/llms-full.txt

## What is DansUGC?

DansUGC is a marketplace connecting brands with verified UGC (User Generated Content) creators who film authentic reaction videos. We offer two products: an instant B-Roll library with 2,000+ pre-recorded reactions, and custom video orders from 35+ verified creators. Our API enables platforms to integrate B-Roll search, purchase, and delivery directly into their products.

## Key Differentiators

- 100% Real Humans: Every video is filmed by verified human creators. No AI-generated content, deepfakes, or synthetic voices.
- Two Products: Instant B-Roll library (from $3/video) and custom orders (from $8/video).
- Fast Delivery: B-Roll is available for instant download. Custom orders delivered within 2-3 business days.
- Full Commercial Rights: Brands receive lifetime commercial rights to all videos.
- Developer-First API: REST API with semantic search, per-customer API keys, and MCP integration.

## API Overview

Base URL: `https://dansugc.com/api/v1`
Authentication: Bearer token with `dsk_` prefixed API keys.
Rate Limit: 60 requests/minute per key.

### REST Endpoints

| Method | Endpoint | Scope | Description |
|--------|----------|-------|-------------|
| GET | /broll | broll:read | List & search B-roll videos with filters and pagination |
| GET | /broll/:id | broll:read | Get single video details with pricing |
| POST | /broll/purchase | broll:purchase | Purchase videos, returns download URLs |
| GET | /broll/purchases | broll:billing | List purchases for billing reconciliation |
| GET | /broll/filters | broll:read | Get all unique filterable values (emotions, genders, locations, etc.) |
| POST | /keys | keys:manage | Create per-customer API key |
| GET | /keys | keys:manage | List customer keys |
| DELETE | /keys?id=:id | keys:manage | Revoke a customer key |

### Search Capabilities

- **Text Search**: `?search=happy+reaction` — Full-text search across title, description, attributes
- **Semantic Search**: `?semantic_search=woman+laughing+indoors` — AI-powered natural language search using embeddings with reranking
- Cannot combine both in one request

### Filters

- `emotion` — happy, surprised, excited, crying, etc.
- `gender` — male, female, mixed, non-binary, other
- `location` — indoor, outdoor, office, beach, etc.
- `age_range` — 18-24, 25-34, 35-44, 45-54, 55+
- `hair_color`, `outfit` — appearance filters
- `media_type` — video or image
- `model_id` — specific creator
- `min_virality`, `difficulty`, `min_difficulty`, `max_difficulty`
- `featured`, `is_daily_drop`

### Pagination

Page-based: `?page=1&limit=24` (max 100 for /broll, max 500 for /broll/purchases)
Response includes: `pagination.page`, `pagination.limit`, `pagination.total_pages`, `pagination.has_more`

### Per-Customer API Keys

Platforms serving multiple customers MUST use per-customer keys for purchase isolation. Root keys (with `keys:manage` scope) create customer keys via `POST /keys`. Each customer key gets isolated purchase history and deduplication.

## Posting API

Connect TikTok and Instagram accounts, upload content, schedule posts, and read cross-platform analytics.

Base URL: `https://dansugc.com/api/v1/posting`
Authentication: Same `dsk_` Bearer token as the B-Roll API — no extra scopes required.
Full docs with request/response examples: https://dansugc.com/llms-full.txt

### Posting Endpoints

| Method | Endpoint | Description |
|--------|----------|-------------|
| GET | /subscription | Check posting plan, status, and social set usage |
| GET | /social-sets | List social sets (groups of accounts) |
| POST | /social-sets | Create a social set |
| PATCH | /social-sets | Update a social set (name, color, icon, project assignment) |
| GET | /accounts | List connected TikTok/Instagram accounts with follower/view stats |
| GET | /posts | List all posts with status and account associations |
| POST | /posts | Create, schedule, or publish immediately to one or more accounts |
| PATCH | /posts/:id | Update post status, caption, or scheduled time |
| DELETE | /posts/:id | Delete a post |
| GET | /analytics | Cross-platform analytics: followers, engagement, chart data, top posts |

### ReelClaw Integration

ReelClaw agents can use the Posting API to:
1. Upload UGC b-roll + captions sourced from DansUGC
2. Schedule posts at optimal times across TikTok and Instagram
3. Read analytics to measure views growth and engagement after posting

## MCP Integration

DanSUGC provides a Model Context Protocol (MCP) server for AI assistant integration.

Endpoint: `https://dansugc.com/api/mcp`
Transport: Stateless Streamable HTTP
Auth: Same `dsk_` Bearer token as REST API

### MCP Tools

**B-Roll**
- `search_videos` — Search & browse B-roll with all filters
- `get_video` — Get video details by ID
- `purchase_videos` — Buy videos with credits
- `list_purchases` — View purchase history
- `get_balance` — Check account balance and spending
- `manage_customer_keys` — Create, list, revoke customer keys

**Posting**
- `check_posting_subscription` — Check plan status and social set usage
- `list_social_sets` — List account groups
- `create_social_set` — Create a new social set
- `list_posting_accounts` — List connected TikTok/Instagram accounts
- `create_post` — Create, schedule, or publish a post
- `list_posts` — View posts and their status
- `update_post` — Update a post's status, caption, or scheduled time
- `delete_post` — Permanently delete a post
- `get_posting_analytics` — Followers, engagement, views, chart data, top posts

**Social Intelligence** (ScrapCreators proxy, $0.02/request)
- `tiktok_search_videos` — Search TikTok by keyword
- `tiktok_user_videos` — Get user's TikTok videos
- `tiktok_search_users` — Find TikTok creators
- `instagram_search_reels` — Search Instagram Reels
- `instagram_user_reels` — Get user's Instagram Reels

### MCP Configuration

```json
{
  "mcpServers": {
    "dansugc": {
      "url": "https://dansugc.com/api/mcp",
      "headers": {
        "Authorization": "Bearer dsk_your_key"
      }
    }
  }
}
```

## ReelClaw — AI Agent Skill for UGC Reels at Scale

ReelClaw is a free, open-source AI agent skill that turns any coding agent (Claude Code, Cursor, Cline, Codex, etc.) into a short-form video factory.

Page: https://dansugc.com/skills/reelclaw
GitHub: https://github.com/dansugc/reelclaw

### What ReelClaw does

1. **Source UGC hooks** — AI-searches DansUGC for the right reaction clip (shocked, crying, laughing, etc.) that matches your content
2. **Research trends** — Uses DansUGC's TikTok/Instagram intelligence to find trending music, text hooks, and viral formats
3. **Analyze demos** — Gemini Vision watches your product recordings and picks the best 7–9 second clips automatically
4. **Assemble reels** — Gemini directs, FFmpeg cuts: hook + demo + text overlay + music = finished 15s reel
5. **Schedule & publish** — Posts to TikTok and Instagram via the DansUGC Posting API (same key, no extra setup)
6. **Track performance** — Reads analytics from DansUGC to find winners, then replicates the formula

### Install

```bash
npx skills add dansugc/reelclaw --all
```

### MCP Setup (single key for everything)

```json
{
  "mcpServers": {
    "dansugc": {
      "url": "https://dansugc.com/api/mcp",
      "headers": { "Authorization": "Bearer dsk_your_key" }
    }
  }
}
```

One `dsk_` key covers B-Roll search/purchase, social intelligence, AND post scheduling/analytics. No separate posting tool needed.

### Example agent prompts

- "Make me 5 reels for my wellness app. Use shocked reactions as hooks and my demos from ./demos/"
- "Schedule these reels to my TikTok and Instagram, 10 minutes apart starting at 6pm ET"
- "Check analytics — which of my last batch got the most views? Make more like those"
- "Reschedule tomorrow's post to Friday at 5pm and update the caption"

### MCP Tools used by ReelClaw

| Tool | Purpose |
|------|---------|
| `search_videos` | Find UGC reaction hooks by emotion, gender, style |
| `purchase_videos` | Buy clips, get download URLs for FFmpeg |
| `tiktok_search_videos` | Research trending formats and sounds |
| `instagram_search_reels` | Research Instagram trends |
| `create_post` | Schedule or publish the finished reel |
| `update_post` | Reschedule or edit caption |
| `list_posts` | Check scheduled queue |
| `get_posting_analytics` | Read views, engagement, top posts |

## Pricing

- B-Roll videos: $3-$25 per video based on difficulty tier
- Images: $3 flat
- Credit-based system with auto top-up available
- ScrapCreators proxy: $0.02 per request

## Products

### B-Roll Library
- 2,000+ pre-recorded UGC reaction videos and images
- From $3 per video
- Instant download after purchase
- Semantic search + 10+ attribute filters
- Preview videos before buying (watermarked)

### Custom Video Orders
- Choose from 35+ verified human creators
- From $8 per video
- 100% exclusive content, never resold
- Delivered within 2-3 business days

## Developer Resources

- Interactive API Docs: https://dansugc.com/docs
- Developer Guide: https://dansugc.com/developers
- Platform Integration Guide: https://dansugc.com/developers/platform
- OpenAPI Spec: https://dansugc.com/api/openapi.json
- API Key Management: https://dansugc.com/dashboard/api-keys

## Contact

- Website: https://dansugc.com
- Email: dan@dansugcmodels.com
- Twitter/X: @dansugc

## Additional Resources

- B-Roll Library: https://dansugc.com/broll
- Pricing: https://dansugc.com/pricing
- Creator Packages: https://dansugc.com/packages
- Blog: https://dansugc.com/blog
- Become a Creator: https://dansugc.com/apply