# ContentAPI

> Universal content extraction API for RAG pipelines, AI agents, and LLM applications.

ContentAPI extracts structured content from YouTube, web pages, Twitter/X, and Reddit through a single REST API. It includes built-in chunking for RAG, batch processing for up to 50 URLs, web search with optional content extraction, and an MCP server for direct integration with AI assistants.

## Endpoints

Base URL: https://api.getcontentapi.com/api/v1

### YouTube
- GET /youtube/transcript — Full transcript with timestamps. Params: url, lang.
- GET /youtube/metadata — Video metadata (title, channel, views, duration). Params: url.
- GET /youtube/languages — List available caption languages for a video. Params: url.

### Web
- GET /web/extract — Extract readable content with semantic structure tree. Params: url, expand.
- GET /web/metadata — Page metadata (title, description, Open Graph). Params: url.
- GET /web/search — Web search via DuckDuckGo/Brave, optionally extract content. Params: q, count, extract.

### Twitter/X
- GET /twitter/tweet — Tweet content, author, engagement metrics. Params: url.
- GET /twitter/thread — Full thread with all replies. Params: url.

### Reddit
- GET /reddit/post — Post content and comments. Params: url.

### Batch
- POST /batch — Process up to 50 URLs in parallel with auto-detected source type. Body: {"urls": [...]}.

### Universal Parameters
All content endpoints support: chunk_size (int), chunk_overlap (int).

## Authentication

Two methods (use either):
- Header: Authorization: Bearer sk_live_xxx
- Header: X-API-Key: sk_live_xxx

Get a free API key at https://getcontentapi.com (no credit card required).

## MCP Server

For Claude Desktop, Cursor, Windsurf, and other MCP-compatible tools:

```json
{
  "mcpServers": {
    "contentapi": {
      "command": "npx",
      "args": ["-y", "contentapi-mcp-server"],
      "env": {
        "CONTENTAPI_API_KEY": "sk_live_your_key_here"
      }
    }
  }
}
```

MCP tools: youtube_transcript, youtube_metadata, web_extract, web_metadata, web_search, twitter_tweet, twitter_thread, reddit_post, batch_extract.

## Pricing

| Plan       | Price      | Requests/Month | Rate Limit |
|------------|------------|----------------|------------|
| Free       | $0         | 5,000          | 10/min     |
| Pro        | $49/mo     | 100,000        | 300/min    |
| Enterprise | Custom     | Unlimited      | Custom     |

## Links

- Website: https://getcontentapi.com
- Documentation: https://getcontentapi.com/docs
- Pricing: https://getcontentapi.com/pricing
- MCP Package: https://npmjs.com/package/contentapi-mcp-server
- Full LLM Reference: https://getcontentapi.com/llms-full.txt