# CreatorCrawl

> Social media MCP server and REST API for AI agents. OAuth MCP access for TikTok, Instagram, YouTube, LinkedIn, Twitter/X, Reddit, and Facebook data.

CreatorCrawl provides structured social media data through both a REST API and an MCP (Model Context Protocol) server. AI agents can access profiles, videos, comments, transcripts, trending content, ads, and search across 7 platforms. Pay-as-you-go credits that never expire. 50 free credits on signup.

## API

- REST API endpoint prefix: `https://api.creatorcrawl.com`. Send the API key in the `x-api-key` header.
- [Interactive API documentation](https://api.creatorcrawl.com/docs): Browse endpoints and test requests.
- [OpenAPI specification](https://api.creatorcrawl.com/openapi.json): Machine-readable API schema.

### TikTok Endpoints
- GET /tiktok/profile - Fetch a public TikTok profile by handle
- GET /tiktok/profile/videos - Get videos from a TikTok profile
- GET /tiktok/video - Get a single TikTok video by URL or ID
- GET /tiktok/video/comments - Get comments on a TikTok video
- GET /tiktok/video/transcript - Extract transcript from a TikTok video
- GET /tiktok/creator/transcripts - Bulk transcripts for a creator's recent videos
- GET /tiktok/user/followers - Get a user's followers
- GET /tiktok/user/following - Get accounts a user follows
- GET /tiktok/user/live - Get TikTok live stream status
- GET /tiktok/search/users - Search TikTok users by keyword
- GET /tiktok/search/hashtag - Search TikTok by hashtag
- GET /tiktok/search/keyword - Search TikTok by keyword
- GET /tiktok/search/top - Search top TikTok results across types
- GET /tiktok/get-trending-feed - Get the trending/For You feed by region
- GET /tiktok/videos/popular - Get popular TikTok videos
- GET /tiktok/creators/popular - Get popular TikTok creators
- GET /tiktok/hashtags/popular - Get popular TikTok hashtags
- GET /tiktok/songs/popular - Get popular TikTok songs
- GET /tiktok/song - Get TikTok song details
- GET /tiktok/song/videos - Get videos using a TikTok song

### Instagram Endpoints
- GET /instagram/profile - Full Instagram profile with stats
- GET /instagram/basic-profile - Basic Instagram profile info
- GET /instagram/user/posts - Get Instagram user posts
- GET /instagram/post - Get a single Instagram post
- GET /instagram/post/comments - Get comments on an Instagram post
- GET /instagram/user/reels - Get Instagram user reels
- GET /instagram/reels/search - Search Instagram reels
- GET /instagram/media/transcript - Extract transcript from Instagram video
- GET /instagram/user/highlights - Get Instagram story highlights for a user
- GET /instagram/user/highlight/detail - Get details of a story highlight
- GET /instagram/user/embed - Get Instagram embed data

### YouTube Endpoints
- GET /youtube/channel - Get YouTube channel details
- GET /youtube/channel/videos - Get YouTube channel videos
- GET /youtube/channel/shorts - Get YouTube channel shorts
- GET /youtube/video - Get YouTube video details
- GET /youtube/video/comments - Get YouTube video comments
- GET /youtube/video/transcript - Get YouTube video transcript
- GET /youtube/playlist - Get YouTube playlist
- GET /youtube/search - Search YouTube
- GET /youtube/search/hashtag - Search YouTube by hashtag
- GET /youtube/shorts/trending - Get trending YouTube shorts

### LinkedIn Endpoints
- GET /linkedin/profile - Get LinkedIn person profile
- GET /linkedin/company - Get LinkedIn company page
- GET /linkedin/company/posts - Get recent posts from a LinkedIn company
- GET /linkedin/post - Get a single LinkedIn post
- GET /linkedin/ads/search - Search LinkedIn Ad Library
- GET /linkedin/ad - Get details of a LinkedIn ad

### Twitter/X Endpoints
- GET /twitter/profile - Get Twitter/X profile
- GET /twitter/user/tweets - Get tweets from a user
- GET /twitter/tweet - Get a single tweet
- GET /twitter/tweet/transcript - Get transcript from a Twitter video tweet
- GET /twitter/community - Get Twitter community details
- GET /twitter/community/tweets - Get tweets from a Twitter community

### Reddit Endpoints
- GET /reddit/subreddit/details - Get subreddit details
- GET /reddit/subreddit/posts - Get posts from a subreddit
- GET /reddit/subreddit/search - Search within a subreddit
- GET /reddit/post/comments - Get comments on a Reddit post
- GET /reddit/search - Search Reddit across subreddits

### Facebook Endpoints
- GET /facebook/profile - Get a public Facebook page profile
- GET /facebook/profile/posts - Get posts from a Facebook page
- GET /facebook/profile/reels - Get reels from a Facebook page
- GET /facebook/profile/photos - Get photos from a Facebook page
- GET /facebook/profile/events - Get events published by a Facebook page
- GET /facebook/post - Get a Facebook post or reel
- GET /facebook/post/comments - Get comments on a Facebook post
- GET /facebook/post/comment/replies - Get replies to a Facebook comment
- GET /facebook/post/transcript - Get a Facebook video transcript
- GET /facebook/group - Get Facebook group details
- GET /facebook/group/posts - Get posts from a Facebook group
- GET /facebook/events - Get events from a Facebook city events page
- GET /facebook/events/search - Search Facebook events
- GET /facebook/event/details - Get Facebook event details
- GET /facebook/marketplace/search - Search Facebook Marketplace listings
- GET /facebook/marketplace/item - Get a Facebook Marketplace item
- GET /facebook/marketplace/location/search - Search Facebook Marketplace locations
- GET /facebook/adLibrary/ad - Get a Meta Ad Library ad
- GET /facebook/adLibrary/ad/transcript - Get a Meta Ad Library video ad transcript
- GET /facebook/adLibrary/search/ads - Search Meta Ad Library ads
- GET /facebook/adLibrary/company/ads - Get a company's Meta Ad Library ads
- GET /facebook/adLibrary/search/companies - Search Meta Ad Library companies

## Agent Skill

Install with `npx skills add creatorcrawl/creatorcrawl-skill`. The package includes API instructions, seven platform references, an API behavior guide, and five research workflows. Configure CREATORCRAWL_API_KEY in the agent environment. The agent calls the REST API directly with curl or an HTTP client; skill installation does not install the CLI or configure MCP. Add --global to install across projects. Node.js is needed only for the installer. The standalone CLI is installed separately via https://creatorcrawl.com/install.sh and supports browser OAuth without an API key.

- [Skill repository](https://github.com/creatorcrawl/creatorcrawl-skill): Complete maintained bundle and installation guide.
- [Agent setup](https://creatorcrawl.com/agents/): Skill and remote MCP setup.

## MCP Server

- [MCP endpoint](https://api.creatorcrawl.com/mcp): Streamable HTTP transport with browser-based OAuth, PKCE, dynamic client registration, and automatic token refresh. Add the URL without headers. API-key authentication remains available as a fallback.
- [Agents guide](https://creatorcrawl.com/agents/): CLI, MCP, and API setup for supported clients.

Works natively with Claude Desktop, Claude Code, Cursor, and any MCP-compatible client. 92 REST endpoints are exposed as MCP tools. Tools return the same normalized JSON envelopes as their corresponding REST endpoints. Credit cost varies by endpoint.

## Pricing

- Free: 50 credits, $0
- Starter: 5,000 credits, $29
- Pro: 20,000 credits, $99
- Scale: 100,000 credits, $299
- Enterprise: custom

Most endpoints cost 1 credit per request. Credits never expire.

## Free Tools

- [TikTok Transcript Extractor](https://creatorcrawl.com/free-tools/tiktok-transcript/)
- [TikTok Profile Viewer](https://creatorcrawl.com/free-tools/tiktok-profile/)
- [TikTok Comments Extractor](https://creatorcrawl.com/free-tools/tiktok-comments/)
- [YouTube Transcript Extractor](https://creatorcrawl.com/free-tools/youtube-transcript/)
- [YouTube Channel Viewer](https://creatorcrawl.com/free-tools/youtube-channel/)
- [YouTube Comments Extractor](https://creatorcrawl.com/free-tools/youtube-comments/)
- [Twitter Profile Viewer](https://creatorcrawl.com/free-tools/twitter-profile/)
- [Twitter Tweet Viewer](https://creatorcrawl.com/free-tools/twitter-tweet/)

## Links

- [Homepage](https://creatorcrawl.com/): Product overview and pricing.
- [API documentation](https://api.creatorcrawl.com/docs): Interactive REST API reference.
- [OpenAPI specification](https://api.creatorcrawl.com/openapi.json): Machine-readable API schema.
- [Agents documentation](https://creatorcrawl.com/agents/): Connect Codex, Claude, and other agents through the CLI, MCP, or REST API.
- [CreatorCrawl skill file](https://creatorcrawl.com/skills/creatorcrawl/SKILL.md): Machine-readable agent instructions.
- [Blog](https://creatorcrawl.com/blog/): Guides for social media APIs, scraping, and AI agents.
- [Pricing](https://creatorcrawl.com/#pricing): Current credit packages.
- [FAQ](https://creatorcrawl.com/faq/): Product, billing, API, and data questions.