Social APIS Hub
About
The unified API for social media data - built for developers and AI agents.
Details
- Author
- socialapishub
- Categories
- Web Scraping, Other
Jump to
Setup
Install Social APIS Hub in your MCP client (Claude Desktop, Cursor, Windsurf, and others).
Repository: https://github.com/socialapishub/mcp-server
Follow the installation instructions in the repository README, then restart your MCP client.
Official SDKs:Python•JavaScript / TypeScript•Go
nano ~/Library/Application\ Support/Claude/claude_desktop_config.json
notepad %APPDATA%\Claude\claude_desktop_config.json
Method 1: Command Line Argument (Recommended for Claude Desktop)
{ "mcpServers": { "socialapis": { "command": "npx", "args": ["-y", "@socialapis/mcp", "YOUR_API_KEY"] } } }
# Set environment variable export SOCIALAPIS_API_KEY=your_api_key_here # Run without argument npx @socialapis/mcp
# Copy example file cp .env.example .env # Edit with your values nano .env
SOCIALAPIS_API_KEY=your_api_key_here MCP_PROXY_URL=https://mcp.socialapis.io
- Sign up atsocialapis.io
- Go toDashboard
- Copy your API key
- ReplaceYOUR_API_KEYin config
- 🌐Unified API- One interface for multiple platforms
- 🤖AI-First- Built for Claude, Cursor, and AI agents
- 📊Rich Data- Posts, comments, engagement metrics
- 🔍Advanced Filtering- Time ranges, pagination
- 🎯Simple Auth- No OAuth complexity
- ⚡Fast- Global edge network
- 🔒Secure- API keys stay local
47 tools across Facebook and Instagram. Every tool maps 1:1 to a REST endpoint onapi.socialapis.io— pricing notes in each tool description indicate per-call credit cost.
- facebook_get_page_id— Extract page ID from URL
- facebook_get_page_details— Page info, followers, likes, category. Setexact_followers_count=truefor the exact integer (charges 5 credits instead of 1)
- facebook_get_page_posts— Fetch posts withafter_time/before_timefor date filtering.limit3-9, charges scale perceil(returned / 3)
- facebook_get_page_videos— Page videos,limit6-12
- facebook_get_page_reels— Reels / short videos
- facebook_get_group_id— Extract group ID from URL
- facebook_get_group_details— Full details (members, description, rules)
- facebook_get_group_posts— Group posts, samelimit+ date filtering as page posts
- facebook_get_group_videos— Group videos with pagination
- facebook_get_post_id— Extract post ID from URL
- facebook_get_post_details— Reactions, comments count, shares, media
- facebook_get_post_details_extended— Extended fields:view counts(essential for reels / video posts), video URLs, music/audio metadata, author verification
- facebook_get_post_attachments— Full media attachments (5 credits per call)
- facebook_get_video_details— Video post metadata + stats
- facebook_get_post_comments— Top-level comments,limitup to 30
- facebook_get_comment_replies— Replies to a specific comment
- facebook_search_pages— Search pages by keyword + optional location filter
- facebook_search_people— Search public profiles by keyword
- facebook_search_locations— Look up Facebook location UIDs (for use in other endpoints)
- facebook_search_posts— Search posts by keyword, recency, location
- facebook_search_videos— Search Facebook Watch videos
Facebook — Ads Library (Meta Ad Transparency)
- facebook_ads_search— Search ads by keyword, country, status
- facebook_ads_page_details— All ads from a specific page
- facebook_ads_archive_details— Full ad archive details
- facebook_ads_keywords— Search ads by keyword
- facebook_ads_countries— List of supported country codes
- facebook_marketplace_search— Item search with location, price, category, condition filters
- facebook_marketplace_listing— Single listing details
- facebook_marketplace_seller— Seller profile + their listings
- facebook_marketplace_categories— Browse category hierarchy
- facebook_marketplace_city_coordinates— Lat/long for a city (for radius search)
- facebook_marketplace_vehicles— Vehicle-specific listing search
- facebook_marketplace_rentals— Rental property listings
- facebook_download_media— Direct download URL for FB media (images, videos)
- instagram_get_user_id— Resolve username → numeric ID
- instagram_get_profile_details— Profile info, follower count, bio, post count
- instagram_get_profile_posts— Recent posts from a profile
- instagram_get_profile_reels— Reels from a profile
- instagram_get_profile_highlights— Story highlights list
- instagram_get_highlight_details— Full content of a specific highlight
- instagram_get_post_id— Resolve post URL → ID
- instagram_get_post_details— Likes, comments, media, caption
- instagram_get_reels_feed— Reels feed for a profile
- instagram_get_reels_by_audio— Reels using a specific audio/music ID
- instagram_popular_search— Trending queries / suggestions
- instagram_get_location_posts— Posts tagged at a specific location
- instagram_get_nearby_locations— Nearby location IDs (for use in location-posts)
- TikTok (videos, profiles, hashtags)
- X / Twitter (tweets, profiles, search)
- LinkedIn (company pages, posts, employees)
- YouTube (videos, channels, comments)
Track the platform roadmap atsocialapis.io/api-sources.
Each prompt below is a real Claude Desktop session. Some of these are single-tool-call patterns ("get me X"); some require Claude to chain multiple calls + aggregate the results (noted where).
What's Nike's follower count on Facebook? → Uses facebook_get_page_details (1 credit) Get the latest 9 posts from facebook.com/EngenSA → Uses facebook_get_page_posts with limit=9 (1-3 credits depending on actual returned count) Show me the Meta ads currently running for "Apple Vision Pro" in Germany → Uses facebook_ads_search (1 credit)
Multi-call patterns (Claude orchestrates these — but it's slower + more expensive)
Compare engagement on Nike vs Adidas's last 9 Facebook posts → Claude calls facebook_get_page_posts twice (~2-6 credits total), aggregates reactions/comments/shares per post, returns a comparison. What are people saying in the comments on Coca-Cola's last 3 posts? → Claude calls facebook_get_page_posts (1 credit) then facebook_get_post_comments 3 times (3 credits) and summarizes. Show me marketplace listings for "PlayStation 5" under $400 in Berlin → Claude calls facebook_marketplace_city_coordinates (1 credit) + facebook_marketplace_search with filters (1 credit).
Some queries look natural in a chat ("compare engagement over the last month") but require aggregations the API doesn't expose as a single tool yet. Claude can still answer them, but it'll fan out into many tool calls — which is slow + expensive.
If your use case maps to one of these patterns and you want the aggregation pre-computed instead of LLM-orchestrated,contact supportwith the specific query — we're prioritizing the aggregation endpoint based on customer demand.
Claude Desktop ↓ @socialapis/mcp (local MCP client) ↓ https://mcp.socialapis.io (global proxy) ↓ https://api.socialapis.io (data API)
- ✅ Low latency (global edge network)
- ✅ High reliability (99.9% uptime)
- ✅ Auto rate limiting
- ✅ Smart caching
- ✅ Your API key stays local
# Clone repository git clone https://github.com/SocialAPIsHub/mcp-server.git cd mcp-server # Install dependencies npm install # Run MCP client npm start YOUR_API_KEY # Run HTTP proxy server npm run serve
mcp-server/ ├── src/ │ └── tools.js # Tool definitions ├── mcp-wrapper.js # MCP client (runs locally) ├── server.js # HTTP proxy server ├── package.json ├── Dockerfile └── README.md
# Test MCP client locally node mcp-wrapper.js YOUR_API_KEY # Test HTTP proxy curl http://localhost:3001/health curl http://localhost:3001/tools # Test specific tool curl -X POST http://localhost:3001/proxy \ -H "x-api-key: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"tool":"facebook_get_page_details","arguments":{"link":"https://facebook.com/nike"}}'
We welcome contributions! Please seeCONTRIBUTING.mdfor details.
- Fork the repository
- Create a feature branch (git checkout -b feature/amazing-feature)
- Commit your changes (git commit -m 'Add amazing feature')
- Push to the branch (git push origin feature/amazing-feature)
- Open a Pull Request
- Full Documentation
- API Reference
- MCP Guide
- Examples
- 📧Email:support@socialapis.io
- 💬Discord:discord.gg/D5bQskrwV
- 🐛Issues:GitHub Issues
- 📚Docs:docs.socialapis.io
- Facebook API support — 31 tools (Pages, Groups, Posts, Search, Ads Library, Marketplace, Media)
- Instagram support— 16 tools (Profiles, Posts, Reels, Highlights, Discovery / Locations)
- MCP server implementation
- HTTP proxy server
- npm package published —@socialapis/mcp
- MCP Registry listing—registry.modelcontextprotocol.io
- Python SDK—socialapis-sdkon PyPI (51 endpoints, MIT)
- JavaScript / TypeScript SDK—socialapis-sdkon npm (Node 18+, Bun, Deno, browsers)
- Go SDK—github.com/SocialAPIsHub/socialapis-go(idiomatic, zero deps)
- TikTok support
- X (Twitter) support
- LinkedIn support
- YouTube support
- Advanced analytics — server-side aggregation endpoints (engagement-over-time, brand comparisons) so multi-call patterns become a single tool call
- Real-time webhooks — push notifications on new posts / engagement thresholds
- LangChain integration
Platform priorities shift based on customer demand. The fastest way to push something up the queue is to emailsupport@socialapis.ioor DM@socialapis on Telegramwith the use case.
This project is licensed under the MIT License - see theLICENSEfile for details.
- Built withModel Context Protocol
- Powered byAnthropic Claude
- Inspired by the AI agent community
Check availability of domain names, social media handles and subreddits
Monitor web and social media using the Mention API.
Single API key to access 21 + real time social media data
Transforms any blog/article URL into ready-to-post social media content for Twitter/X, LinkedIn, Instagram, Facebook, and email. Hosted on Apify, zero setup, pay-per-event ($0.07).
One social-video URL in → metadata, transcript (captions or Whisper), engagement insights, and parametric frames out. 6 platforms (YouTube, Shorts, TikTok, Instagram, Pinterest, Reddit). REST + MCP. Pay per call with x402 (USDC), no account.
An automated tool to search notes, analyze content, and post AI-generated comments on Xiaohongshu (Redbook) using Playwright.
Access and interact with content from Xiaohongshu (RedNote).
Trending content from Hacker News, Dev.to, IMDb, podcasts, and Eventbrite
Hosted MCP for public social data (TikTok, Instagram, Reddit, X, YouTube, and more) as structured JSON.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.




