# SocialAPIs > REST APIs for real-time public data from Facebook and Instagram. 200 free API calls / month, no credit card. Trusted by 5,000+ developers and 7.2M+ monthly API calls through the underlying engine. SocialAPIs is a REST API for public Facebook and Instagram data with flat per-request pricing: plans from $4.99/month, down to about $1.49 per 1,000 requests on the largest plan. No bandwidth fees, no compute units, no per-Actor billing. One auth header (`x-api-token`), one rate limit, 53 endpoints. MCP server for AI agents (Claude, ChatGPT, Cursor and any MCP client): 12 read-only tools, hosted at https://mcp.socialapis.io/mcp or `npx -y @socialapis/mcp`. Live today: Facebook and Instagram. Roadmap (vote on which we build next at ): TikTok, X (Twitter), LinkedIn, YouTube. ## What we offer - [Facebook Page Details](https://socialapis.io/api-sources/facebook-page-details): page metadata, likes, followers, contact info - [Facebook Page Posts](https://socialapis.io/api-sources/facebook-page-posts): recent posts, reactions, media, comments - [Facebook Search](https://socialapis.io/api-sources/facebook-search-pages): pages, people, posts, locations, videos by keyword - [Facebook Group Details](https://socialapis.io/api-sources/facebook-group-details): rules, member count, activity stats - [Facebook Group Posts](https://socialapis.io/api-sources/facebook-group-posts): recent posts with engagement - [Meta Ads Library Search](https://socialapis.io/api-sources/meta-ads-search): search active ads by keyword or page ID - [Meta Ads Archive Details](https://socialapis.io/api-sources/meta-ads-archive-details): detailed ad creative, spend, impressions - [Facebook Marketplace Search](https://socialapis.io/api-sources/marketplace-search): listings with location + price filters - [Marketplace Listing Details](https://socialapis.io/api-sources/marketplace-listing-details): photos, price, seller info per listing - [Instagram Profile Details](https://socialapis.io/api-sources/instagram-profile-details): bio, followers, related profiles - [Instagram Profile Posts](https://socialapis.io/api-sources/instagram-profile-posts): photos, videos, carousels with engagement - [Instagram Profile Reels](https://socialapis.io/api-sources/instagram-profile-reels): reels with play counts + audio - [Instagram Profile Highlights](https://socialapis.io/api-sources/instagram-profile-highlights): cover images + permalinks - [Instagram Location Posts](https://socialapis.io/api-sources/instagram-location-posts): top + recent posts tagged at a place - [MCP Server for AI agents](https://docs.socialapis.io/ai-agents/mcp): 12 tools (facebook_page, facebook_ads, instagram_profile, …), each with an action argument, covering every endpoint - [Facebook follower count checker](https://socialapis.io/tools/facebook-follower-count): free browser tool, followers / likes / category / verified badge of a public Facebook Page, with the GET /facebook/pages/details call behind it (exact_followers_count=true: 5 credits per call with an API key) - [Facebook ad checker](https://socialapis.io/tools/facebook-ad-checker): free browser tool, the active ads of a Facebook Page or a keyword in Meta's Ad Library, by country (advertiser, text, start date, platforms incl. Instagram, Ads Library link), with the GET /facebook/ads/search call behind it (1 credit per keyword search; 2 for a Page: GET /facebook/pages/details for its ad_page_id, then the search) - [Business contact finder](https://socialapis.io/tools/leads-generator): browser tool for signed-in users, the public emails, phone numbers and social profile links a business publishes on its own website (no people search), cleaned and exportable as CSV, with the GET /website/contacts?start_url= call behind it (priced per website check in the endpoint catalog) - [Integrations: MCP, SDKs, n8n](https://socialapis.io/integrations): hosted MCP endpoint (https://mcp.socialapis.io/mcp), setup for Claude / Cursor / VS Code / Cline / Windsurf, Python / JS / Go SDKs, n8n node, marketplace listings ## API endpoints 54 endpoints. Base URL `https://api.socialapis.io`, auth header `x-api-token`. Prices are per call. Machine-readable: [OpenAPI spec](https://socialapis.io/openapi.json). ### Facebook - [GET /facebook/ads/archive-details](https://socialapis.io/api-sources/meta-ads-archive-details): Get detailed info about a specific archived ad by archive ID. Params: ad_archive_id (required), page_id, country, is_ad_non_political, is_ad_not_aaa_eligible. Price: 1 credit. - [GET /facebook/ads/countries](https://socialapis.io/api-sources/meta-ads-countries): Get list of supported country codes for Meta Ads Library filtering. No params. Price: 1 credit. - [GET /facebook/ads/keywords](https://socialapis.io/api-sources/meta-ads-keywords): Search for ads by keyword with optional country filter. Params: query (required), country. Price: 1 credit. - [GET /facebook/ads/page-details](https://socialapis.io/api-sources/meta-ads-page-details): Get detailed info about a specific Facebook page from the Ads Library. Params: page_id (required). Price: 1 credit. - [GET /facebook/ads/search](https://socialapis.io/api-sources/meta-ads-search): Search ads in the Meta Ad Library by keyword or page ID with filters. Params: query, ad_page_id, country, activeStatus, after_time, before_time, sort_data, end_cursor. Price: 1 credit. - [GET /facebook/albums/items](https://socialapis.io/api-sources/facebook-album-items): Get the photos and videos inside a Facebook album, from a page or a group. Takes the album id returned by /facebook/pages/albums or /facebook/groups/albums. Params: album_id (required), end_cursor. Price: 1 credit. - [GET /facebook/groups/albums](https://socialapis.io/api-sources/facebook-group-albums): List the photo albums of a Facebook group (album_id, album_title, url, thumbnail_uri, photos_count, videos_count). Use the album_id with /facebook/albums/items to get the photos. Params: group_id (required), limit. Price: 1 credit. - [GET /facebook/groups/details](https://socialapis.io/api-sources/facebook-group-details): Get detailed metadata and statistics about a Facebook group including member count, description, and rules. Params: link (required). Price: 1 credit. - [GET /facebook/groups/id](https://socialapis.io/api-sources/facebook-group-id): Retrieve the Facebook Group ID from a public group link. Params: link (required). Price: 1 credit. - [GET /facebook/groups/posts](https://socialapis.io/api-sources/facebook-group-posts): Fetch recent posts from a Facebook group, including text, media, reactions, and comments. Params: link (required), limit, end_cursor, after_time, before_time, timezone. Price: 1 credit; round(limit ÷ 3) credits when limit is set, up to 3. - [GET /facebook/groups/videos](https://socialapis.io/api-sources/facebook-group-videos): Get videos from a Facebook group with pagination. Params: link (required), end_cursor. Price: 1 credit. - [GET /facebook/marketplace/categories](https://socialapis.io/api-sources/marketplace-categories): Get all Marketplace categories with seo_url and category ID values. No params. Price: 1 credit. - [GET /facebook/marketplace/city-coordinates](https://socialapis.io/api-sources/marketplace-city-coordinates): Get GPS coordinates for a city to use as Marketplace location filters. Params: city (required), country, exactly_one. Price: 1 credit. - [GET /facebook/marketplace/listing](https://socialapis.io/api-sources/marketplace-listing-details): Get detailed info about a single Marketplace listing. Params: listing_id (required). Price: 1 credit. - [GET /facebook/marketplace/rentals](https://socialapis.io/api-sources/marketplace-rentals): Search Marketplace rental property listings with filters for bedrooms, bathrooms, location, and price. Params: sort_by, filter_location_latitude, filter_location_longitude, filter_price_lower_bound, filter_price_upper_bound, filter_radius_km, filter_bedrooms_min, filter_bedrooms_max, filter_bathrooms_min, filter_bathrooms_max, is_c2c_listing_only, end_cursor. Price: 1 credit. - [GET /facebook/marketplace/search](https://socialapis.io/api-sources/marketplace-search): Search Facebook Marketplace items with filters for location, price, category, condition, and more. Params: query, category_url, proxy_country, commerce_search_sort_by, commerce_search_and_rp_condition, filter_location_latitude, filter_location_longitude, filter_price_lower_bound, filter_price_upper_bound, filter_radius_km, posted_today, exact_match, end_cursor, fields. Price: 1 credit. - [GET /facebook/marketplace/seller](https://socialapis.io/api-sources/marketplace-seller-details): Get seller profile, ratings, reviews, and badges. Params: seller_id (required). Price: 1 credit. - [GET /facebook/marketplace/vehicles](https://socialapis.io/api-sources/marketplace-vehicles): Search Marketplace vehicle listings with filters for location, price, mileage, year, and more. Params: sort_by, filter_location_latitude, filter_location_longitude, filter_price_lower_bound, filter_price_upper_bound, filter_radius_km, is_c2c_listing_only, exact_match, end_cursor. Price: 1 credit. - [GET /facebook/media/download](https://socialapis.io/api-sources/facebook-download-media): Download media (images, videos, audio) from Facebook URLs. Params: url (required). Price: 1 credit; up to 100 credits per call depending on the result. - [GET /facebook/pages/albums](https://socialapis.io/api-sources/facebook-page-albums): List the photo albums of a Facebook page (album_id, album_title, url, thumbnail_uri, album_items_count). Use the album_id with /facebook/albums/items to get the photos. Params: profile_id (required), limit, end_cursor. Price: 1 credit. - [GET /facebook/pages/details](https://socialapis.io/api-sources/facebook-page-details): Get Facebook page details. Params: link (required), exact_followers_count, page_section. Price: 1 credit; 5 credits when exact_followers_count=true. - [GET /facebook/pages/id](https://socialapis.io/api-sources/facebook-page-id): Get Facebook page id. Params: link (required). Price: 1 credit. - [GET /facebook/pages/posts](https://socialapis.io/api-sources/facebook-page-posts): Get Facebook page posts. Params: link (required), limit, end_cursor, after_time, before_time, timezone. Price: 1 credit; round(limit ÷ 3) credits when limit is set, up to 3. - [GET /facebook/pages/reels](https://socialapis.io/api-sources/facebook-page-reels): Get Facebook page reels. Params: link (required), end_cursor. Price: 1 credit. - [GET /facebook/pages/videos](https://socialapis.io/api-sources/facebook-page-videos): Get Facebook page videos. Params: link (required), end_cursor. Price: 1 credit. - [GET /facebook/posts/attachments](https://socialapis.io/api-sources/facebook-post-attachment-details): Get details of all media attachments for a given Facebook post. Params: post_id (required). Price: 5 credits. - [GET /facebook/posts/comments](https://socialapis.io/api-sources/facebook-post-comments): Retrieve top-level comments from a Facebook post or reel. Params: link (required), end_cursor, include_reply_info. Price: 1 credit. - [GET /facebook/posts/comments/replies](https://socialapis.io/api-sources/facebook-post-comment-replies): Fetch replies to a specific comment on a Facebook post. Requires comment_feedback_id and expansion_token obtained from the /facebook/posts/comments endpoint with include_reply_info=true. Params: comment_feedback_id (required), expansion_token (required). Price: 1 credit. - [GET /facebook/posts/details](https://socialapis.io/api-sources/facebook-post-details): Get detailed data about a Facebook post including reactions, media, and user info. Params: link (required). Price: 1 credit. - [GET /facebook/posts/details/extended](https://socialapis.io/api-sources/facebook-post-details-extended): Get extended details about a Facebook post including views, video URLs, music info, and author verification. Params: link (required). Price: 1 credit. - [GET /facebook/posts/id](https://socialapis.io/api-sources/facebook-post-id): Extract the Facebook post ID from a given post link. Params: link (required). Price: 1 credit. - [GET /facebook/posts/video](https://socialapis.io/api-sources/facebook-video-post-details): Retrieve video metadata, feedback stats, and post context for a Facebook video post. Params: video_id (required). Price: 1 credit. - [GET /facebook/search/locations](https://socialapis.io/api-sources/facebook-search-locations): Search for Facebook locations by keyword. Returns location UIDs that can be used to filter other search endpoints. Params: query (required). Price: 1 credit. - [GET /facebook/search/pages](https://socialapis.io/api-sources/facebook-search-pages): Search for Facebook pages by keyword with optional location filtering. Params: query (required), location_uid, end_cursor. Price: 1 credit. - [GET /facebook/search/people](https://socialapis.io/api-sources/facebook-search-people): Search for Facebook people/profiles by keyword with optional location filtering. Params: query (required), location_uid, end_cursor. Price: 1 credit. - [GET /facebook/search/posts](https://socialapis.io/api-sources/facebook-search-posts): Search for Facebook posts by keyword with optional location and time filters. Params: query (required), location_uid, start_time, end_time, recent_posts, end_cursor. Price: 1 credit. - [GET /facebook/search/videos](https://socialapis.io/api-sources/facebook-search-videos): Search for Facebook videos by keyword with optional recency and live filters. Params: query (required), most_recent, videos_live, fields, end_cursor. Price: 1 credit. ### Instagram - [GET /instagram/highlight/details](https://socialapis.io/api-sources/instagram-highlight-details): Get details of a specific highlight by ID. Params: highlight_id (required). Price: 1 credit. - [GET /instagram/location/nearby](https://socialapis.io/api-sources/instagram-nearby-locations): Get nearby places/locations for a specific Instagram location. Params: location_id (required). Price: 1 credit. - [GET /instagram/location/posts](https://socialapis.io/api-sources/instagram-location-posts): Get Instagram posts from a specific location (ranked or recent). Params: location_id (required), tab, end_cursor. Price: 1 credit. - [GET /instagram/post/details](https://socialapis.io/api-sources/instagram-post-details): Get details of a specific Instagram post. Params: shortcode (required). Price: 1 credit. - [GET /instagram/post/id](https://socialapis.io/api-sources/instagram-post-id): Extract the post shortcode from an Instagram URL. Params: link (required). Price: 1 credit. - [GET /instagram/profile/details](https://socialapis.io/api-sources/instagram-profile-details): Get user profile information by username including bio, followers, posts count, and related profiles. Params: username (required), link. Price: 1 credit. - [GET /instagram/profile/highlights](https://socialapis.io/api-sources/instagram-profile-highlights): Get all highlights from a user profile. Params: user_id (required). Price: 1 credit. - [GET /instagram/profile/posts](https://socialapis.io/api-sources/instagram-profile-posts): Get posts from a user profile with pagination. Params: username, user_id, end_cursor. Price: 1 credit. - [GET /instagram/profile/reels](https://socialapis.io/api-sources/instagram-profile-reels): Get reels from a user profile with pagination. Params: user_id (required), end_cursor. Price: 1 credit. - [GET /instagram/reels/audio](https://socialapis.io/api-sources/instagram-reels-by-audio): Get Instagram Reels associated with a specific audio/music ID. Params: audio_id (required), max_id. Price: 1 credit. - [GET /instagram/reels/feed](https://socialapis.io/api-sources/instagram-reels-feed): Get Instagram Reels feed with recommended, trending, or chained clips. Params: clips_media_id. Price: 1 credit. - [GET /instagram/search](https://socialapis.io/api-sources/instagram-popular-search): Search Instagram by keyword and get popular results (users, hashtags, places). Params: keyword (required), end_cursor. Price: 1 credit. - [GET /instagram/user/id](https://socialapis.io/api-sources/instagram-user-id): Get the unique ID of any Instagram profile from link or username. Params: link, username. Price: 1 credit. ### Account and usage (free) - [GET /usage](https://socialapis.io/api-sources/usage): Get current credit usage and plan info. Free — does not consume credits. No params. Price: Free. - [GET /usage/limits](https://socialapis.io/api-sources/usage-limits): Get plan limits (rate limit, max tasks, allowed top-ups). Free — does not consume credits. No params. Price: Free. - [GET /usage/top-ups](https://socialapis.io/api-sources/usage-top-ups): Get auto top-up settings and recent history. Free — does not consume credits. No params. Price: Free. ### Website - `GET /website/contacts`: Find the public contact details a business publishes on its own website (emails, phone numbers, social profile links) from its homepage URL. Params: start_url (required), max_requests. Price: 1 credit. ## Quick links - [API endpoint catalog](https://socialapis.io/api-sources): browse 53 Facebook + Instagram endpoints - [Get started in 5 minutes](https://socialapis.io/get-started): quickstart with curl + JSON example - [Pricing](https://socialapis.io/pricing): Free / Pro / Ultra / Mega / Enterprise tiers - [Compare vs alternatives](https://socialapis.io/compare): Bright Data, Apify, RapidAPI, ScraperAPI, Data365, SocialCrawl - [About / team](https://socialapis.io/about): founder, traction screenshots, contact channels - [Blog](https://socialapis.io/blog): tutorials, deep-dives, product updates - [Full documentation](https://docs.socialapis.io): API reference, AI-agent integration guides - [OpenAPI 3.1 spec](https://socialapis.io/openapi.json): every endpoint, parameter, auth header and error code, machine-readable - [Sign up free](https://socialapis.io/auth/signup): 200 calls/month, no credit card - [Contact support](https://socialapis.io/contact-us): inquiry-type-aware form ## For AI agents - [llms-full.txt](https://socialapis.io/llms-full.txt): this file plus every published answer (question and direct answer) from socialapis.io/answers - [llms-endpoints.txt](https://socialapis.io/llms-endpoints.txt): every endpoint on one line (method, route, description, params, price), live - [agents.txt](https://socialapis.io/agents.txt): how an agent calls us: auth header, base URL, MCP server, OpenAPI, agent skill, rate limits, pricing, contact ## Compare SocialAPIs vs alternatives - [SocialAPIs vs Bright Data](https://socialapis.io/compare/bright-data): pricing parity, integration shape, procurement - [SocialAPIs vs Apify](https://socialapis.io/compare/apify): one billing meter vs three (subscription + compute + per-result) - [SocialAPIs vs RapidAPI](https://socialapis.io/compare/rapidapi): one flat rate vs overage cliffs + bandwidth fees - [SocialAPIs vs ScraperAPI](https://socialapis.io/compare/scraperapi): structured social data vs raw HTML, 0% benchmark on Instagram and Twitter - [SocialAPIs vs Data365](https://socialapis.io/compare/data365): $4.99/month entry vs a €300/month minimum - [SocialAPIs vs SocialCrawl](https://socialapis.io/compare/socialcrawl): cheaper per 1,000 calls on every tier; SocialCrawl's credits never expire ## Pricing - Free — 200 calls / month, $0 / mo - Pro — 1,500 calls / month, $4.99 / mo - Ultra — 30,000 calls / month, $49 / mo - Mega — 120,000 calls / month, $179 / mo - Enterprise — custom pricing with SLA, dedicated support, IP allowlisting One credit per call for most endpoints; the few that cost more are listed with their price under "API endpoints" above. Every response says what it charged (`X-SocialAPIs-Credits-Deducted` header). Calls that return data are charged, including empty results (no ads found, no contacts); errors (4xx / 5xx, timeouts) are not. No bandwidth fee, no compute units. ## Use cases - Market research and competitor analysis - Social media monitoring and tracking - Lead generation from public Facebook + Instagram data - Ad intelligence and creative research via Meta Ad Library - E-commerce product research via Facebook Marketplace - Influencer discovery and analytics - AI-agent workflows via MCP (Claude Desktop / ChatGPT / Cursor) ## API examples Auth header is `x-api-token` — NOT `Authorization: Bearer`. Get details of a Facebook page: ```bash curl "https://api.socialapis.io/facebook/pages/details?link=https%3A%2F%2Fwww.facebook.com%2FEngenSA" \ -H "x-api-token: YOUR_API_TOKEN" ``` Search Facebook pages by keyword: ```bash curl "https://api.socialapis.io/facebook/search/pages?query=marketing" \ -H "x-api-token: YOUR_API_TOKEN" ``` Get Instagram profile details: ```bash curl "https://api.socialapis.io/instagram/profile/details?username=instagram" \ -H "x-api-token: YOUR_API_TOKEN" ``` ## Blog - [API Integration Best Practices for 2025](https://socialapis.io/blog/api-best-practices): auth, structured logging, idempotency, retry patterns - [The Complete Guide to Building AI Agents](https://socialapis.io/blog/building-ai-agents): tool calling, memory, orchestration, MCP - [Build an AI Social Media Agent with LangChain](https://socialapis.io/blog/build-ai-social-agent): step-by-step Facebook monitoring agent - [Announcing SocialAPIs in the MCP Registry](https://socialapis.io/blog/mcp-launch): first-class MCP support announcement - [Facebook API Without the Graph API](https://socialapis.io/blog/facebook-api-without-graph-api): what to use for public page, post, Marketplace and ad data, with code - [Monitor a Facebook Group's New Posts Automatically](https://socialapis.io/blog/monitor-facebook-group-posts): after Meta removed the Groups API (April 22, 2024): Python script and n8n workflow with /facebook/groups/posts - [Facebook Ads Library API Without App Review](https://socialapis.io/blog/facebook-ads-library-api): Meta's Ad Library API vs /facebook/ads/search, competitor ads by keyword or page, the grouped response, catalog-ad placeholders, a new-ad tracker in Python and n8n - [Get Facebook Marketplace Listings with Python](https://socialapis.io/blog/scrape-facebook-marketplace-python): /facebook/marketplace/search by keyword, location and price, the real response (data.items), CSV export, new-listing and price-drop alerts ## Who runs SocialAPIs SocialAPIs.io was founded in 2026 by Oussema Frikha, registered in the United Arab Emirates. Two engineers, no investors. The company grew out of a Facebook Scraper API still live on RapidAPI that currently handles 7.2M+ API calls a month for 364 customers (last 30 days). Traction numbers are screenshotted from the RapidAPI owner analytics dashboard on the [about page](https://socialapis.io/about) — not rounded marketing figures. - [Founder bio + traction screenshots](https://socialapis.io/about) - [Founder on LinkedIn](https://www.linkedin.com/in/oussema-frikha-379851127/) - [Telegram (fastest channel)](https://t.me/socialapis) - [Underlying API on RapidAPI](https://rapidapi.com/oussemaf/api/facebook-scraper-api4) ## Optional - [GitHub organization](https://github.com/SocialAPIsHub) - [MCP server on npm](https://www.npmjs.com/package/@socialapis/mcp) - [Postman docs and collection](https://documenter.getpostman.com/view/7191741/2sBYHVveUY): every endpoint, fork and run with your key - [System status](https://socialapis.io/status)