# Scrapall Social Data API & MCP Gateway > Unified social data extraction across 36 platforms without browser automation or official developer tokens. > Billed in credits per request (cached responses: 0 credits). Automated crypto payments in USDT (TRC20). ## Core Endpoints - GET /v1/youtube/video?url_or_id={id}: Get YouTube video metadata, views, description, and tags. - GET /v1/youtube/search?q={query}: Search YouTube videos by keyword. - GET /v1/tiktok/user?username={handle}: Get TikTok creator profile, followers, stats, and verified status. - GET /v1/tiktok/search_videos?q={query}&count={n}: Search public TikTok videos. - GET /v1/tiktok/hashtag?tag={tag}: TikTok hashtag total views, video count and top videos. - GET /v1/douyin/video?url_or_id={id}: Douyin video caption, hashtags, likes, comments, shares, author. - GET /v1/douyin/comments?url_or_id={id}&count={n}: Douyin video comments. - GET /v1/douyin/trending: Douyin hot-search board (what is trending in China). - GET /v1/douyin/search?q={query}: Douyin keyword suggestions + matching trending topics. - GET /v1/douyin/profile?sec_uid={sec_uid}: Douyin creator followers, likes, video count, recent videos. - GET /v1/instagram/user?username={handle}: Get Instagram profile info and follower metrics. - GET /v1/twitter/user?username={handle}: Get Twitter/X profile and follower metrics. - GET /v1/twitter/tweet?id_or_url={id}: Get single tweet text, author, and engagement. - GET /v1/telegram/channel?channel={handle}: Get public Telegram channel info and recent posts. - GET /v1/telegram/channel_posts?channel={handle}&limit={n}&before={id}: Get paginated Telegram channel posts. - GET /v1/telegram/post?channel={handle}&post_id={id}: Get single Telegram post metrics and text. - GET /v1/facebook/page?page={handle_or_url}: Get public Facebook page follower count, verification, and avatar. - GET /v1/facebook/group?group={handle_or_url}: Get public Facebook group name, description, and group ID. - GET /v1/google/keywords?q={seed_kw}&lang={en|vi}: Extract Google Autocomplete keywords & search intent. - GET /v1/google/search?q={query}&count={n}: Organic web search results (rank, title, clean URL, snippet). - GET /v1/ads/meta?q={brand}: Search Meta Ad Library for active competitor campaigns. - GET /v1/ads/google?query={brand}: Search competitor presence in Google Ad Transparency Center. - GET /v1/reddit/subreddit?r={sub}&sort=hot: Get top or hot posts from any subreddit. - GET /v1/reddit/search?q={query}: Search public Reddit discussions. - GET /v1/ecommerce/tiktok_shop?q={query}: Search products, prices, and IDs on TikTok Shop. - GET /v1/ecommerce/amazon_products?q={query}: Live Amazon product search with clean ASINs, ratings, and prices. - GET /v1/ecommerce/amazon_suggestions?q={prefix}: Real-time Amazon search demand autocomplete. - GET /v1/ecommerce/amazon_storefront?url_or_handle={handle}: Extract creator Amazon storefront and featured ASINs. - GET /v1/ecommerce/shopify?domain={domain}&limit={n}: Inspect public Shopify store catalog, prices, SKUs, inventory, and variants. - GET /v1/ecommerce/marketplace?platform={ebay|etsy|shopee|facebook_marketplace}&q={query}: Search across multi-marketplaces with Base64 URL decoding. - GET /v1/creator/email_finder?handle={h}&platform={p}: Find public business contact emails of a creator. - GET /v1/tasks/catalog: List synthesized multi-network intelligence tasks (ad_spy, price_tracker, influencer_vetting, brand_360). - GET /v1/tasks/{task_type}?target={brand_or_domain}: Execute multi-source synthesized task with smart caching. - GET /v1/tasks/history/{task_type}?target={brand}: Access append-only historical snapshot time-series data. - POST /v1/tasks/watch/create: Register automated diff detection and HMAC-signed webhook monitors. - GET /v1/account/analytics: Key usage telemetry, 30-day breakdown, and credit savings summary. - GET /v1/account/balance: Check API key credit balance and validity (Cost: 0 credits). - POST /v1/billing/order: Create payment order to buy credits using USDT (TRC20). ## MCP Server Run stdio MCP server for Claude Desktop, Claude Code, and Codex: `python -m app.mcp_server.server` Requires environment variables: - BRAND_API_BASE=http://127.0.0.1:8000 - BRAND_API_KEY=your_x_scapi_key