SocialAPIs
Facebook & Instagram data for AI agents: pages, posts, groups, ads, Marketplace, profiles, reels.
我该使用它吗
质量与安全性
A
发现（7）
- LOWTool 'facebook_get_post_id' description lacks action verb在 facebook_get_post_id 中
- LOWTool 'instagram_get_post_id' description lacks action verb在 instagram_get_post_id 中
- LOWTool 'facebook_get_post_details_extended' name length outside 3-30 range在 facebook_get_post_details_extended 中
- LOWTool 'facebook_marketplace_categories' name length outside 3-30 range在 facebook_marketplace_categories 中
- LOWTool 'facebook_marketplace_city_coordinates' name length outside 3-30 range在 facebook_marketplace_city_coordinates 中
- LOWTool 'instagram_get_profile_highlights' name length outside 3-30 range在 instagram_get_profile_highlights 中
- LOWTool 'instagram_get_highlight_details' name length outside 3-30 range在 instagram_get_highlight_details 中
基于对工具定义和协议合规性的自动分析。
上下文开销
~11,109token 数（工具定义）
~2.4 KB典型响应大小
对注意力有显著影响（占 128k 上下文窗口的 8.68%）
这是每次将服务器的工具加载到模型上下文窗口时所消耗的大致 token 数。数值越高，可用于其他任务的注意力就越少。
安装
一键安装
将以下内容添加到你的 `claude_desktop_config.json` 文件中：
{
"mcpServers": {
"social-media-api": {
"command": "npx",
"args": [
"@socialapis/mcp"
]
}
}
}可运行的软件包
npm@socialapis/mcp
1.2.0stdio远程端点
https://mcp.socialapis.io/mcpstreamable-http它能做什么
工具清单
工具（47）
🟢 只读🟡 写入🔴 删除⚪ 未知
🟢facebook_get_page_id(link)
Get Facebook page ID from a page URL
输入模式
{
"type": "object",
"properties": {
"link": {
"type": "string",
"description": "Facebook page URL (e.g., https://facebook.com/nike)"
}
},
"required": [
"link"
]
}输出模式
{
"type": "object",
"properties": {
"result": {
"description": "JSON response from the SocialAPIs REST endpoint, unchanged. Object or array depending on the endpoint; most include a `meta` block (statusCode, duration, creditsCharged, creditsRemaining)."
},
"creditsCharged": {
"type": [
"integer",
"null"
],
"description": "Credits charged for this call, or null if the endpoint did not report it."
},
"creditsRemaining": {
"type": [
"integer",
"null"
],
"description": "Credits left on the API key after this call, or null if not reported."
}
},
"required": [
"result"
]
}🟢facebook_get_page_details(link, exact_followers_count)
Get detailed information about a Facebook page including followers, contact info, and category. Pricing: 1 credit per call; 5 credits when exact_followers_count=true.
输入模式
{
"type": "object",
"properties": {
"link": {
"type": "string",
"description": "Facebook page URL"
},
"exact_followers_count": {
"type": "boolean",
"description": "When true, performs a deeper scrape to return the exact follower count (e.g. 38,493,217 instead of \"38M\"). Charges 5 credits when true, 1 credit otherwise. Default: false."
}
},
"required": [
"link"
]
}输出模式
{
"type": "object",
"properties": {
"result": {
"description": "JSON response from the SocialAPIs REST endpoint, unchanged. Object or array depending on the endpoint; most include a `meta` block (statusCode, duration, creditsCharged, creditsRemaining)."
},
"creditsCharged": {
"type": [
"integer",
"null"
],
"description": "Credits charged for this call, or null if the endpoint did not report it."
},
"creditsRemaining": {
"type": [
"integer",
"null"
],
"description": "Credits left on the API key after this call, or null if not reported."
}
},
"required": [
"result"
]
}🟢facebook_get_page_posts(link, limit, end_cursor, after_time, before_time, ...)
Get recent posts from a Facebook page with optional pagination and time filtering. Pricing: ceil(posts_returned / 3) credits per call, minimum 1.
输入模式
{
"type": "object",
"properties": {
"link": {
"type": "string",
"description": "Facebook page URL"
},
"limit": {
"type": "number",
"description": "Maximum number of posts to return. Default: 3. Minimum: 3. Maximum: 9.",
"minimum": 3,
"maximum": 9
},
"end_cursor": {
"type": "string",
"description": "Pagination cursor for next page of results"
},
"after_time": {
"type": "string",
"description": "ISO 8601 timestamp - only return posts after this time"
},
"before_time": {
"type": "string",
"description": "ISO 8601 timestamp - only return posts before this time"
},
"timezone": {
"type": "string",
"description": "Timezone for timestamps (e.g., UTC, America/New_York)"
}
},
"required": [
"link"
]
}输出模式
{
"type": "object",
"properties": {
"result": {
"description": "JSON response from the SocialAPIs REST endpoint, unchanged. Object or array depending on the endpoint; most include a `meta` block (statusCode, duration, creditsCharged, creditsRemaining)."
},
"creditsCharged": {
"type": [
"integer",
"null"
],
"description": "Credits charged for this call, or null if the endpoint did not report it."
},
"creditsRemaining": {
"type": [
"integer",
"null"
],
"description": "Credits left on the API key after this call, or null if not reported."
}
},
"required": [
"result"
]
}🟢facebook_get_page_videos(link, profile_id, limit, end_cursor)
Get videos from a Facebook page with pagination. Pricing: 1 credit per call.
输入模式
{
"type": "object",
"properties": {
"link": {
"type": "string",
"description": "Facebook page URL"
},
"profile_id": {
"type": "string",
"description": "Facebook profile ID (alternative to link)"
},
"limit": {
"type": "number",
"description": "Maximum number of videos to return. Default: 6. Minimum: 6. Maximum: 12.",
"minimum": 6,
"maximum": 12
},
"end_cursor": {
"type": "string",
"description": "Pagination cursor"
}
},
"required": []
}输出模式
{
"type": "object",
"properties": {
"result": {
"description": "JSON response from the SocialAPIs REST endpoint, unchanged. Object or array depending on the endpoint; most include a `meta` block (statusCode, duration, creditsCharged, creditsRemaining)."
},
"creditsCharged": {
"type": [
"integer",
"null"
],
"description": "Credits charged for this call, or null if the endpoint did not report it."
},
"creditsRemaining": {
"type": [
"integer",
"null"
],
"description": "Credits left on the API key after this call, or null if not reported."
}
},
"required": [
"result"
]
}🟢facebook_get_page_reels(link, end_cursor)
Get reels/short videos from a Facebook page
输入模式
{
"type": "object",
"properties": {
"link": {
"type": "string",
"description": "Facebook page URL"
},
"end_cursor": {
"type": "string",
"description": "Pagination cursor"
}
},
"required": [
"link"
]
}输出模式
{
"type": "object",
"properties": {
"result": {
"description": "JSON response from the SocialAPIs REST endpoint, unchanged. Object or array depending on the endpoint; most include a `meta` block (statusCode, duration, creditsCharged, creditsRemaining)."
},
"creditsCharged": {
"type": [
"integer",
"null"
],
"description": "Credits charged for this call, or null if the endpoint did not report it."
},
"creditsRemaining": {
"type": [
"integer",
"null"
],
"description": "Credits left on the API key after this call, or null if not reported."
}
},
"required": [
"result"
]
}🟢facebook_get_group_id(link)
Get Facebook group ID from a group URL
输入模式
{
"type": "object",
"properties": {
"link": {
"type": "string",
"description": "Facebook group URL"
}
},
"required": [
"link"
]
}输出模式
{
"type": "object",
"properties": {
"result": {
"description": "JSON response from the SocialAPIs REST endpoint, unchanged. Object or array depending on the endpoint; most include a `meta` block (statusCode, duration, creditsCharged, creditsRemaining)."
},
"creditsCharged": {
"type": [
"integer",
"null"
],
"description": "Credits charged for this call, or null if the endpoint did not report it."
},
"creditsRemaining": {
"type": [
"integer",
"null"
],
"description": "Credits left on the API key after this call, or null if not reported."
}
},
"required": [
"result"
]
}🟢facebook_get_group_details(link)
Get detailed metadata about a Facebook group including member count, description, rules, and activity stats
输入模式
{
"type": "object",
"properties": {
"link": {
"type": "string",
"description": "Facebook group URL"
}
},
"required": [
"link"
]
}输出模式
{
"type": "object",
"properties": {
"result": {
"description": "JSON response from the SocialAPIs REST endpoint, unchanged. Object or array depending on the endpoint; most include a `meta` block (statusCode, duration, creditsCharged, creditsRemaining)."
},
"creditsCharged": {
"type": [
"integer",
"null"
],
"description": "Credits charged for this call, or null if the endpoint did not report it."
},
"creditsRemaining": {
"type": [
"integer",
"null"
],
"description": "Credits left on the API key after this call, or null if not reported."
}
},
"required": [
"result"
]
}🟢facebook_get_group_posts(link, limit, end_cursor, after_time, before_time, ...)
Fetch recent posts from a Facebook group with pagination and time filtering. Pricing: ceil(posts_returned / 3) credits per call, minimum 1.
输入模式
{
"type": "object",
"properties": {
"link": {
"type": "string",
"description": "Facebook group URL"
},
"limit": {
"type": "number",
"description": "Maximum number of posts to return. Default: 3. Minimum: 3. Maximum: 9.",
"minimum": 3,
"maximum": 9
},
"end_cursor": {
"type": "string",
"description": "Pagination cursor"
},
"after_time": {
"type": "string",
"description": "ISO 8601 timestamp"
},
"before_time": {
"type": "string",
"description": "ISO 8601 timestamp"
},
"timezone": {
"type": "string",
"description": "Timezone"
}
},
"required": [
"link"
]
}输出模式
{
"type": "object",
"properties": {
"result": {
"description": "JSON response from the SocialAPIs REST endpoint, unchanged. Object or array depending on the endpoint; most include a `meta` block (statusCode, duration, creditsCharged, creditsRemaining)."
},
"creditsCharged": {
"type": [
"integer",
"null"
],
"description": "Credits charged for this call, or null if the endpoint did not report it."
},
"creditsRemaining": {
"type": [
"integer",
"null"
],
"description": "Credits left on the API key after this call, or null if not reported."
}
},
"required": [
"result"
]
}🟢facebook_get_group_videos(link, end_cursor)
Get videos from a Facebook group with pagination. Pricing: 1 credit per call.
输入模式
{
"type": "object",
"properties": {
"link": {
"type": "string",
"description": "Facebook group URL"
},
"end_cursor": {
"type": "string",
"description": "Pagination cursor"
}
},
"required": [
"link"
]
}输出模式
{
"type": "object",
"properties": {
"result": {
"description": "JSON response from the SocialAPIs REST endpoint, unchanged. Object or array depending on the endpoint; most include a `meta` block (statusCode, duration, creditsCharged, creditsRemaining)."
},
"creditsCharged": {
"type": [
"integer",
"null"
],
"description": "Credits charged for this call, or null if the endpoint did not report it."
},
"creditsRemaining": {
"type": [
"integer",
"null"
],
"description": "Credits left on the API key after this call, or null if not reported."
}
},
"required": [
"result"
]
}🟢facebook_get_post_id(link)
Extract Facebook post ID from a post URL
输入模式
{
"type": "object",
"properties": {
"link": {
"type": "string",
"description": "Facebook post URL"
}
},
"required": [
"link"
]
}输出模式
{
"type": "object",
"properties": {
"result": {
"description": "JSON response from the SocialAPIs REST endpoint, unchanged. Object or array depending on the endpoint; most include a `meta` block (statusCode, duration, creditsCharged, creditsRemaining)."
},
"creditsCharged": {
"type": [
"integer",
"null"
],
"description": "Credits charged for this call, or null if the endpoint did not report it."
},
"creditsRemaining": {
"type": [
"integer",
"null"
],
"description": "Credits left on the API key after this call, or null if not reported."
}
},
"required": [
"result"
]
}🟢facebook_get_post_details(link)
Get detailed data about a Facebook post including reactions, comments, shares, and media
输入模式
{
"type": "object",
"properties": {
"link": {
"type": "string",
"description": "Facebook post URL"
}
},
"required": [
"link"
]
}输出模式
{
"type": "object",
"properties": {
"result": {
"description": "JSON response from the SocialAPIs REST endpoint, unchanged. Object or array depending on the endpoint; most include a `meta` block (statusCode, duration, creditsCharged, creditsRemaining)."
},
"creditsCharged": {
"type": [
"integer",
"null"
],
"description": "Credits charged for this call, or null if the endpoint did not report it."
},
"creditsRemaining": {
"type": [
"integer",
"null"
],
"description": "Credits left on the API key after this call, or null if not reported."
}
},
"required": [
"result"
]
}🟢facebook_get_post_details_extended(link)
Get extended details about a Facebook post — includes view counts (essential for reels / video posts), video URLs, music/audio metadata, and author verification status. Use this when the standard post_details response is missing fields like view_count, video_hd_src, or attached_track.
输入模式
{
"type": "object",
"properties": {
"link": {
"type": "string",
"description": "Facebook post URL (works for reels, video posts, and regular posts)"
}
},
"required": [
"link"
]
}输出模式
{
"type": "object",
"properties": {
"result": {
"description": "JSON response from the SocialAPIs REST endpoint, unchanged. Object or array depending on the endpoint; most include a `meta` block (statusCode, duration, creditsCharged, creditsRemaining)."
},
"creditsCharged": {
"type": [
"integer",
"null"
],
"description": "Credits charged for this call, or null if the endpoint did not report it."
},
"creditsRemaining": {
"type": [
"integer",
"null"
],
"description": "Credits left on the API key after this call, or null if not reported."
}
},
"required": [
"result"
]
}🟢facebook_get_post_attachments(post_id)
Get all media attachments (images, videos) from a Facebook post. Pricing: 5 credits per call (deeper scrape than standard post-details).
输入模式
{
"type": "object",
"properties": {
"post_id": {
"type": "string",
"description": "Facebook post ID"
}
},
"required": [
"post_id"
]
}输出模式
{
"type": "object",
"properties": {
"result": {
"description": "JSON response from the SocialAPIs REST endpoint, unchanged. Object or array depending on the endpoint; most include a `meta` block (statusCode, duration, creditsCharged, creditsRemaining)."
},
"creditsCharged": {
"type": [
"integer",
"null"
],
"description": "Credits charged for this call, or null if the endpoint did not report it."
},
"creditsRemaining": {
"type": [
"integer",
"null"
],
"description": "Credits left on the API key after this call, or null if not reported."
}
},
"required": [
"result"
]
}🟢facebook_get_video_details(video_id)
Get video metadata, stats, and context for a Facebook video post
输入模式
{
"type": "object",
"properties": {
"video_id": {
"type": "string",
"description": "Facebook video ID"
}
},
"required": [
"video_id"
]
}输出模式
{
"type": "object",
"properties": {
"result": {
"description": "JSON response from the SocialAPIs REST endpoint, unchanged. Object or array depending on the endpoint; most include a `meta` block (statusCode, duration, creditsCharged, creditsRemaining)."
},
"creditsCharged": {
"type": [
"integer",
"null"
],
"description": "Credits charged for this call, or null if the endpoint did not report it."
},
"creditsRemaining": {
"type": [
"integer",
"null"
],
"description": "Credits left on the API key after this call, or null if not reported."
}
},
"required": [
"result"
]
}🟢facebook_get_post_comments(link, limit, end_cursor, include_reply_info)
Retrieve top-level comments from a Facebook post or reel with pagination. Pricing: 1 credit per call.
输入模式
{
"type": "object",
"properties": {
"link": {
"type": "string",
"description": "Facebook post or reel URL"
},
"limit": {
"type": "number",
"description": "Maximum number of comments to return. Default: 10. Maximum: 30.",
"maximum": 30
},
"end_cursor": {
"type": "string",
"description": "Pagination cursor for next page of comments"
},
"include_reply_info": {
"type": "string",
"description": "When \"true\", includes comment_feedback_id and expansion_token for fetching replies"
}
},
"required": [
"link"
]
}输出模式
{
"type": "object",
"properties": {
"result": {
"description": "JSON response from the SocialAPIs REST endpoint, unchanged. Object or array depending on the endpoint; most include a `meta` block (statusCode, duration, creditsCharged, creditsRemaining)."
},
"creditsCharged": {
"type": [
"integer",
"null"
],
"description": "Credits charged for this call, or null if the endpoint did not report it."
},
"creditsRemaining": {
"type": [
"integer",
"null"
],
"description": "Credits left on the API key after this call, or null if not reported."
}
},
"required": [
"result"
]
}🟢facebook_get_comment_replies(comment_feedback_id, expansion_token)
Fetch replies to a specific comment on a Facebook post
输入模式
{
"type": "object",
"properties": {
"comment_feedback_id": {
"type": "string",
"description": "Feedback ID from the comments endpoint with include_reply_info=true"
},
"expansion_token": {
"type": "string",
"description": "Expansion token from the comments endpoint with include_reply_info=true"
}
},
"required": [
"comment_feedback_id",
"expansion_token"
]
}输出模式
{
"type": "object",
"properties": {
"result": {
"description": "JSON response from the SocialAPIs REST endpoint, unchanged. Object or array depending on the endpoint; most include a `meta` block (statusCode, duration, creditsCharged, creditsRemaining)."
},
"creditsCharged": {
"type": [
"integer",
"null"
],
"description": "Credits charged for this call, or null if the endpoint did not report it."
},
"creditsRemaining": {
"type": [
"integer",
"null"
],
"description": "Credits left on the API key after this call, or null if not reported."
}
},
"required": [
"result"
]
}🟢facebook_search_pages(query, location_uid, end_cursor)
Search for Facebook pages by keyword with optional location filtering
输入模式
{
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "Search query"
},
"location_uid": {
"type": "string",
"description": "Location UID for filtering (from search/locations endpoint)"
},
"end_cursor": {
"type": "string",
"description": "Pagination cursor"
}
},
"required": [
"query"
]
}输出模式
{
"type": "object",
"properties": {
"result": {
"description": "JSON response from the SocialAPIs REST endpoint, unchanged. Object or array depending on the endpoint; most include a `meta` block (statusCode, duration, creditsCharged, creditsRemaining)."
},
"creditsCharged": {
"type": [
"integer",
"null"
],
"description": "Credits charged for this call, or null if the endpoint did not report it."
},
"creditsRemaining": {
"type": [
"integer",
"null"
],
"description": "Credits left on the API key after this call, or null if not reported."
}
},
"required": [
"result"
]
}🟢facebook_search_people(query, location_uid, end_cursor)
Search for Facebook people/profiles by keyword with optional location filtering
输入模式
{
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "Search query"
},
"location_uid": {
"type": "string",
"description": "Location UID for filtering"
},
"end_cursor": {
"type": "string",
"description": "Pagination cursor"
}
},
"required": [
"query"
]
}输出模式
{
"type": "object",
"properties": {
"result": {
"description": "JSON response from the SocialAPIs REST endpoint, unchanged. Object or array depending on the endpoint; most include a `meta` block (statusCode, duration, creditsCharged, creditsRemaining)."
},
"creditsCharged": {
"type": [
"integer",
"null"
],
"description": "Credits charged for this call, or null if the endpoint did not report it."
},
"creditsRemaining": {
"type": [
"integer",
"null"
],
"description": "Credits left on the API key after this call, or null if not reported."
}
},
"required": [
"result"
]
}🟢facebook_search_locations(query)
Search for Facebook locations by keyword. Returns UIDs for geo-filtering other search endpoints.
输入模式
{
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "Search query (city, place, landmark)"
}
},
"required": [
"query"
]
}输出模式
{
"type": "object",
"properties": {
"result": {
"description": "JSON response from the SocialAPIs REST endpoint, unchanged. Object or array depending on the endpoint; most include a `meta` block (statusCode, duration, creditsCharged, creditsRemaining)."
},
"creditsCharged": {
"type": [
"integer",
"null"
],
"description": "Credits charged for this call, or null if the endpoint did not report it."
},
"creditsRemaining": {
"type": [
"integer",
"null"
],
"description": "Credits left on the API key after this call, or null if not reported."
}
},
"required": [
"result"
]
}🟢facebook_search_posts(query, location_uid, start_time, end_time, recent_posts, ...)
Search for Facebook posts by keyword with optional location and time filters
输入模式
{
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "Search query"
},
"location_uid": {
"type": "string",
"description": "Location UID for filtering"
},
"start_time": {
"type": "string",
"description": "Filter posts after this date (YYYY-MM-DD)"
},
"end_time": {
"type": "string",
"description": "Filter posts before this date (YYYY-MM-DD)"
},
"recent_posts": {
"type": "string",
"description": "When \"true\", shows only recent posts"
},
"end_cursor": {
"type": "string",
"description": "Pagination cursor"
}
},
"required": [
"query"
]
}输出模式
{
"type": "object",
"properties": {
"result": {
"description": "JSON response from the SocialAPIs REST endpoint, unchanged. Object or array depending on the endpoint; most include a `meta` block (statusCode, duration, creditsCharged, creditsRemaining)."
},
"creditsCharged": {
"type": [
"integer",
"null"
],
"description": "Credits charged for this call, or null if the endpoint did not report it."
},
"creditsRemaining": {
"type": [
"integer",
"null"
],
"description": "Credits left on the API key after this call, or null if not reported."
}
},
"required": [
"result"
]
}🟢facebook_search_videos(query, most_recent, videos_live, fields, end_cursor)
Search for Facebook videos by keyword with optional recency and live filters
输入模式
{
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "Search query"
},
"most_recent": {
"type": "string",
"description": "When \"true\", shows most recent videos first"
},
"videos_live": {
"type": "string",
"description": "When \"true\", filters for live videos only"
},
"fields": {
"type": "string",
"description": "Comma-separated list of response fields to include"
},
"end_cursor": {
"type": "string",
"description": "Pagination cursor"
}
},
"required": [
"query"
]
}输出模式
{
"type": "object",
"properties": {
"result": {
"description": "JSON response from the SocialAPIs REST endpoint, unchanged. Object or array depending on the endpoint; most include a `meta` block (statusCode, duration, creditsCharged, creditsRemaining)."
},
"creditsCharged": {
"type": [
"integer",
"null"
],
"description": "Credits charged for this call, or null if the endpoint did not report it."
},
"creditsRemaining": {
"type": [
"integer",
"null"
],
"description": "Credits left on the API key after this call, or null if not reported."
}
},
"required": [
"result"
]
}🟢facebook_ads_search(query, ad_page_id, country, activeStatus, after_time, ...)
Search ads in the Meta Ad Library by keyword or page ID with country, status, and date filters
输入模式
{
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "Search keyword for ads"
},
"ad_page_id": {
"type": "string",
"description": "Facebook AD Page ID (alternative to query)"
},
"country": {
"type": "string",
"description": "ISO country code or \"ALL\""
},
"activeStatus": {
"type": "string",
"description": "Filter: ALL, Active, or Inactive"
},
"after_time": {
"type": "string",
"description": "Filter ads after this date (YYYY-MM-DD)"
},
"before_time": {
"type": "string",
"description": "Filter ads before this date (YYYY-MM-DD)"
},
"sort_data": {
"type": "string",
"description": "Sort by \"impressions\" or \"recent\""
},
"end_cursor": {
"type": "string",
"description": "Pagination cursor"
}
},
"required": []
}输出模式
{
"type": "object",
"properties": {
"result": {
"description": "JSON response from the SocialAPIs REST endpoint, unchanged. Object or array depending on the endpoint; most include a `meta` block (statusCode, duration, creditsCharged, creditsRemaining)."
},
"creditsCharged": {
"type": [
"integer",
"null"
],
"description": "Credits charged for this call, or null if the endpoint did not report it."
},
"creditsRemaining": {
"type": [
"integer",
"null"
],
"description": "Credits left on the API key after this call, or null if not reported."
}
},
"required": [
"result"
]
}🟢facebook_ads_page_details(page_id)
Get detailed info about a specific Facebook page from the Ads Library
输入模式
{
"type": "object",
"properties": {
"page_id": {
"type": "string",
"description": "Facebook Page ID"
}
},
"required": [
"page_id"
]
}输出模式
{
"type": "object",
"properties": {
"result": {
"description": "JSON response from the SocialAPIs REST endpoint, unchanged. Object or array depending on the endpoint; most include a `meta` block (statusCode, duration, creditsCharged, creditsRemaining)."
},
"creditsCharged": {
"type": [
"integer",
"null"
],
"description": "Credits charged for this call, or null if the endpoint did not report it."
},
"creditsRemaining": {
"type": [
"integer",
"null"
],
"description": "Credits left on the API key after this call, or null if not reported."
}
},
"required": [
"result"
]
}🟢facebook_ads_archive_details(ad_archive_id, page_id, country, is_ad_non_political, is_ad_not_aaa_eligible)
Get detailed info about a specific archived ad including creative, spend, and impressions
输入模式
{
"type": "object",
"properties": {
"ad_archive_id": {
"type": "string",
"description": "Ad Archive ID"
},
"page_id": {
"type": "string",
"description": "Facebook Page ID"
},
"country": {
"type": "string",
"description": "ISO country code or \"ALL\""
},
"is_ad_non_political": {
"type": "string",
"description": "Filter non-political ads"
},
"is_ad_not_aaa_eligible": {
"type": "string",
"description": "Filter AAA eligibility"
}
},
"required": [
"ad_archive_id"
]
}输出模式
{
"type": "object",
"properties": {
"result": {
"description": "JSON response from the SocialAPIs REST endpoint, unchanged. Object or array depending on the endpoint; most include a `meta` block (statusCode, duration, creditsCharged, creditsRemaining)."
},
"creditsCharged": {
"type": [
"integer",
"null"
],
"description": "Credits charged for this call, or null if the endpoint did not report it."
},
"creditsRemaining": {
"type": [
"integer",
"null"
],
"description": "Credits left on the API key after this call, or null if not reported."
}
},
"required": [
"result"
]
}🟢facebook_ads_keywords(query, country)
Search for ads by keyword with optional country filter
输入模式
{
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "Search keyword"
},
"country": {
"type": "string",
"description": "ISO country code or \"ALL\""
}
},
"required": [
"query"
]
}输出模式
{
"type": "object",
"properties": {
"result": {
"description": "JSON response from the SocialAPIs REST endpoint, unchanged. Object or array depending on the endpoint; most include a `meta` block (statusCode, duration, creditsCharged, creditsRemaining)."
},
"creditsCharged": {
"type": [
"integer",
"null"
],
"description": "Credits charged for this call, or null if the endpoint did not report it."
},
"creditsRemaining": {
"type": [
"integer",
"null"
],
"description": "Credits left on the API key after this call, or null if not reported."
}
},
"required": [
"result"
]
}🟢facebook_ads_countries
Get list of supported country codes for Meta Ads Library filtering
输入模式
{
"type": "object",
"properties": {},
"required": []
}输出模式
{
"type": "object",
"properties": {
"result": {
"description": "JSON response from the SocialAPIs REST endpoint, unchanged. Object or array depending on the endpoint; most include a `meta` block (statusCode, duration, creditsCharged, creditsRemaining)."
},
"creditsCharged": {
"type": [
"integer",
"null"
],
"description": "Credits charged for this call, or null if the endpoint did not report it."
},
"creditsRemaining": {
"type": [
"integer",
"null"
],
"description": "Credits left on the API key after this call, or null if not reported."
}
},
"required": [
"result"
]
}🟢facebook_marketplace_search(query, category_url, commerce_search_sort_by, commerce_search_and_rp_condition, filter_location_latitude, ...)
Search Facebook Marketplace items with filters for location, price, category, condition, and sort order. Pricing: 1 credit per call.
输入模式
{
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "Search term"
},
"category_url": {
"type": "string",
"description": "Category URL slug"
},
"commerce_search_sort_by": {
"type": "string",
"description": "Sort: BEST_MATCH, CREATION_TIME_DESCEND, PRICE_ASCEND, etc."
},
"commerce_search_and_rp_condition": {
"type": "string",
"description": "Condition: new, used_like_new, used_good, used_fair"
},
"filter_location_latitude": {
"type": "string",
"description": "GPS latitude"
},
"filter_location_longitude": {
"type": "string",
"description": "GPS longitude"
},
"filter_price_lower_bound": {
"type": "string",
"description": "Minimum price"
},
"filter_price_upper_bound": {
"type": "string",
"description": "Maximum price"
},
"filter_radius_km": {
"type": "string",
"description": "Radius in km"
},
"posted_today": {
"type": "string",
"description": "When \"true\", limit to items posted today"
},
"exact_match": {
"type": "string",
"description": "When \"true\", exact match search"
},
"limit": {
"type": "number",
"description": "Maximum number of items to return. Default: 24."
},
"end_cursor": {
"type": "string",
"description": "Pagination cursor"
}
},
"required": []
}输出模式
{
"type": "object",
"properties": {
"result": {
"description": "JSON response from the SocialAPIs REST endpoint, unchanged. Object or array depending on the endpoint; most include a `meta` block (statusCode, duration, creditsCharged, creditsRemaining)."
},
"creditsCharged": {
"type": [
"integer",
"null"
],
"description": "Credits charged for this call, or null if the endpoint did not report it."
},
"creditsRemaining": {
"type": [
"integer",
"null"
],
"description": "Credits left on the API key after this call, or null if not reported."
}
},
"required": [
"result"
]
}🟢facebook_marketplace_listing(listing_id)
Get detailed info about a single Marketplace listing
输入模式
{
"type": "object",
"properties": {
"listing_id": {
"type": "string",
"description": "Marketplace Listing ID"
}
},
"required": [
"listing_id"
]
}输出模式
{
"type": "object",
"properties": {
"result": {
"description": "JSON response from the SocialAPIs REST endpoint, unchanged. Object or array depending on the endpoint; most include a `meta` block (statusCode, duration, creditsCharged, creditsRemaining)."
},
"creditsCharged": {
"type": [
"integer",
"null"
],
"description": "Credits charged for this call, or null if the endpoint did not report it."
},
"creditsRemaining": {
"type": [
"integer",
"null"
],
"description": "Credits left on the API key after this call, or null if not reported."
}
},
"required": [
"result"
]
}🟢facebook_marketplace_seller(seller_id)
Get seller profile, ratings, reviews, and badges
输入模式
{
"type": "object",
"properties": {
"seller_id": {
"type": "string",
"description": "Seller ID"
}
},
"required": [
"seller_id"
]
}输出模式
{
"type": "object",
"properties": {
"result": {
"description": "JSON response from the SocialAPIs REST endpoint, unchanged. Object or array depending on the endpoint; most include a `meta` block (statusCode, duration, creditsCharged, creditsRemaining)."
},
"creditsCharged": {
"type": [
"integer",
"null"
],
"description": "Credits charged for this call, or null if the endpoint did not report it."
},
"creditsRemaining": {
"type": [
"integer",
"null"
],
"description": "Credits left on the API key after this call, or null if not reported."
}
},
"required": [
"result"
]
}🟢facebook_marketplace_categories
Get all Marketplace categories with SEO URLs and category IDs
输入模式
{
"type": "object",
"properties": {},
"required": []
}输出模式
{
"type": "object",
"properties": {
"result": {
"description": "JSON response from the SocialAPIs REST endpoint, unchanged. Object or array depending on the endpoint; most include a `meta` block (statusCode, duration, creditsCharged, creditsRemaining)."
},
"creditsCharged": {
"type": [
"integer",
"null"
],
"description": "Credits charged for this call, or null if the endpoint did not report it."
},
"creditsRemaining": {
"type": [
"integer",
"null"
],
"description": "Credits left on the API key after this call, or null if not reported."
}
},
"required": [
"result"
]
}🟢facebook_marketplace_city_coordinates(city, country, exactly_one)
Get GPS coordinates for a city to use as Marketplace location filters
输入模式
{
"type": "object",
"properties": {
"city": {
"type": "string",
"description": "City name"
},
"country": {
"type": "string",
"description": "Country name or code"
},
"exactly_one": {
"type": "string",
"description": "When \"true\", return exactly one result"
}
},
"required": [
"city"
]
}输出模式
{
"type": "object",
"properties": {
"result": {
"description": "JSON response from the SocialAPIs REST endpoint, unchanged. Object or array depending on the endpoint; most include a `meta` block (statusCode, duration, creditsCharged, creditsRemaining)."
},
"creditsCharged": {
"type": [
"integer",
"null"
],
"description": "Credits charged for this call, or null if the endpoint did not report it."
},
"creditsRemaining": {
"type": [
"integer",
"null"
],
"description": "Credits left on the API key after this call, or null if not reported."
}
},
"required": [
"result"
]
}🟢facebook_marketplace_vehicles(sort_by, filter_location_latitude, filter_location_longitude, filter_price_lower_bound, filter_price_upper_bound, ...)
Search Marketplace vehicle listings with filters for location, price, mileage, year
输入模式
{
"type": "object",
"properties": {
"sort_by": {
"type": "string",
"description": "Sort: CREATION_TIME_DESCEND, PRICE_ASCEND, VEHICLE_MILEAGE_ASCEND, etc."
},
"filter_location_latitude": {
"type": "string",
"description": "GPS latitude"
},
"filter_location_longitude": {
"type": "string",
"description": "GPS longitude"
},
"filter_price_lower_bound": {
"type": "string",
"description": "Minimum price"
},
"filter_price_upper_bound": {
"type": "string",
"description": "Maximum price"
},
"filter_radius_km": {
"type": "string",
"description": "Radius in km"
},
"is_c2c_listing_only": {
"type": "string",
"description": "Individual sellers only"
},
"end_cursor": {
"type": "string",
"description": "Pagination cursor"
}
},
"required": []
}输出模式
{
"type": "object",
"properties": {
"result": {
"description": "JSON response from the SocialAPIs REST endpoint, unchanged. Object or array depending on the endpoint; most include a `meta` block (statusCode, duration, creditsCharged, creditsRemaining)."
},
"creditsCharged": {
"type": [
"integer",
"null"
],
"description": "Credits charged for this call, or null if the endpoint did not report it."
},
"creditsRemaining": {
"type": [
"integer",
"null"
],
"description": "Credits left on the API key after this call, or null if not reported."
}
},
"required": [
"result"
]
}🟢facebook_marketplace_rentals(sort_by, filter_location_latitude, filter_location_longitude, filter_price_lower_bound, filter_price_upper_bound, ...)
Search Marketplace rental property listings with filters for bedrooms, bathrooms, location, price
输入模式
{
"type": "object",
"properties": {
"sort_by": {
"type": "string",
"description": "Sort: CREATION_TIME_DESCEND, PRICE_ASCEND, BEST_MATCH"
},
"filter_location_latitude": {
"type": "string",
"description": "GPS latitude"
},
"filter_location_longitude": {
"type": "string",
"description": "GPS longitude"
},
"filter_price_lower_bound": {
"type": "string",
"description": "Minimum price"
},
"filter_price_upper_bound": {
"type": "string",
"description": "Maximum price"
},
"filter_radius_km": {
"type": "string",
"description": "Radius in km"
},
"filter_bedrooms_min": {
"type": "string",
"description": "Min bedrooms"
},
"filter_bedrooms_max": {
"type": "string",
"description": "Max bedrooms"
},
"filter_bathrooms_min": {
"type": "string",
"description": "Min bathrooms"
},
"filter_bathrooms_max": {
"type": "string",
"description": "Max bathrooms"
},
"end_cursor": {
"type": "string",
"description": "Pagination cursor"
}
},
"required": []
}输出模式
{
"type": "object",
"properties": {
"result": {
"description": "JSON response from the SocialAPIs REST endpoint, unchanged. Object or array depending on the endpoint; most include a `meta` block (statusCode, duration, creditsCharged, creditsRemaining)."
},
"creditsCharged": {
"type": [
"integer",
"null"
],
"description": "Credits charged for this call, or null if the endpoint did not report it."
},
"creditsRemaining": {
"type": [
"integer",
"null"
],
"description": "Credits left on the API key after this call, or null if not reported."
}
},
"required": [
"result"
]
}🟢facebook_download_media(url)
Download images, videos, and audio from Facebook URLs
输入模式
{
"type": "object",
"properties": {
"url": {
"type": "string",
"description": "Facebook media URL to download"
}
},
"required": [
"url"
]
}输出模式
{
"type": "object",
"properties": {
"result": {
"description": "JSON response from the SocialAPIs REST endpoint, unchanged. Object or array depending on the endpoint; most include a `meta` block (statusCode, duration, creditsCharged, creditsRemaining)."
},
"creditsCharged": {
"type": [
"integer",
"null"
],
"description": "Credits charged for this call, or null if the endpoint did not report it."
},
"creditsRemaining": {
"type": [
"integer",
"null"
],
"description": "Credits left on the API key after this call, or null if not reported."
}
},
"required": [
"result"
]
}🟢instagram_get_user_id(link, username)
Get the unique ID of any Instagram profile from a link or username
输入模式
{
"type": "object",
"properties": {
"link": {
"type": "string",
"description": "Instagram profile URL"
},
"username": {
"type": "string",
"description": "Instagram username"
}
},
"required": []
}输出模式
{
"type": "object",
"properties": {
"result": {
"description": "JSON response from the SocialAPIs REST endpoint, unchanged. Object or array depending on the endpoint; most include a `meta` block (statusCode, duration, creditsCharged, creditsRemaining)."
},
"creditsCharged": {
"type": [
"integer",
"null"
],
"description": "Credits charged for this call, or null if the endpoint did not report it."
},
"creditsRemaining": {
"type": [
"integer",
"null"
],
"description": "Credits left on the API key after this call, or null if not reported."
}
},
"required": [
"result"
]
}🟢instagram_get_profile_details(username, link)
Get user profile information by username including bio, followers, posts count, verification, and related profiles
输入模式
{
"type": "object",
"properties": {
"username": {
"type": "string",
"description": "Instagram username"
},
"link": {
"type": "string",
"description": "Instagram profile URL (alternative to username)"
}
},
"required": [
"username"
]
}输出模式
{
"type": "object",
"properties": {
"result": {
"description": "JSON response from the SocialAPIs REST endpoint, unchanged. Object or array depending on the endpoint; most include a `meta` block (statusCode, duration, creditsCharged, creditsRemaining)."
},
"creditsCharged": {
"type": [
"integer",
"null"
],
"description": "Credits charged for this call, or null if the endpoint did not report it."
},
"creditsRemaining": {
"type": [
"integer",
"null"
],
"description": "Credits left on the API key after this call, or null if not reported."
}
},
"required": [
"result"
]
}🟢instagram_get_profile_posts(username, user_id, end_cursor)
Get posts from a user profile with pagination. Provide username (recommended for more results) or user_id.
输入模式
{
"type": "object",
"properties": {
"username": {
"type": "string",
"description": "Instagram username (recommended — returns more results)"
},
"user_id": {
"type": "string",
"description": "Instagram user ID (alternative)"
},
"end_cursor": {
"type": "string",
"description": "Pagination cursor for next page"
}
},
"required": []
}输出模式
{
"type": "object",
"properties": {
"result": {
"description": "JSON response from the SocialAPIs REST endpoint, unchanged. Object or array depending on the endpoint; most include a `meta` block (statusCode, duration, creditsCharged, creditsRemaining)."
},
"creditsCharged": {
"type": [
"integer",
"null"
],
"description": "Credits charged for this call, or null if the endpoint did not report it."
},
"creditsRemaining": {
"type": [
"integer",
"null"
],
"description": "Credits left on the API key after this call, or null if not reported."
}
},
"required": [
"result"
]
}🟢instagram_get_profile_reels(user_id, end_cursor)
Get reels from a user profile with pagination. Returns video details, play counts, and audio metadata.
输入模式
{
"type": "object",
"properties": {
"user_id": {
"type": "string",
"description": "Instagram user ID"
},
"end_cursor": {
"type": "string",
"description": "Pagination cursor for next page"
}
},
"required": [
"user_id"
]
}输出模式
{
"type": "object",
"properties": {
"result": {
"description": "JSON response from the SocialAPIs REST endpoint, unchanged. Object or array depending on the endpoint; most include a `meta` block (statusCode, duration, creditsCharged, creditsRemaining)."
},
"creditsCharged": {
"type": [
"integer",
"null"
],
"description": "Credits charged for this call, or null if the endpoint did not report it."
},
"creditsRemaining": {
"type": [
"integer",
"null"
],
"description": "Credits left on the API key after this call, or null if not reported."
}
},
"required": [
"result"
]
}🟢instagram_get_profile_highlights(user_id)
Get all highlights from a user profile including cover images, titles, and permalink URLs
输入模式
{
"type": "object",
"properties": {
"user_id": {
"type": "string",
"description": "Instagram user ID"
}
},
"required": [
"user_id"
]
}输出模式
{
"type": "object",
"properties": {
"result": {
"description": "JSON response from the SocialAPIs REST endpoint, unchanged. Object or array depending on the endpoint; most include a `meta` block (statusCode, duration, creditsCharged, creditsRemaining)."
},
"creditsCharged": {
"type": [
"integer",
"null"
],
"description": "Credits charged for this call, or null if the endpoint did not report it."
},
"creditsRemaining": {
"type": [
"integer",
"null"
],
"description": "Credits left on the API key after this call, or null if not reported."
}
},
"required": [
"result"
]
}🟢instagram_get_highlight_details(highlight_id)
Get details of a specific highlight by ID including all stories within the highlight
输入模式
{
"type": "object",
"properties": {
"highlight_id": {
"type": "string",
"description": "Highlight ID (from profile highlights endpoint)"
}
},
"required": [
"highlight_id"
]
}输出模式
{
"type": "object",
"properties": {
"result": {
"description": "JSON response from the SocialAPIs REST endpoint, unchanged. Object or array depending on the endpoint; most include a `meta` block (statusCode, duration, creditsCharged, creditsRemaining)."
},
"creditsCharged": {
"type": [
"integer",
"null"
],
"description": "Credits charged for this call, or null if the endpoint did not report it."
},
"creditsRemaining": {
"type": [
"integer",
"null"
],
"description": "Credits left on the API key after this call, or null if not reported."
}
},
"required": [
"result"
]
}🟢instagram_get_post_id(link)
Extract the post shortcode/ID from any Instagram post URL
输入模式
{
"type": "object",
"properties": {
"link": {
"type": "string",
"description": "Instagram post URL"
}
},
"required": [
"link"
]
}输出模式
{
"type": "object",
"properties": {
"result": {
"description": "JSON response from the SocialAPIs REST endpoint, unchanged. Object or array depending on the endpoint; most include a `meta` block (statusCode, duration, creditsCharged, creditsRemaining)."
},
"creditsCharged": {
"type": [
"integer",
"null"
],
"description": "Credits charged for this call, or null if the endpoint did not report it."
},
"creditsRemaining": {
"type": [
"integer",
"null"
],
"description": "Credits left on the API key after this call, or null if not reported."
}
},
"required": [
"result"
]
}🟢instagram_get_post_details(shortcode)
Get full details of a specific Instagram post including media, engagement, caption, and owner info
输入模式
{
"type": "object",
"properties": {
"shortcode": {
"type": "string",
"description": "Instagram post shortcode (e.g., DMF-GjGO0-q)"
}
},
"required": [
"shortcode"
]
}输出模式
{
"type": "object",
"properties": {
"result": {
"description": "JSON response from the SocialAPIs REST endpoint, unchanged. Object or array depending on the endpoint; most include a `meta` block (statusCode, duration, creditsCharged, creditsRemaining)."
},
"creditsCharged": {
"type": [
"integer",
"null"
],
"description": "Credits charged for this call, or null if the endpoint did not report it."
},
"creditsRemaining": {
"type": [
"integer",
"null"
],
"description": "Credits left on the API key after this call, or null if not reported."
}
},
"required": [
"result"
]
}🟢instagram_get_reels_feed(clips_media_id)
Get Instagram Reels feed with recommended, trending, or same-author chained clips
输入模式
{
"type": "object",
"properties": {
"clips_media_id": {
"type": "string",
"description": "Clip media ID for chaining/pagination (from previous response)"
}
},
"required": []
}输出模式
{
"type": "object",
"properties": {
"result": {
"description": "JSON response from the SocialAPIs REST endpoint, unchanged. Object or array depending on the endpoint; most include a `meta` block (statusCode, duration, creditsCharged, creditsRemaining)."
},
"creditsCharged": {
"type": [
"integer",
"null"
],
"description": "Credits charged for this call, or null if the endpoint did not report it."
},
"creditsRemaining": {
"type": [
"integer",
"null"
],
"description": "Credits left on the API key after this call, or null if not reported."
}
},
"required": [
"result"
]
}🟢instagram_get_reels_by_audio(audio_id, max_id)
Get Instagram Reels associated with a specific audio/music ID. Find all reels using a particular sound.
输入模式
{
"type": "object",
"properties": {
"audio_id": {
"type": "string",
"description": "Audio cluster ID (music ID)"
},
"max_id": {
"type": "string",
"description": "Pagination cursor for next page"
}
},
"required": [
"audio_id"
]
}输出模式
{
"type": "object",
"properties": {
"result": {
"description": "JSON response from the SocialAPIs REST endpoint, unchanged. Object or array depending on the endpoint; most include a `meta` block (statusCode, duration, creditsCharged, creditsRemaining)."
},
"creditsCharged": {
"type": [
"integer",
"null"
],
"description": "Credits charged for this call, or null if the endpoint did not report it."
},
"creditsRemaining": {
"type": [
"integer",
"null"
],
"description": "Credits left on the API key after this call, or null if not reported."
}
},
"required": [
"result"
]
}🟢instagram_popular_search(keyword, end_cursor)
Search Instagram by keyword and get popular results including users, hashtags, and places
输入模式
{
"type": "object",
"properties": {
"keyword": {
"type": "string",
"description": "Search keyword/query"
},
"end_cursor": {
"type": "string",
"description": "Pagination cursor for next page"
}
},
"required": [
"keyword"
]
}输出模式
{
"type": "object",
"properties": {
"result": {
"description": "JSON response from the SocialAPIs REST endpoint, unchanged. Object or array depending on the endpoint; most include a `meta` block (statusCode, duration, creditsCharged, creditsRemaining)."
},
"creditsCharged": {
"type": [
"integer",
"null"
],
"description": "Credits charged for this call, or null if the endpoint did not report it."
},
"creditsRemaining": {
"type": [
"integer",
"null"
],
"description": "Credits left on the API key after this call, or null if not reported."
}
},
"required": [
"result"
]
}🟢instagram_get_location_posts(location_id, tab, end_cursor)
Get Instagram posts from a specific location. Retrieve top/ranked or most recent posts tagged at a place.
输入模式
{
"type": "object",
"properties": {
"location_id": {
"type": "string",
"description": "Instagram location ID"
},
"tab": {
"type": "string",
"description": "Filter: \"recent\" or \"ranked\""
},
"end_cursor": {
"type": "string",
"description": "Pagination cursor for next page"
}
},
"required": [
"location_id"
]
}输出模式
{
"type": "object",
"properties": {
"result": {
"description": "JSON response from the SocialAPIs REST endpoint, unchanged. Object or array depending on the endpoint; most include a `meta` block (statusCode, duration, creditsCharged, creditsRemaining)."
},
"creditsCharged": {
"type": [
"integer",
"null"
],
"description": "Credits charged for this call, or null if the endpoint did not report it."
},
"creditsRemaining": {
"type": [
"integer",
"null"
],
"description": "Credits left on the API key after this call, or null if not reported."
}
},
"required": [
"result"
]
}🟢instagram_get_nearby_locations(location_id)
Get nearby places/locations for a specific Instagram location including name, category, coordinates, and post count
输入模式
{
"type": "object",
"properties": {
"location_id": {
"type": "string",
"description": "Instagram location ID"
}
},
"required": [
"location_id"
]
}输出模式
{
"type": "object",
"properties": {
"result": {
"description": "JSON response from the SocialAPIs REST endpoint, unchanged. Object or array depending on the endpoint; most include a `meta` block (statusCode, duration, creditsCharged, creditsRemaining)."
},
"creditsCharged": {
"type": [
"integer",
"null"
],
"description": "Credits charged for this call, or null if the endpoint did not report it."
},
"creditsRemaining": {
"type": [
"integer",
"null"
],
"description": "Credits left on the API key after this call, or null if not reported."
}
},
"required": [
"result"
]
}社区
证据
最近观测
已验证未记录版本47 个工具