Server definition
- Hash
- sha256:4552a7671fcfee119bba6aafa0dba6c1cddd1e2baab08220ce77246cf12ea5bb
- What it is
- What a remote MCP server returned when asked what it offers: 47 tools
The blob, as servednamed by its sha256
{
"instructions": null,
"tools": [
{
"description": "Get detailed info about a specific archived ad including creative, spend, and impressions",
"inputSchema": {
"properties": {
"ad_archive_id": {
"description": "Ad Archive ID",
"type": "string"
},
"country": {
"description": "ISO country code or \"ALL\"",
"type": "string"
},
"is_ad_non_political": {
"description": "Filter non-political ads",
"type": "string"
},
"is_ad_not_aaa_eligible": {
"description": "Filter AAA eligibility",
"type": "string"
},
"page_id": {
"description": "Facebook Page ID",
"type": "string"
}
},
"required": [
"ad_archive_id"
],
"type": "object"
},
"name": "facebook_ads_archive_details",
"outputSchema": {
"properties": {
"creditsCharged": {
"description": "Credits charged for this call, or null if the endpoint did not report it.",
"type": [
"integer",
"null"
]
},
"creditsRemaining": {
"description": "Credits left on the API key after this call, or null if not reported.",
"type": [
"integer",
"null"
]
},
"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)."
}
},
"required": [
"result"
],
"type": "object"
}
},
{
"description": "Get list of supported country codes for Meta Ads Library filtering",
"inputSchema": {
"properties": {},
"required": [],
"type": "object"
},
"name": "facebook_ads_countries",
"outputSchema": {
"properties": {
"creditsCharged": {
"description": "Credits charged for this call, or null if the endpoint did not report it.",
"type": [
"integer",
"null"
]
},
"creditsRemaining": {
"description": "Credits left on the API key after this call, or null if not reported.",
"type": [
"integer",
"null"
]
},
"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)."
}
},
"required": [
"result"
],
"type": "object"
}
},
{
"description": "Search for ads by keyword with optional country filter",
"inputSchema": {
"properties": {
"country": {
"description": "ISO country code or \"ALL\"",
"type": "string"
},
"query": {
"description": "Search keyword",
"type": "string"
}
},
"required": [
"query"
],
"type": "object"
},
"name": "facebook_ads_keywords",
"outputSchema": {
"properties": {
"creditsCharged": {
"description": "Credits charged for this call, or null if the endpoint did not report it.",
"type": [
"integer",
"null"
]
},
"creditsRemaining": {
"description": "Credits left on the API key after this call, or null if not reported.",
"type": [
"integer",
"null"
]
},
"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)."
}
},
"required": [
"result"
],
"type": "object"
}
},
{
"description": "Get detailed info about a specific Facebook page from the Ads Library",
"inputSchema": {
"properties": {
"page_id": {
"description": "Facebook Page ID",
"type": "string"
}
},
"required": [
"page_id"
],
"type": "object"
},
"name": "facebook_ads_page_details",
"outputSchema": {
"properties": {
"creditsCharged": {
"description": "Credits charged for this call, or null if the endpoint did not report it.",
"type": [
"integer",
"null"
]
},
"creditsRemaining": {
"description": "Credits left on the API key after this call, or null if not reported.",
"type": [
"integer",
"null"
]
},
"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)."
}
},
"required": [
"result"
],
"type": "object"
}
},
{
"description": "Search ads in the Meta Ad Library by keyword or page ID with country, status, and date filters",
"inputSchema": {
"properties": {
"activeStatus": {
"description": "Filter: ALL, Active, or Inactive",
"type": "string"
},
"ad_page_id": {
"description": "Facebook AD Page ID (alternative to query)",
"type": "string"
},
"after_time": {
"description": "Filter ads after this date (YYYY-MM-DD)",
"type": "string"
},
"before_time": {
"description": "Filter ads before this date (YYYY-MM-DD)",
"type": "string"
},
"country": {
"description": "ISO country code or \"ALL\"",
"type": "string"
},
"end_cursor": {
"description": "Pagination cursor",
"type": "string"
},
"query": {
"description": "Search keyword for ads",
"type": "string"
},
"sort_data": {
"description": "Sort by \"impressions\" or \"recent\"",
"type": "string"
}
},
"required": [],
"type": "object"
},
"name": "facebook_ads_search",
"outputSchema": {
"properties": {
"creditsCharged": {
"description": "Credits charged for this call, or null if the endpoint did not report it.",
"type": [
"integer",
"null"
]
},
"creditsRemaining": {
"description": "Credits left on the API key after this call, or null if not reported.",
"type": [
"integer",
"null"
]
},
"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)."
}
},
"required": [
"result"
],
"type": "object"
}
},
{
"description": "Download images, videos, and audio from Facebook URLs",
"inputSchema": {
"properties": {
"url": {
"description": "Facebook media URL to download",
"type": "string"
}
},
"required": [
"url"
],
"type": "object"
},
"name": "facebook_download_media",
"outputSchema": {
"properties": {
"creditsCharged": {
"description": "Credits charged for this call, or null if the endpoint did not report it.",
"type": [
"integer",
"null"
]
},
"creditsRemaining": {
"description": "Credits left on the API key after this call, or null if not reported.",
"type": [
"integer",
"null"
]
},
"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)."
}
},
"required": [
"result"
],
"type": "object"
}
},
{
"description": "Fetch replies to a specific comment on a Facebook post",
"inputSchema": {
"properties": {
"comment_feedback_id": {
"description": "Feedback ID from the comments endpoint with include_reply_info=true",
"type": "string"
},
"expansion_token": {
"description": "Expansion token from the comments endpoint with include_reply_info=true",
"type": "string"
}
},
"required": [
"comment_feedback_id",
"expansion_token"
],
"type": "object"
},
"name": "facebook_get_comment_replies",
"outputSchema": {
"properties": {
"creditsCharged": {
"description": "Credits charged for this call, or null if the endpoint did not report it.",
"type": [
"integer",
"null"
]
},
"creditsRemaining": {
"description": "Credits left on the API key after this call, or null if not reported.",
"type": [
"integer",
"null"
]
},
"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)."
}
},
"required": [
"result"
],
"type": "object"
}
},
{
"description": "Get detailed metadata about a Facebook group including member count, description, rules, and activity stats",
"inputSchema": {
"properties": {
"link": {
"description": "Facebook group URL",
"type": "string"
}
},
"required": [
"link"
],
"type": "object"
},
"name": "facebook_get_group_details",
"outputSchema": {
"properties": {
"creditsCharged": {
"description": "Credits charged for this call, or null if the endpoint did not report it.",
"type": [
"integer",
"null"
]
},
"creditsRemaining": {
"description": "Credits left on the API key after this call, or null if not reported.",
"type": [
"integer",
"null"
]
},
"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)."
}
},
"required": [
"result"
],
"type": "object"
}
},
{
"description": "Get Facebook group ID from a group URL",
"inputSchema": {
"properties": {
"link": {
"description": "Facebook group URL",
"type": "string"
}
},
"required": [
"link"
],
"type": "object"
},
"name": "facebook_get_group_id",
"outputSchema": {
"properties": {
"creditsCharged": {
"description": "Credits charged for this call, or null if the endpoint did not report it.",
"type": [
"integer",
"null"
]
},
"creditsRemaining": {
"description": "Credits left on the API key after this call, or null if not reported.",
"type": [
"integer",
"null"
]
},
"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)."
}
},
"required": [
"result"
],
"type": "object"
}
},
{
"description": "Fetch recent posts from a Facebook group with pagination and time filtering. Pricing: ceil(posts_returned / 3) credits per call, minimum 1.",
"inputSchema": {
"properties": {
"after_time": {
"description": "ISO 8601 timestamp",
"type": "string"
},
"before_time": {
"description": "ISO 8601 timestamp",
"type": "string"
},
"end_cursor": {
"description": "Pagination cursor",
"type": "string"
},
"limit": {
"description": "Maximum number of posts to return. Default: 3. Minimum: 3. Maximum: 9.",
"maximum": 9,
"minimum": 3,
"type": "number"
},
"link": {
"description": "Facebook group URL",
"type": "string"
},
"timezone": {
"description": "Timezone",
"type": "string"
}
},
"required": [
"link"
],
"type": "object"
},
"name": "facebook_get_group_posts",
"outputSchema": {
"properties": {
"creditsCharged": {
"description": "Credits charged for this call, or null if the endpoint did not report it.",
"type": [
"integer",
"null"
]
},
"creditsRemaining": {
"description": "Credits left on the API key after this call, or null if not reported.",
"type": [
"integer",
"null"
]
},
"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)."
}
},
"required": [
"result"
],
"type": "object"
}
},
{
"description": "Get videos from a Facebook group with pagination. Pricing: 1 credit per call.",
"inputSchema": {
"properties": {
"end_cursor": {
"description": "Pagination cursor",
"type": "string"
},
"link": {
"description": "Facebook group URL",
"type": "string"
}
},
"required": [
"link"
],
"type": "object"
},
"name": "facebook_get_group_videos",
"outputSchema": {
"properties": {
"creditsCharged": {
"description": "Credits charged for this call, or null if the endpoint did not report it.",
"type": [
"integer",
"null"
]
},
"creditsRemaining": {
"description": "Credits left on the API key after this call, or null if not reported.",
"type": [
"integer",
"null"
]
},
"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)."
}
},
"required": [
"result"
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"properties": {
"exact_followers_count": {
"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.",
"type": "boolean"
},
"link": {
"description": "Facebook page URL",
"type": "string"
}
},
"required": [
"link"
],
"type": "object"
},
"name": "facebook_get_page_details",
"outputSchema": {
"properties": {
"creditsCharged": {
"description": "Credits charged for this call, or null if the endpoint did not report it.",
"type": [
"integer",
"null"
]
},
"creditsRemaining": {
"description": "Credits left on the API key after this call, or null if not reported.",
"type": [
"integer",
"null"
]
},
"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)."
}
},
"required": [
"result"
],
"type": "object"
}
},
{
"description": "Get Facebook page ID from a page URL",
"inputSchema": {
"properties": {
"link": {
"description": "Facebook page URL (e.g., https://facebook.com/nike)",
"type": "string"
}
},
"required": [
"link"
],
"type": "object"
},
"name": "facebook_get_page_id",
"outputSchema": {
"properties": {
"creditsCharged": {
"description": "Credits charged for this call, or null if the endpoint did not report it.",
"type": [
"integer",
"null"
]
},
"creditsRemaining": {
"description": "Credits left on the API key after this call, or null if not reported.",
"type": [
"integer",
"null"
]
},
"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)."
}
},
"required": [
"result"
],
"type": "object"
}
},
{
"description": "Get recent posts from a Facebook page with optional pagination and time filtering. Pricing: ceil(posts_returned / 3) credits per call, minimum 1.",
"inputSchema": {
"properties": {
"after_time": {
"description": "ISO 8601 timestamp - only return posts after this time",
"type": "string"
},
"before_time": {
"description": "ISO 8601 timestamp - only return posts before this time",
"type": "string"
},
"end_cursor": {
"description": "Pagination cursor for next page of results",
"type": "string"
},
"limit": {
"description": "Maximum number of posts to return. Default: 3. Minimum: 3. Maximum: 9.",
"maximum": 9,
"minimum": 3,
"type": "number"
},
"link": {
"description": "Facebook page URL",
"type": "string"
},
"timezone": {
"description": "Timezone for timestamps (e.g., UTC, America/New_York)",
"type": "string"
}
},
"required": [
"link"
],
"type": "object"
},
"name": "facebook_get_page_posts",
"outputSchema": {
"properties": {
"creditsCharged": {
"description": "Credits charged for this call, or null if the endpoint did not report it.",
"type": [
"integer",
"null"
]
},
"creditsRemaining": {
"description": "Credits left on the API key after this call, or null if not reported.",
"type": [
"integer",
"null"
]
},
"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)."
}
},
"required": [
"result"
],
"type": "object"
}
},
{
"description": "Get reels/short videos from a Facebook page",
"inputSchema": {
"properties": {
"end_cursor": {
"description": "Pagination cursor",
"type": "string"
},
"link": {
"description": "Facebook page URL",
"type": "string"
}
},
"required": [
"link"
],
"type": "object"
},
"name": "facebook_get_page_reels",
"outputSchema": {
"properties": {
"creditsCharged": {
"description": "Credits charged for this call, or null if the endpoint did not report it.",
"type": [
"integer",
"null"
]
},
"creditsRemaining": {
"description": "Credits left on the API key after this call, or null if not reported.",
"type": [
"integer",
"null"
]
},
"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)."
}
},
"required": [
"result"
],
"type": "object"
}
},
{
"description": "Get videos from a Facebook page with pagination. Pricing: 1 credit per call.",
"inputSchema": {
"properties": {
"end_cursor": {
"description": "Pagination cursor",
"type": "string"
},
"limit": {
"description": "Maximum number of videos to return. Default: 6. Minimum: 6. Maximum: 12.",
"maximum": 12,
"minimum": 6,
"type": "number"
},
"link": {
"description": "Facebook page URL",
"type": "string"
},
"profile_id": {
"description": "Facebook profile ID (alternative to link)",
"type": "string"
}
},
"required": [],
"type": "object"
},
"name": "facebook_get_page_videos",
"outputSchema": {
"properties": {
"creditsCharged": {
"description": "Credits charged for this call, or null if the endpoint did not report it.",
"type": [
"integer",
"null"
]
},
"creditsRemaining": {
"description": "Credits left on the API key after this call, or null if not reported.",
"type": [
"integer",
"null"
]
},
"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)."
}
},
"required": [
"result"
],
"type": "object"
}
},
{
"description": "Get all media attachments (images, videos) from a Facebook post. Pricing: 5 credits per call (deeper scrape than standard post-details).",
"inputSchema": {
"properties": {
"post_id": {
"description": "Facebook post ID",
"type": "string"
}
},
"required": [
"post_id"
],
"type": "object"
},
"name": "facebook_get_post_attachments",
"outputSchema": {
"properties": {
"creditsCharged": {
"description": "Credits charged for this call, or null if the endpoint did not report it.",
"type": [
"integer",
"null"
]
},
"creditsRemaining": {
"description": "Credits left on the API key after this call, or null if not reported.",
"type": [
"integer",
"null"
]
},
"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)."
}
},
"required": [
"result"
],
"type": "object"
}
},
{
"description": "Retrieve top-level comments from a Facebook post or reel with pagination. Pricing: 1 credit per call.",
"inputSchema": {
"properties": {
"end_cursor": {
"description": "Pagination cursor for next page of comments",
"type": "string"
},
"include_reply_info": {
"description": "When \"true\", includes comment_feedback_id and expansion_token for fetching replies",
"type": "string"
},
"limit": {
"description": "Maximum number of comments to return. Default: 10. Maximum: 30.",
"maximum": 30,
"type": "number"
},
"link": {
"description": "Facebook post or reel URL",
"type": "string"
}
},
"required": [
"link"
],
"type": "object"
},
"name": "facebook_get_post_comments",
"outputSchema": {
"properties": {
"creditsCharged": {
"description": "Credits charged for this call, or null if the endpoint did not report it.",
"type": [
"integer",
"null"
]
},
"creditsRemaining": {
"description": "Credits left on the API key after this call, or null if not reported.",
"type": [
"integer",
"null"
]
},
"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)."
}
},
"required": [
"result"
],
"type": "object"
}
},
{
"description": "Get detailed data about a Facebook post including reactions, comments, shares, and media",
"inputSchema": {
"properties": {
"link": {
"description": "Facebook post URL",
"type": "string"
}
},
"required": [
"link"
],
"type": "object"
},
"name": "facebook_get_post_details",
"outputSchema": {
"properties": {
"creditsCharged": {
"description": "Credits charged for this call, or null if the endpoint did not report it.",
"type": [
"integer",
"null"
]
},
"creditsRemaining": {
"description": "Credits left on the API key after this call, or null if not reported.",
"type": [
"integer",
"null"
]
},
"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)."
}
},
"required": [
"result"
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"properties": {
"link": {
"description": "Facebook post URL (works for reels, video posts, and regular posts)",
"type": "string"
}
},
"required": [
"link"
],
"type": "object"
},
"name": "facebook_get_post_details_extended",
"outputSchema": {
"properties": {
"creditsCharged": {
"description": "Credits charged for this call, or null if the endpoint did not report it.",
"type": [
"integer",
"null"
]
},
"creditsRemaining": {
"description": "Credits left on the API key after this call, or null if not reported.",
"type": [
"integer",
"null"
]
},
"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)."
}
},
"required": [
"result"
],
"type": "object"
}
},
{
"description": "Extract Facebook post ID from a post URL",
"inputSchema": {
"properties": {
"link": {
"description": "Facebook post URL",
"type": "string"
}
},
"required": [
"link"
],
"type": "object"
},
"name": "facebook_get_post_id",
"outputSchema": {
"properties": {
"creditsCharged": {
"description": "Credits charged for this call, or null if the endpoint did not report it.",
"type": [
"integer",
"null"
]
},
"creditsRemaining": {
"description": "Credits left on the API key after this call, or null if not reported.",
"type": [
"integer",
"null"
]
},
"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)."
}
},
"required": [
"result"
],
"type": "object"
}
},
{
"description": "Get video metadata, stats, and context for a Facebook video post",
"inputSchema": {
"properties": {
"video_id": {
"description": "Facebook video ID",
"type": "string"
}
},
"required": [
"video_id"
],
"type": "object"
},
"name": "facebook_get_video_details",
"outputSchema": {
"properties": {
"creditsCharged": {
"description": "Credits charged for this call, or null if the endpoint did not report it.",
"type": [
"integer",
"null"
]
},
"creditsRemaining": {
"description": "Credits left on the API key after this call, or null if not reported.",
"type": [
"integer",
"null"
]
},
"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)."
}
},
"required": [
"result"
],
"type": "object"
}
},
{
"description": "Get all Marketplace categories with SEO URLs and category IDs",
"inputSchema": {
"properties": {},
"required": [],
"type": "object"
},
"name": "facebook_marketplace_categories",
"outputSchema": {
"properties": {
"creditsCharged": {
"description": "Credits charged for this call, or null if the endpoint did not report it.",
"type": [
"integer",
"null"
]
},
"creditsRemaining": {
"description": "Credits left on the API key after this call, or null if not reported.",
"type": [
"integer",
"null"
]
},
"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)."
}
},
"required": [
"result"
],
"type": "object"
}
},
{
"description": "Get GPS coordinates for a city to use as Marketplace location filters",
"inputSchema": {
"properties": {
"city": {
"description": "City name",
"type": "string"
},
"country": {
"description": "Country name or code",
"type": "string"
},
"exactly_one": {
"description": "When \"true\", return exactly one result",
"type": "string"
}
},
"required": [
"city"
],
"type": "object"
},
"name": "facebook_marketplace_city_coordinates",
"outputSchema": {
"properties": {
"creditsCharged": {
"description": "Credits charged for this call, or null if the endpoint did not report it.",
"type": [
"integer",
"null"
]
},
"creditsRemaining": {
"description": "Credits left on the API key after this call, or null if not reported.",
"type": [
"integer",
"null"
]
},
"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)."
}
},
"required": [
"result"
],
"type": "object"
}
},
{
"description": "Get detailed info about a single Marketplace listing",
"inputSchema": {
"properties": {
"listing_id": {
"description": "Marketplace Listing ID",
"type": "string"
}
},
"required": [
"listing_id"
],
"type": "object"
},
"name": "facebook_marketplace_listing",
"outputSchema": {
"properties": {
"creditsCharged": {
"description": "Credits charged for this call, or null if the endpoint did not report it.",
"type": [
"integer",
"null"
]
},
"creditsRemaining": {
"description": "Credits left on the API key after this call, or null if not reported.",
"type": [
"integer",
"null"
]
},
"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)."
}
},
"required": [
"result"
],
"type": "object"
}
},
{
"description": "Search Marketplace rental property listings with filters for bedrooms, bathrooms, location, price",
"inputSchema": {
"properties": {
"end_cursor": {
"description": "Pagination cursor",
"type": "string"
},
"filter_bathrooms_max": {
"description": "Max bathrooms",
"type": "string"
},
"filter_bathrooms_min": {
"description": "Min bathrooms",
"type": "string"
},
"filter_bedrooms_max": {
"description": "Max bedrooms",
"type": "string"
},
"filter_bedrooms_min": {
"description": "Min bedrooms",
"type": "string"
},
"filter_location_latitude": {
"description": "GPS latitude",
"type": "string"
},
"filter_location_longitude": {
"description": "GPS longitude",
"type": "string"
},
"filter_price_lower_bound": {
"description": "Minimum price",
"type": "string"
},
"filter_price_upper_bound": {
"description": "Maximum price",
"type": "string"
},
"filter_radius_km": {
"description": "Radius in km",
"type": "string"
},
"sort_by": {
"description": "Sort: CREATION_TIME_DESCEND, PRICE_ASCEND, BEST_MATCH",
"type": "string"
}
},
"required": [],
"type": "object"
},
"name": "facebook_marketplace_rentals",
"outputSchema": {
"properties": {
"creditsCharged": {
"description": "Credits charged for this call, or null if the endpoint did not report it.",
"type": [
"integer",
"null"
]
},
"creditsRemaining": {
"description": "Credits left on the API key after this call, or null if not reported.",
"type": [
"integer",
"null"
]
},
"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)."
}
},
"required": [
"result"
],
"type": "object"
}
},
{
"description": "Search Facebook Marketplace items with filters for location, price, category, condition, and sort order. Pricing: 1 credit per call.",
"inputSchema": {
"properties": {
"category_url": {
"description": "Category URL slug",
"type": "string"
},
"commerce_search_and_rp_condition": {
"description": "Condition: new, used_like_new, used_good, used_fair",
"type": "string"
},
"commerce_search_sort_by": {
"description": "Sort: BEST_MATCH, CREATION_TIME_DESCEND, PRICE_ASCEND, etc.",
"type": "string"
},
"end_cursor": {
"description": "Pagination cursor",
"type": "string"
},
"exact_match": {
"description": "When \"true\", exact match search",
"type": "string"
},
"filter_location_latitude": {
"description": "GPS latitude",
"type": "string"
},
"filter_location_longitude": {
"description": "GPS longitude",
"type": "string"
},
"filter_price_lower_bound": {
"description": "Minimum price",
"type": "string"
},
"filter_price_upper_bound": {
"description": "Maximum price",
"type": "string"
},
"filter_radius_km": {
"description": "Radius in km",
"type": "string"
},
"limit": {
"description": "Maximum number of items to return. Default: 24.",
"type": "number"
},
"posted_today": {
"description": "When \"true\", limit to items posted today",
"type": "string"
},
"query": {
"description": "Search term",
"type": "string"
}
},
"required": [],
"type": "object"
},
"name": "facebook_marketplace_search",
"outputSchema": {
"properties": {
"creditsCharged": {
"description": "Credits charged for this call, or null if the endpoint did not report it.",
"type": [
"integer",
"null"
]
},
"creditsRemaining": {
"description": "Credits left on the API key after this call, or null if not reported.",
"type": [
"integer",
"null"
]
},
"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)."
}
},
"required": [
"result"
],
"type": "object"
}
},
{
"description": "Get seller profile, ratings, reviews, and badges",
"inputSchema": {
"properties": {
"seller_id": {
"description": "Seller ID",
"type": "string"
}
},
"required": [
"seller_id"
],
"type": "object"
},
"name": "facebook_marketplace_seller",
"outputSchema": {
"properties": {
"creditsCharged": {
"description": "Credits charged for this call, or null if the endpoint did not report it.",
"type": [
"integer",
"null"
]
},
"creditsRemaining": {
"description": "Credits left on the API key after this call, or null if not reported.",
"type": [
"integer",
"null"
]
},
"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)."
}
},
"required": [
"result"
],
"type": "object"
}
},
{
"description": "Search Marketplace vehicle listings with filters for location, price, mileage, year",
"inputSchema": {
"properties": {
"end_cursor": {
"description": "Pagination cursor",
"type": "string"
},
"filter_location_latitude": {
"description": "GPS latitude",
"type": "string"
},
"filter_location_longitude": {
"description": "GPS longitude",
"type": "string"
},
"filter_price_lower_bound": {
"description": "Minimum price",
"type": "string"
},
"filter_price_upper_bound": {
"description": "Maximum price",
"type": "string"
},
"filter_radius_km": {
"description": "Radius in km",
"type": "string"
},
"is_c2c_listing_only": {
"description": "Individual sellers only",
"type": "string"
},
"sort_by": {
"description": "Sort: CREATION_TIME_DESCEND, PRICE_ASCEND, VEHICLE_MILEAGE_ASCEND, etc.",
"type": "string"
}
},
"required": [],
"type": "object"
},
"name": "facebook_marketplace_vehicles",
"outputSchema": {
"properties": {
"creditsCharged": {
"description": "Credits charged for this call, or null if the endpoint did not report it.",
"type": [
"integer",
"null"
]
},
"creditsRemaining": {
"description": "Credits left on the API key after this call, or null if not reported.",
"type": [
"integer",
"null"
]
},
"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)."
}
},
"required": [
"result"
],
"type": "object"
}
},
{
"description": "Search for Facebook locations by keyword. Returns UIDs for geo-filtering other search endpoints.",
"inputSchema": {
"properties": {
"query": {
"description": "Search query (city, place, landmark)",
"type": "string"
}
},
"required": [
"query"
],
"type": "object"
},
"name": "facebook_search_locations",
"outputSchema": {
"properties": {
"creditsCharged": {
"description": "Credits charged for this call, or null if the endpoint did not report it.",
"type": [
"integer",
"null"
]
},
"creditsRemaining": {
"description": "Credits left on the API key after this call, or null if not reported.",
"type": [
"integer",
"null"
]
},
"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)."
}
},
"required": [
"result"
],
"type": "object"
}
},
{
"description": "Search for Facebook pages by keyword with optional location filtering",
"inputSchema": {
"properties": {
"end_cursor": {
"description": "Pagination cursor",
"type": "string"
},
"location_uid": {
"description": "Location UID for filtering (from search/locations endpoint)",
"type": "string"
},
"query": {
"description": "Search query",
"type": "string"
}
},
"required": [
"query"
],
"type": "object"
},
"name": "facebook_search_pages",
"outputSchema": {
"properties": {
"creditsCharged": {
"description": "Credits charged for this call, or null if the endpoint did not report it.",
"type": [
"integer",
"null"
]
},
"creditsRemaining": {
"description": "Credits left on the API key after this call, or null if not reported.",
"type": [
"integer",
"null"
]
},
"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)."
}
},
"required": [
"result"
],
"type": "object"
}
},
{
"description": "Search for Facebook people/profiles by keyword with optional location filtering",
"inputSchema": {
"properties": {
"end_cursor": {
"description": "Pagination cursor",
"type": "string"
},
"location_uid": {
"description": "Location UID for filtering",
"type": "string"
},
"query": {
"description": "Search query",
"type": "string"
}
},
"required": [
"query"
],
"type": "object"
},
"name": "facebook_search_people",
"outputSchema": {
"properties": {
"creditsCharged": {
"description": "Credits charged for this call, or null if the endpoint did not report it.",
"type": [
"integer",
"null"
]
},
"creditsRemaining": {
"description": "Credits left on the API key after this call, or null if not reported.",
"type": [
"integer",
"null"
]
},
"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)."
}
},
"required": [
"result"
],
"type": "object"
}
},
{
"description": "Search for Facebook posts by keyword with optional location and time filters",
"inputSchema": {
"properties": {
"end_cursor": {
"description": "Pagination cursor",
"type": "string"
},
"end_time": {
"description": "Filter posts before this date (YYYY-MM-DD)",
"type": "string"
},
"location_uid": {
"description": "Location UID for filtering",
"type": "string"
},
"query": {
"description": "Search query",
"type": "string"
},
"recent_posts": {
"description": "When \"true\", shows only recent posts",
"type": "string"
},
"start_time": {
"description": "Filter posts after this date (YYYY-MM-DD)",
"type": "string"
}
},
"required": [
"query"
],
"type": "object"
},
"name": "facebook_search_posts",
"outputSchema": {
"properties": {
"creditsCharged": {
"description": "Credits charged for this call, or null if the endpoint did not report it.",
"type": [
"integer",
"null"
]
},
"creditsRemaining": {
"description": "Credits left on the API key after this call, or null if not reported.",
"type": [
"integer",
"null"
]
},
"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)."
}
},
"required": [
"result"
],
"type": "object"
}
},
{
"description": "Search for Facebook videos by keyword with optional recency and live filters",
"inputSchema": {
"properties": {
"end_cursor": {
"description": "Pagination cursor",
"type": "string"
},
"fields": {
"description": "Comma-separated list of response fields to include",
"type": "string"
},
"most_recent": {
"description": "When \"true\", shows most recent videos first",
"type": "string"
},
"query": {
"description": "Search query",
"type": "string"
},
"videos_live": {
"description": "When \"true\", filters for live videos only",
"type": "string"
}
},
"required": [
"query"
],
"type": "object"
},
"name": "facebook_search_videos",
"outputSchema": {
"properties": {
"creditsCharged": {
"description": "Credits charged for this call, or null if the endpoint did not report it.",
"type": [
"integer",
"null"
]
},
"creditsRemaining": {
"description": "Credits left on the API key after this call, or null if not reported.",
"type": [
"integer",
"null"
]
},
"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)."
}
},
"required": [
"result"
],
"type": "object"
}
},
{
"description": "Get details of a specific highlight by ID including all stories within the highlight",
"inputSchema": {
"properties": {
"highlight_id": {
"description": "Highlight ID (from profile highlights endpoint)",
"type": "string"
}
},
"required": [
"highlight_id"
],
"type": "object"
},
"name": "instagram_get_highlight_details",
"outputSchema": {
"properties": {
"creditsCharged": {
"description": "Credits charged for this call, or null if the endpoint did not report it.",
"type": [
"integer",
"null"
]
},
"creditsRemaining": {
"description": "Credits left on the API key after this call, or null if not reported.",
"type": [
"integer",
"null"
]
},
"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)."
}
},
"required": [
"result"
],
"type": "object"
}
},
{
"description": "Get Instagram posts from a specific location. Retrieve top/ranked or most recent posts tagged at a place.",
"inputSchema": {
"properties": {
"end_cursor": {
"description": "Pagination cursor for next page",
"type": "string"
},
"location_id": {
"description": "Instagram location ID",
"type": "string"
},
"tab": {
"description": "Filter: \"recent\" or \"ranked\"",
"type": "string"
}
},
"required": [
"location_id"
],
"type": "object"
},
"name": "instagram_get_location_posts",
"outputSchema": {
"properties": {
"creditsCharged": {
"description": "Credits charged for this call, or null if the endpoint did not report it.",
"type": [
"integer",
"null"
]
},
"creditsRemaining": {
"description": "Credits left on the API key after this call, or null if not reported.",
"type": [
"integer",
"null"
]
},
"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)."
}
},
"required": [
"result"
],
"type": "object"
}
},
{
"description": "Get nearby places/locations for a specific Instagram location including name, category, coordinates, and post count",
"inputSchema": {
"properties": {
"location_id": {
"description": "Instagram location ID",
"type": "string"
}
},
"required": [
"location_id"
],
"type": "object"
},
"name": "instagram_get_nearby_locations",
"outputSchema": {
"properties": {
"creditsCharged": {
"description": "Credits charged for this call, or null if the endpoint did not report it.",
"type": [
"integer",
"null"
]
},
"creditsRemaining": {
"description": "Credits left on the API key after this call, or null if not reported.",
"type": [
"integer",
"null"
]
},
"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)."
}
},
"required": [
"result"
],
"type": "object"
}
},
{
"description": "Get full details of a specific Instagram post including media, engagement, caption, and owner info",
"inputSchema": {
"properties": {
"shortcode": {
"description": "Instagram post shortcode (e.g., DMF-GjGO0-q)",
"type": "string"
}
},
"required": [
"shortcode"
],
"type": "object"
},
"name": "instagram_get_post_details",
"outputSchema": {
"properties": {
"creditsCharged": {
"description": "Credits charged for this call, or null if the endpoint did not report it.",
"type": [
"integer",
"null"
]
},
"creditsRemaining": {
"description": "Credits left on the API key after this call, or null if not reported.",
"type": [
"integer",
"null"
]
},
"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)."
}
},
"required": [
"result"
],
"type": "object"
}
},
{
"description": "Extract the post shortcode/ID from any Instagram post URL",
"inputSchema": {
"properties": {
"link": {
"description": "Instagram post URL",
"type": "string"
}
},
"required": [
"link"
],
"type": "object"
},
"name": "instagram_get_post_id",
"outputSchema": {
"properties": {
"creditsCharged": {
"description": "Credits charged for this call, or null if the endpoint did not report it.",
"type": [
"integer",
"null"
]
},
"creditsRemaining": {
"description": "Credits left on the API key after this call, or null if not reported.",
"type": [
"integer",
"null"
]
},
"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)."
}
},
"required": [
"result"
],
"type": "object"
}
},
{
"description": "Get user profile information by username including bio, followers, posts count, verification, and related profiles",
"inputSchema": {
"properties": {
"link": {
"description": "Instagram profile URL (alternative to username)",
"type": "string"
},
"username": {
"description": "Instagram username",
"type": "string"
}
},
"required": [
"username"
],
"type": "object"
},
"name": "instagram_get_profile_details",
"outputSchema": {
"properties": {
"creditsCharged": {
"description": "Credits charged for this call, or null if the endpoint did not report it.",
"type": [
"integer",
"null"
]
},
"creditsRemaining": {
"description": "Credits left on the API key after this call, or null if not reported.",
"type": [
"integer",
"null"
]
},
"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)."
}
},
"required": [
"result"
],
"type": "object"
}
},
{
"description": "Get all highlights from a user profile including cover images, titles, and permalink URLs",
"inputSchema": {
"properties": {
"user_id": {
"description": "Instagram user ID",
"type": "string"
}
},
"required": [
"user_id"
],
"type": "object"
},
"name": "instagram_get_profile_highlights",
"outputSchema": {
"properties": {
"creditsCharged": {
"description": "Credits charged for this call, or null if the endpoint did not report it.",
"type": [
"integer",
"null"
]
},
"creditsRemaining": {
"description": "Credits left on the API key after this call, or null if not reported.",
"type": [
"integer",
"null"
]
},
"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)."
}
},
"required": [
"result"
],
"type": "object"
}
},
{
"description": "Get posts from a user profile with pagination. Provide username (recommended for more results) or user_id.",
"inputSchema": {
"properties": {
"end_cursor": {
"description": "Pagination cursor for next page",
"type": "string"
},
"user_id": {
"description": "Instagram user ID (alternative)",
"type": "string"
},
"username": {
"description": "Instagram username (recommended — returns more results)",
"type": "string"
}
},
"required": [],
"type": "object"
},
"name": "instagram_get_profile_posts",
"outputSchema": {
"properties": {
"creditsCharged": {
"description": "Credits charged for this call, or null if the endpoint did not report it.",
"type": [
"integer",
"null"
]
},
"creditsRemaining": {
"description": "Credits left on the API key after this call, or null if not reported.",
"type": [
"integer",
"null"
]
},
"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)."
}
},
"required": [
"result"
],
"type": "object"
}
},
{
"description": "Get reels from a user profile with pagination. Returns video details, play counts, and audio metadata.",
"inputSchema": {
"properties": {
"end_cursor": {
"description": "Pagination cursor for next page",
"type": "string"
},
"user_id": {
"description": "Instagram user ID",
"type": "string"
}
},
"required": [
"user_id"
],
"type": "object"
},
"name": "instagram_get_profile_reels",
"outputSchema": {
"properties": {
"creditsCharged": {
"description": "Credits charged for this call, or null if the endpoint did not report it.",
"type": [
"integer",
"null"
]
},
"creditsRemaining": {
"description": "Credits left on the API key after this call, or null if not reported.",
"type": [
"integer",
"null"
]
},
"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)."
}
},
"required": [
"result"
],
"type": "object"
}
},
{
"description": "Get Instagram Reels associated with a specific audio/music ID. Find all reels using a particular sound.",
"inputSchema": {
"properties": {
"audio_id": {
"description": "Audio cluster ID (music ID)",
"type": "string"
},
"max_id": {
"description": "Pagination cursor for next page",
"type": "string"
}
},
"required": [
"audio_id"
],
"type": "object"
},
"name": "instagram_get_reels_by_audio",
"outputSchema": {
"properties": {
"creditsCharged": {
"description": "Credits charged for this call, or null if the endpoint did not report it.",
"type": [
"integer",
"null"
]
},
"creditsRemaining": {
"description": "Credits left on the API key after this call, or null if not reported.",
"type": [
"integer",
"null"
]
},
"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)."
}
},
"required": [
"result"
],
"type": "object"
}
},
{
"description": "Get Instagram Reels feed with recommended, trending, or same-author chained clips",
"inputSchema": {
"properties": {
"clips_media_id": {
"description": "Clip media ID for chaining/pagination (from previous response)",
"type": "string"
}
},
"required": [],
"type": "object"
},
"name": "instagram_get_reels_feed",
"outputSchema": {
"properties": {
"creditsCharged": {
"description": "Credits charged for this call, or null if the endpoint did not report it.",
"type": [
"integer",
"null"
]
},
"creditsRemaining": {
"description": "Credits left on the API key after this call, or null if not reported.",
"type": [
"integer",
"null"
]
},
"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)."
}
},
"required": [
"result"
],
"type": "object"
}
},
{
"description": "Get the unique ID of any Instagram profile from a link or username",
"inputSchema": {
"properties": {
"link": {
"description": "Instagram profile URL",
"type": "string"
},
"username": {
"description": "Instagram username",
"type": "string"
}
},
"required": [],
"type": "object"
},
"name": "instagram_get_user_id",
"outputSchema": {
"properties": {
"creditsCharged": {
"description": "Credits charged for this call, or null if the endpoint did not report it.",
"type": [
"integer",
"null"
]
},
"creditsRemaining": {
"description": "Credits left on the API key after this call, or null if not reported.",
"type": [
"integer",
"null"
]
},
"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)."
}
},
"required": [
"result"
],
"type": "object"
}
},
{
"description": "Search Instagram by keyword and get popular results including users, hashtags, and places",
"inputSchema": {
"properties": {
"end_cursor": {
"description": "Pagination cursor for next page",
"type": "string"
},
"keyword": {
"description": "Search keyword/query",
"type": "string"
}
},
"required": [
"keyword"
],
"type": "object"
},
"name": "instagram_popular_search",
"outputSchema": {
"properties": {
"creditsCharged": {
"description": "Credits charged for this call, or null if the endpoint did not report it.",
"type": [
"integer",
"null"
]
},
"creditsRemaining": {
"description": "Credits left on the API key after this call, or null if not reported.",
"type": [
"integer",
"null"
]
},
"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)."
}
},
"required": [
"result"
],
"type": "object"
}
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:4552a7671fcfee119bba6aafa0dba6c1cddd1e2baab08220ce77246cf12ea5bb | sha256sum